Skip to main content
Version: v2.x

Remote Relationships


Remote relationships (aka "remote joins") allow you to join data across Remote Schemas and other remote data sources. The remote data source can either be another Remote Schema or a table from a database source. Once you create relationships between types from your Remote Schema and types created from databases or other Remote Schemas, you can then "join" them by running GraphQL queries.

See the following guides on how to create different types of remote relationships related to Remote Schemas:


Hasura's remote joins architecture provides the following benefits.

  • Security: Hasura's authorization model gives you role-based access control. This extends to Actions and Remote Schemas as well. In actions, you can go to the Permissions tab and choose which fields to expose for which roles. For Remote Schemas, Hasura will forward your session variables which can be used to implement custom authorization in your Remote Schemas. Native role-based permissions on Remote Schemas is in the works.
  • Performance: Hasura strives for optimal performance. It creates an efficient execution plan which pushes down most of the heavy-lifting involved to underlying sources. For example, Hasura creates a single efficient query to your database and batches calls to Remote Schemas to avoid the n+1 problem . More improvements to performance are upcoming.
  • Schema integrity & consistency: Hasura has Metadata consistency checks at every level. Whenever you add a table, Remote Schema, or action, Hasura makes sure that the graph that is exposed is consistent, and that all the relationships make sense at a type level. This helps you in creating robust workflows to test changes in your CI and making safe deployments of your unified graph.
  • Data federation: With remote joins, the join, authorization, and consistency checks of added sources all happen at the Hasura layer via metadata. This allows underlying data sources and APIs to evolve independently. Your applications have a unified API to query the full data landscape in your org.
Additional Resources

Data Federation with Hasura - Watch Webinar.