Remote Joins: A GraphQL API to join across your database and other data-sources


We've been working hard on a core Hasura feature that will allow you to fetch related data that is in your database and in remote data sources with GraphQL. (Currently in preview, if you'd like to get notified when this is released, do sign up here!)

As developers and teams move to using more and more 3rd party APIs, multiple databases & microservices, data and "the source of truth" is getting spread across these data-sources. Application developers have a hard time getting access to precise slices of data and a lot of dev cycles are spent in bringing all that data together securely.

Remote Joins: A GraphQL API to join across your database and other data-sources

Remote Joins in Hasura extend the concept of joining data across tables, to being able to join data across tables and remote data sources. Once you create relationships between types from your database and types created from APIs, you can then “join” them by running GraphQL queries. #JoinAllTheThings

Head to the PR to check out more details, read the preview docs, and to try out a test Hasura image that you can spin up. Jump on our discord or comment on github and let us know what you think!

Remote joins can join across the database and APIs. These APIs can be custom GraphQL servers you write, 3rd party SaaS APIs, or even other Hasura instances.

Of course, because Hasura is meant to be a GraphQL server that you can expose directly to your apps, Hasura also handles security and authorization while providing remote joins.


Use Case #1: Customer data joined with Account/Billing/Payment information in Stripe

If you have a payment method on your app that uses Stripe, a lot of account and billing information about your customer resides with Stripe. For example, the customer's saved cards, account balance, billing/invoice history.

Customer data joined with account, billing, payment-transaction data in Stripe

On your app, you'd typically want to show users their saved cards and invoice history. You'd write code to fetch the right data from the Stripe API for the right users/invoices and return that as an API response to your app.

This is what this setup looks like on Hasura:

Step 1: Setup OneGraph to connect to your Stripe account

Setup OneGraph to connect to your Stripe account

Step 2: Add OneGraph as a remote schema to Hasura

Add OneGraph as a remote schema to Hasura

Step 3: Setup a remote relationship from your customer table to the Stripe resolver using the stripe_customer_id as the "join" key

Your table should have the stripe_customer_id column
Setup a remote relationship from your customer table to the Stripe resolver using the stripe_customer_id as the "join" key

Step 4: Make GraphQL queries to fetch customer and stripe information in one shot!

Make GraphQL queries to fetch customer and stripe information in one shot!

Use-case #2: User data joined with profile information in Auth0

When you use an external authentication provider (or even an authentication/user management microservice that your team doesn't own directly), there will be some information that is only provided by the auth service. For example, last_login, verified_email, login_count and so on.

In your database, you would typically have a user table that has an auth0_id. To fetch auth specific information, you would need to use this id and the Auth0 API.

User data joined with account/profile/auth information in Auth0

Here's how Hasura helps you automate that process:

Step 1: Write a serverless function that wraps the Auth0 profile API in a GraphQL query resolver.

Write a serverless function that wraps the Auth0 profile API in a GraphQL query resolver. 

Step 2: Connect this as a remote schema in Hasura

Connect this as a remote schema in Hasura

Step 3: Go to the User table on Hasura and add a "remote relationship" to the schema you added above

The auth0_id identifier is the "join" key from your database
Add a "remote relationship" to the auth0 schema

Step 4: Make a GraphQL query to query data from the user table and the Auth0 profile information simultaneously

Make a GraphQL query to query data from the user table and the Auth0 profile information simultaneously

Use-case #3: Joining data across 2 separate databases

Joining data across 2 databases

The title says it all 🤓. And here's how this works with Hasura!

Step 1: Setup Hasura to point to Database 1 and Database 2 with the right access control rules so that your GraphQL API is secure

The "remote" Hasura + Postgres
The "primary" Hasura + Postgres

Step 2: On the Hasura of your "primary" database, add the second Hasura as a remote schema

On the Hasura of your "primary" database, add the second Hasura as a remote schema

Step 3: Set up remote relationships from any table in your "primary" database to  resolvers in the other database.

Set up remote relationships from any table in your "primary" database to resolvers in the other database

Step 4: Run a GraphQL query that joins data across 2 databases!

A GraphQL query that joins data across 2 databases!

Note: Hasura Remote Joins is a type of GraphQL federation, similar to Apollo Federation. The key difference is that Apollo Federation aims to help organisations with multiple GraphQL teams “federate” a global GraphQL schema. Hasura remote joins help you “join” across multiple data-sources (or GraphQL microservices) so that you get a unified GraphQL API. This unified GraphQL API might be required for a team that has multiple sources of data for their application or might be a unified GraphQL API across various teams (like Apollo Federation) maintained by a central data API team in the organisation.


Try it out and let us know what you think! We ❤️ your feedback. Hit us up on our github or on discord. Remote Joins will be out of preview and released very very soon for production use!


Hasura is an open-source engine that gives you realtime GraphQL APIs on new or existing Postgres databases, with built-in support for stitching custom GraphQL APIs and triggering webhooks on database changes.


PS: We’re hiring!


Tanmai Gopal

Tanmai Gopal

Tanmai is the co-founder of hasura.io. He is passionate about making it easier to build things.

Read More