Esquemas en todas partes: Entendiendo GraphQL, Bases de Datos y Prisma

Rate this content
Bookmark

En un mundo dirigido por datos, nosotros como desarrolladores hemos recurrido a esquemas para ayudar a describir y organizar esos datos. Pero ¿qué sucede cuando tienes un montón de esquemas para hacer un seguimiento? En esta charla aprenderás el papel de todos los diferentes esquemas en una API de GraphQL.

9 min
08 Dec, 2022

Video Summary and Transcription

¡Bienvenido a la charla! Como desarrolladores, gestionamos y comprendemos los datos con los que el mundo funciona. Cada esquema individual en tu infraestructura define tus datos en el contexto de su propio dominio. El esquema de Prisma se utiliza para generar migraciones y crear una asignación entre la base de datos y la API, permitiendo interacciones seguras en cuanto a tipos. El esquema de GraphQL permite a los clientes consultar de forma segura la base de datos a través de la API. Al utilizar Prisma y GraphQL Code Generator, puedes lograr un entorno de extremo a extremo seguro en cuanto a tipos.

Available in English

1. Introducción a la Gestión y Modelado de Datos

Short description:

¡Bienvenidos a la charla! Como desarrolladores, gestionamos y entendemos los datos en los que se basa el mundo. El modelado de datos puede ser desafiante, especialmente cuando se trata de datos de diversas fuentes. Los esquemas proporcionan una forma de representar modelos de datos, pero la proliferación de esquemas ha planteado la pregunta de la fuente de verdad.

Bienvenidos a todos. Muchas gracias por unirse a mí en esta charla. Estoy muy emocionado de darla en un formato de charla relámpago. Anteriormente, he dado la misma charla en un formato más extenso y la he condensado en las partes necesarias. Así que estoy deseando ver cómo va a ir esto. Si tienen alguna pregunta sobre la charla después de que la haya dado, no duden en enviarme un mensaje en Twitter y estaré encantado de responder cualquier pregunta que puedan tener. Pero antes de adentrarnos en el meollo de esta charla, hablemos del concepto más amplio de que el mundo mismo se basa en data, ya sea tu teléfono celular, ya sea que estés usando Facebook, o tal vez tu refrigerador o cualquier cosa que esté conectada a internet, todo funciona con data y como desarrolladores, en realidad es nuestro trabajo gestionarlo. Así que es una gran responsabilidad que recae sobre nuestros hombros, pero eso es a lo que nos comprometimos cuando nos convertimos en desarrolladores, gestionar estos data, hacer algo con ellos y proporcionarlos en un formato que otros programas puedan utilizar. Así que la conclusión de todo esto es que para gestionar un conjunto de data, debes tener algún tipo de conocimiento sobre su estructura y su propósito. Debes saber por qué estás tratando con tus data y por qué estás haciendo lo que estás haciendo en el código de tu aplicación con tus data. Así que para revisar esta declaración original, no solo es nuestro trabajo gestionar estos data en los que se basa el mundo, sino que también es nuestro trabajo entenderlos al menos en cierta medida. Y esto es difícil porque en general,data es difícil de modelar. Como personas técnicas, tenemos muchas cosas en marcha. Estamos haciendo muchas cosas técnicas. Estamos desarrollando aplicaciones. Tenemos mucho conocimiento que mantener en nuestras mentes. No hay mucho espacio para entender todo el dominio de data de cualquier industria en la que estemos trabajando en ese momento. Así que hay un par de razones más por las que tu data es difícil de modelar, a medida que tu data fluye a través de diferentes áreas de tu aplicación, debes saber cómo interactuar con este data. Por lo tanto, debe ser modelado de una manera que funcione con diferentes partes de tu aplicación. Tu modelo de data puede cambiar a medida que tu aplicación evoluciona. A medida que surgen nuevos requisitos en tu industria, es posible que debas evolucionar tu modelo un poco y hacerlo de una manera segura para tu aplicación puede ser difícil a veces. Otro motivo, y este es importante, es que tu data puede no haber sido modelada por ti. Y también revisaría esto para decir que tu data probablemente no fue modelada por ti. Probablemente estés consumiendo data de otra persona y lo estés utilizando en tu propia aplicación.

