Utilizando Remote Joins para crear una API GraphQL unificada para tu empresa

Rate this content
Bookmark

Con Hasura Remote Joins, puedes unir los datos de tu tabla con una API de Stripe o una API de Github o cualquier API de GraphQL. Sin escribir una sola línea de código. Utilizando el increíble sistema de tipos de GraphQL combinado con la configuración declarativa de Hasura, puedes crear relaciones entre tablas y otros servicios y obtener una API unificada hermosa. En una sola llamada, obtén todos los datos necesarios para construir tus aplicaciones desde cualquier parte del mundo.

9 min
18 Jun, 2021

Video Summary and Transcription

La función de joins remotos de Hasura te permite combinar múltiples fuentes de datos en una API GraphQL unificada, incluyendo bases de datos Postgres, APIs de GraphQL y APIs REST. Permite unir datos entre diferentes bases de datos e integrarse con APIs externas como Stripe y Auth0. Hasura realiza consultas SQL para unir datos entre bases de datos e incluso puede integrarse con APIs REST utilizando acciones. Con joins remotos, puedes consultar y obtener datos de múltiples fuentes, enriqueciendo tu esquema GraphQL y creando relaciones de datos poderosas.

Available in English

1. Introducción a las uniones remotas en Hasura

Short description:

Soy Tanmay y voy a hablarles un poco sobre una nueva función en la que hemos estado trabajando, que son las uniones remotas, que les permite combinar múltiples fuentes de datos en una API unificada de GraphQL. Hasura es un motor de GraphQL de código abierto que se conecta a su base de datos de Postgres, pero también a otras fuentes como una fuente de GraphQL y una fuente de REST, y le permite combinarlas y ahora incluso unirse entre ellas. Hasura se ejecuta como un contenedor de Docker en su propia infraestructura.

Hola a todos. Estoy muy contento de estar aquí. Soy Tanmay y voy a hablarles un poco sobre una nueva función en la que hemos estado trabajando, que son las uniones remotas que les permite combinar múltiples fuentes de datos en una API unificada de GraphQL. Esto es algo que hemos estado haciendo en Hasura. Hasura es un motor de GraphQL de código abierto que se conecta a su base de datos de Postgres, pero también a otras fuentes como una fuente de GraphQL y una fuente de REST y le permite combinarlas y ahora incluso unirse entre ellas. Hasura se ejecuta como un contenedor de Docker en su propia infraestructura. Échale un vistazo en Github, pruébalo. Déjame saber qué piensas.

2. Remote Joins and Integrating APIs

Short description:

Puedes combinar datos de una base de datos Postgres y una API de GraphQL, como Stripe, utilizando uniones remotas en Hasura. Al integrar otra API de GraphQL, como Auth0, puedes obtener detalles adicionales para cada usuario. Agregar el esquema remoto y crear una relación te permite consultar y obtener datos de Auth0. De manera similar, puedes unir datos de diferentes bases de datos, como la base de datos de música en Hasura Remote Postgres.

Lo que voy a explicarles es cómo hacer algo como esto, que es tener datos dentro de una base de datos Postgres y tener una API de GraphQL, como Stripe con OneGraph, y lo que quieres hacer es hacer una consulta de GraphQL que obtenga los datos del cliente de la base de datos y tal vez los datos de Stripe de la API de Stripe como ejemplo.

Veamos cómo se ve esto. Aquí tengo Hasura en ejecución y esto tiene solo dos tablas, que son usuarios y eventos, y lo que Hasura me proporciona es una API de GraphQL en esas tablas. Así que puedo ver los usuarios y los usuarios tienen ID y correo electrónico y luego puedo hacer esta consulta de GraphQL. También puedo hacer autorización y otras cosas para asegurarme de que esta API de GraphQL sea segura.

Lo que haré ahora es integrar otra API de GraphQL y luego unirme a través de ella. Entonces, cada usuario en mi sistema tiene, por ejemplo, una sesión iniciada con Auth0. Y así van a tener algunos detalles de Auth0 como último inicio de sesión o detalles de perfil y cosas que provienen del servicio de Auth0. Tengo una API de GraphQL que envuelve el servicio de Auth0. Y lo que haré es agregar esto como un esquema remoto en Hasura. Llamémoslo Auth0 y llamémoslo Auth0. Y lo que haré es agregar esto como una URL aquí. Y luego lo que puedo hacer es ir a mi tabla de usuarios y crear una relación entre mi tabla y este esquema de GraphQL que he agregado. Llamémoslo perfil de Auth0 y luego digamos Auth0 y elijamos decir que queremos usar el correo electrónico como condición de unión, ¿verdad? Porque el valor del correo electrónico es el mismo. Digamos que no tengo el ID. Estoy usando el correo electrónico. También podría haber usado el ID, si los IDs fueran los mismos. Tan pronto como haga eso, verás que nuestro esquema de GraphQL se ampliará y podré hacer una consulta para obtener detalles de Auth0. Así que esa es una consulta donde ahora estoy obteniendo estos datos también de Auth0. Estos datos provienen de Auth0. Estos datos provienen de nuestra base de datos. Tomemos otro ejemplo donde puedo unir datos de dos bases de datos. Así que tengo otro servicio de Hasura y este es un servicio diferente de Hasura. Lo he llamado Hasura Remote Postgres, que tiene una base de datos de música. Hay artistas, álbumes, pistas de música, cosas así. Es una aplicación de demostración estándar que uso. Voy a tomar este punto final de GraphQL y agregarlo a mi esquema principal de GraphQL aquí. Llamémoslo pgremote. Y tan pronto como agregue esto aquí, vayamos y agreguemos también una relación. Así que cada usuario también es un artista.