Por todas estas razones, nosotros como desarrolladores ideamos esta idea de esquemas, que es una forma de representar clara y concisamente tu modelo de data. Pero aún hay un problema, incluso con los esquemas. Los esquemas están en todas partes, por lo que hemos resuelto el problema de poder modelar nuestros data de una manera que tenga sentido. Pero ahora que hemos encontrado una buena solución, la estamos utilizando en todas partes y el propósito original del esquema se ha perdido. Entonces, lo que se supone que debe ser el esquema es una fuente de verdad de cómo se ve tu data. Pero a medida que comienzas a agregar diferentes esquemas en todas partes, surge la pregunta, ¿ahora cuál es la fuente de verdad? Esto provoca el problema de que ahora tienes múltiples fuentes percibidas de verdad, y cada esquema puede describir tu data de manera un poco diferente, lo que probablemente plantea la pregunta, ¿cuál es la fuente de verdad? Y además, cada esquema tiene un diferente

2. Gestión de Datos y Definición de Esquemas

Short description:

Cada esquema individual en tu infraestructura define tus datos en el contexto de su propio dominio. Analizaremos el esquema de la base de datos, que está escrito en un lenguaje de descripción de datos. Prisma tiene su propio lenguaje, el lenguaje de esquema de Prisma, que permite un modelado más fácil del esquema de la base de datos. El esquema de GraphQL es diferente al esquema de la base de datos, ya que define lo que expone la API, no los propios datos.

rol. Y si los data, si los esquemas se ven similares, es difícil determinar cuál es el rol de cada esquema individual. Entonces, en resumen, cada esquema individual en tu infraestructura define tus data en el contexto de su propio dominio. Ya sea tu base de datos, tu API o cualquier otra cosa, el esquema describe los data para esa parte individual de tu aplicación. Vamos a analizar una pila que tiene una base de datos, una API de GraphQL y también Prisma. De esta manera, podemos ver los esquemas individuales y cómo se relacionan. Para empezar, vamos a ver el esquema de la base de datos, que se muestra a la derecha es el código que necesitarías escribir para crear un esquema básico de la base de datos. Esto está escrito en DDL o un lenguaje de descripción de datos. Y típicamente es un lenguaje específico de la base de datos. Es un poco complicado. Estos lenguajes tienden a ser un poco más difíciles de aprender que algo como, um, algo como JavaScript o algo más fácil de ver a simple vista. Y por esta razón, en Prisma creamos nuestro propio lenguaje llamado lenguaje de esquema de Prisma. Y esto te permite modelar tu esquema de base de datos dentro de un archivo de esquema de Prisma. La única diferencia es que está escrito en este lenguaje que se parece más a GraphQL. Es un poco más fácil de leer. Esto es importante porque ahora, cuando nuevos desarrolladores ingresen a tu aplicación, o tal vez alguien no técnico, pueden ver este modelo y entender lo que está sucediendo. Esto también es importante porque es lo suficientemente simple como para que podamos usarlo dentro de Prisma para generar un cliente de Prisma seguro en cuanto a tipos que interactúa con tu base de datos y garantiza que los data a los que accedes estén realmente disponibles. Y finalmente tenemos el esquema de GraphQL aquí. Esto se parece al esquema de Prisma. Sin embargo, hay una gran diferencia. Aquí es donde mucha gente se confunde con los esquemas. El esquema de GraphQL tiende a parecerse mucho al esquema de tu base de datos porque expone los data de tu base de datos. Pero el problema aquí es que probablemente no debería verse exactamente como el esquema de tu base de datos. Esto no está definiendo tus data aquí. Esto está definiendo lo que expone tu API. Por ejemplo, para ampliar esto, es posible que estés exponiendo data de tu API de GraphQL que ni siquiera está en tu base de datos. O es posible que no estés exponiendo ciertos campos de tu base de datos por razones de seguridad. Y debido a estas cosas, tu esquema de GraphQL es algo completamente separado de tu esquema de base de datos. Puede parecer un poco como duplicación de código mientras los estás escribiendo. Pero si entiendes esta diferencia entre los dos esquemas diferentes aquí, comienza a tener un poco más de sentido. Así que, para resumir, tenemos nuestro esquema de base de datos

3. Mapeo de Esquemas de Prisma y GraphQL

Short description:

El esquema de Prisma se utiliza para generar migraciones y crear un mapeo entre la base de datos y la API, permitiendo interacciones seguras en cuanto a tipos. El esquema de GraphQL permite a los clientes consultar de forma segura la base de datos a través de la API. Al completar los vacíos con herramientas como Prisma y GraphQL Code Generator, se pueden generar tipos para el frontend basados en el esquema de GraphQL. Cuando se utilizan correctamente todos los esquemas y herramientas, se logra un entorno seguro en cuanto a tipos de extremo a extremo. Gracias por acompañarme hoy para discutir las diferencias entre los esquemas. Si tienes alguna pregunta adicional, no dudes en contactarme en Twitter.

El esquema de Prisma es el esquema que se ejecuta en tu servidor de base de datos y define la estructura de tus datos. Tienes el esquema de Prisma que se encuentra en tu API y en el código de tu API. Y esto es lo que se utiliza para generar las migraciones para actualizar el esquema de tu base de datos. Y también es lo que se utiliza para crear ese mapeo y completar el vacío entre la base de datos y la API, de modo que puedas tener interacciones seguras en cuanto a tipos entre ambas. Y finalmente, tienes el esquema de GraphQL que es lo que el cliente utiliza para consultar de forma segura tu base de datos a través de tu API. Pero hay otro vacío allí. Así que, aquí en esta diapositiva tengo los vacíos, y si los completamos, lo que obtenemos es Prisma en medio de la base de datos y la API, como mencioné, y también obtienes algo como GraphQL Code Generator, o tal vez otra herramienta similar que hace algo parecido. Y lo que esto hace es generar tipos para tu cliente de frontend basados en tu esquema de GraphQL. Así que, cuando tienes todas estas piezas en su lugar, todos estos esquemas utilizados correctamente, con estas herramientas agradables en medio de ellos, obtienes una situación y un entorno agradable y seguro en cuanto a tipos, donde tus tipos, incluso desde tu cliente, se basan en tus tipos de base de datos. Así que, muchas gracias por acompañarme hoy para hablar sobre las diferencias entre todos los diferentes esquemas con los que podrías trabajar en tu aplicación. Espero que haya aclarado algunas de esas pequeñas cosas sobre los diferentes esquemas que a menudo confunden a las personas. Si aún tienes alguna pregunta, no dudes en enviarme un mensaje en Twitter al respecto, estaré encantado de responder. Así que, gracias nuevamente y espero que tengas un buen resto de tu conferencia.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

GraphQL Galaxy 2021GraphQL Galaxy 2021
32 min
From GraphQL Zero to GraphQL Hero with RedwoodJS
Top Content
We all love GraphQL, but it can be daunting to get a server up and running and keep your code organized, maintainable, and testable over the long term. No more! Come watch as I go from an empty directory to a fully fledged GraphQL API in minutes flat. Plus, see how easy it is to use and create directives to clean up your code even more. You're gonna love GraphQL even more once you make things Redwood Easy!
Vue.js London Live 2021Vue.js London Live 2021
24 min
Local State and Server Cache: Finding a Balance
Top Content
How many times did you implement the same flow in your application: check, if data is already fetched from the server, if yes - render the data, if not - fetch this data and then render it? I think I've done it more than ten times myself and I've seen the question about this flow more than fifty times. Unfortunately, our go-to state management library, Vuex, doesn't provide any solution for this.For GraphQL-based application, there was an alternative to use Apollo client that provided tools for working with the cache. But what if you use REST? Luckily, now we have a Vue alternative to a react-query library that provides a nice solution for working with server cache. In this talk, I will explain the distinction between local application state and local server cache and do some live coding to show how to work with the latter.
GraphQL Galaxy 2022GraphQL Galaxy 2022
16 min
Step aside resolvers: a new approach to GraphQL execution
Though GraphQL is declarative, resolvers operate field-by-field, layer-by-layer, often resulting in unnecessary work for your business logic even when using techniques such as DataLoader. In this talk, Benjie will introduce his vision for a new general-purpose GraphQL execution strategy whose holistic approach could lead to significant efficiency and scalability gains for all GraphQL APIs.

Workshops on related topic