3. Joining Data and Integrating REST API

Short description:

Vamos a vincular el campo de artista a pgremote utilizando la columna ID como condición de unión. Ahora podemos solicitar artistas y ver sus IDs, nombres y álbumes. Hasura empuja el SQL para unir datos entre bases de datos. Otro ejemplo es unirse a una API REST utilizando acciones. Especificamos la especificación de GraphQL para mapear el punto final REST, que devuelve información adicional del usuario. El contrato incluye el ID del usuario, el estado de verificación y la dirección. El punto final de la API REST se está ejecutando en una aplicación de Heroku.

Entonces, vamos y decimos artista y lo vinculamos a pgremote, y veremos un campo de artista. Y esta vez usaremos la columna ID como condición de unión, ¿verdad? En lugar del correo electrónico, en lugar de la columna de correo electrónico.

Así que tan pronto como haga esto, lo que puedo hacer ahora es comenzar a hacer una solicitud de artistas también. Bueno, ahí vamos, ahora podemos ver artistas. Y puedo decir artista y ID del artista y, ya sabes, el artista tiene un nombre y tal vez el artista también tiene álbumes. Genial. Entonces el artista tiene un álbum.

Correcto. Y lo que está sucediendo ahora es que estos datos se están uniendo en estas dos bases de datos. Hasura está empujando el SQL correcto en ambas direcciones. Está empujando el SQL aquí y empujando el SQL que se une entre artistas y álbumes.

El último ejemplo rápido que quiero mostrarte es un ejemplo de unir esto con la API REST. Cuando agregamos fuentes de datos REST a Hasura, las llamamos acciones. Así que creemos una acción para mapear un punto final REST que tengo. Y déjame ver si puedo mostrar el punto final REST aquí. Entonces, mi punto final REST, lo que va a... Lo que hago con Hasura es especificar la especificación de GraphQL para mapear ese punto final REST en particular. Y en este caso, mi punto final REST es un punto final getUserInfo. Devuelve información adicional sobre el usuario. Viene de una API REST externa. Así que digamos que tengo el tipo de consulta y luego digo getUserInfo Id int. Y esto devuelve un objeto de información del usuario. Y ahora puedo decir tipo de información del usuario. Solo estoy especificando el contrato aquí. Y el contrato es id, que es un int. Tiene un verificado, que es un booleano. Esta es una API REST que ya he creado, por eso sé cuál es el contrato. Y la dirección es una cadena. Y el punto final que tengo está aquí. También se está ejecutando en una aplicación de Heroku.

4. Remote Joins and REST API Integration

Short description:

Puedo hacer una llamada a la API para obtener información del usuario desde un punto final de API REST. Sin embargo, también quiero devolver información del usuario desde nuestra base de datos. Para lograr esto, establezco una relación entre la API REST y nuestra base de datos. Al enriquecer el esquema, puedo consultar detalles del usuario, como ID y correo electrónico, y obtener información del artista, incluyendo nombre y álbumes. Esta consulta combina datos del punto final REST, nuestra base de datos y otro punto final GraphQL. Echa un vistazo a las uniones remotas y no dudes en contactarme en Twitter si tienes alguna pregunta.

Entonces, déjame configurar ese controlador aquí. Y creemos esto. Tan pronto como cree esta acción, lo que sucede es que puedo hacer esta llamada a la API donde puedo decir consulta, obtener información del usuario, y puedo obtener el ID, la dirección y verificarlo. Correcto. Y ahora esto está respaldado por un punto final de API REST. Correcto. Así que déjame ver si puedo mostrar también ese GitHub, solo para mostrarte cómo se ve. Fuente de datos REST. Puede que me esté quedando sin tiempo. Así que no voy a mostrarte el código fuente. Pero lo que se ve ahora es que hay un punto final REST y el punto final REST básicamente nos devuelve estos datos. Correcto. Esto no está bien porque también me gustaría devolver la información del usuario. Entonces, lo que me gustaría hacer es tener este punto final de API REST devolver información sobre el usuario que está en mi database. Y así voy a agregar una relación desde la API REST, correcto, a nuestra database. Así que voy a decir artista. Y luego voy a decir que esto en realidad proviene del, lo siento, voy a decir usuario. Esto en realidad proviene de una tabla de usuarios donde el ID se mapea al ID. Pero el ID se mapea al ID. Y ahora lo que puedo hacer es si vuelvo a nuestro gráfico, verás que este esquema se ha enriquecido con la entidad de usuario y luego puedo agregar usuario y puedo decir ID, tal vez correo electrónico y luego también puedo obtener la información del artista. ¿Correcto? Y el artista tiene un nombre y luego puedo hacer álbumes. Y luego el álbum tendrá un título. ¿Correcto? Así que aquí hay una consulta que estoy haciendo y lo que esta consulta está haciendo ahora es lo que esta consulta está haciendo ahora es que está haciendo una consulta al punto final REST, obteniendo los datos REST, luego haciendo una consulta para unir esa información con nuestra database, y luego uniendo esa información con otro punto final GraphQL, que resulta estar encima de una database. Así que eso son las uniones remotas. Échales un vistazo, juega con ellas. Háganos saber qué piensas. Y como siempre, no dudes en contactarme en Twitter si tienes alguna pregunta. ¡Gracias, amigos!

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.