GraphQL Galaxy 2021GraphQL Galaxy 2021
140 min
Build with SvelteKit and GraphQL
Top Content
Featured WorkshopFree
Have you ever thought about building something that doesn't require a lot of boilerplate with a tiny bundle size? In this workshop, Scott Spence will go from hello world to covering routing and using endpoints in SvelteKit. You'll set up a backend GraphQL API then use GraphQL queries with SvelteKit to display the GraphQL API data. You'll build a fast secure project that uses SvelteKit's features, then deploy it as a fully static site. This course is for the Svelte curious who haven't had extensive experience with SvelteKit and want a deeper understanding of how to use it in practical applications.

Table of contents:
- Kick-off and Svelte introduction
- Initialise frontend project
- Tour of the SvelteKit skeleton project
- Configure backend project
- Query Data with GraphQL
- Fetching data to the frontend with GraphQL
- Styling
- Svelte directives
- Routing in SvelteKit
- Endpoints in SvelteKit
- Deploying to Netlify
- Navigation
- Mutations in GraphCMS
- Sending GraphQL Mutations via SvelteKit
- Q&A
React Advanced Conference 2022React Advanced Conference 2022
95 min
End-To-End Type Safety with React, GraphQL & Prisma
Featured WorkshopFree
In this workshop, you will get a first-hand look at what end-to-end type safety is and why it is important. To accomplish this, you’ll be building a GraphQL API using modern, relevant tools which will be consumed by a React client.
Prerequisites: - Node.js installed on your machine (12.2.X / 14.X)- It is recommended (but not required) to use VS Code for the practical tasks- An IDE installed (VSCode recommended)- (Good to have)*A basic understanding of Node.js, React, and TypeScript
GraphQL Galaxy 2022GraphQL Galaxy 2022
112 min
GraphQL for React Developers
Featured Workshop
There are many advantages to using GraphQL as a datasource for frontend development, compared to REST APIs. We developers in example need to write a lot of imperative code to retrieve data to display in our applications and handle state. With GraphQL you cannot only decrease the amount of code needed around data fetching and state-management you'll also get increased flexibility, better performance and most of all an improved developer experience. In this workshop you'll learn how GraphQL can improve your work as a frontend developer and how to handle GraphQL in your frontend React application.
React Summit 2022React Summit 2022
173 min
Build a Headless WordPress App with Next.js and WPGraphQL
Top Content
WorkshopFree
In this workshop, you’ll learn how to build a Next.js app that uses Apollo Client to fetch data from a headless WordPress backend and use it to render the pages of your app. You’ll learn when you should consider a headless WordPress architecture, how to turn a WordPress backend into a GraphQL server, how to compose queries using the GraphiQL IDE, how to colocate GraphQL fragments with your components, and more.
GraphQL Galaxy 2020GraphQL Galaxy 2020
106 min
Relational Database Modeling for GraphQL
Top Content
WorkshopFree
In this workshop we'll dig deeper into data modeling. We'll start with a discussion about various database types and how they map to GraphQL. Once that groundwork is laid out, the focus will shift to specific types of databases and how to build data models that work best for GraphQL within various scenarios.
Table of contentsPart 1 - Hour 1      a. Relational Database Data Modeling      b. Comparing Relational and NoSQL Databases      c. GraphQL with the Database in mindPart 2 - Hour 2      a. Designing Relational Data Models      b. Relationship, Building MultijoinsTables      c. GraphQL & Relational Data Modeling Query Complexities
Prerequisites      a. Data modeling tool. The trainer will be using dbdiagram      b. Postgres, albeit no need to install this locally, as I'll be using a Postgres Dicker image, from Docker Hub for all examples      c. Hasura
GraphQL Galaxy 2021GraphQL Galaxy 2021
48 min
Building GraphQL APIs on top of Ethereum with The Graph
WorkshopFree
The Graph is an indexing protocol for querying networks like Ethereum, IPFS, and other blockchains. Anyone can build and publish open APIs, called subgraphs, making data easily accessible.

In this workshop you’ll learn how to build a subgraph that indexes NFT blockchain data from the Foundation smart contract. We’ll deploy the API, and learn how to perform queries to retrieve data using various types of data access patterns, implementing filters and sorting.

By the end of the workshop, you should understand how to build and deploy performant APIs to The Graph to index data from any smart contract deployed to Ethereum.