Remote Schemas

Table of contents

Introduction

Hasura gives you CRUD + realtime GraphQL APIs with authorization & access control. However, in many cases, you will need to write APIs (queries, mutations) that contain custom logic. For example, implementing a payment API, or querying data that is not in your database.

Hasura has the ability to merge remote GraphQL schemas and provide a unified GraphQL API. Think of it like automated schema stitching. All you need to do is build your own GraphQL service and then provide the HTTP endpoint to Hasura. Your GraphQL service can be written in any language or framework.

This is what Hasura running with “Remote schemas” looks like:

Architecture of Hasura with remote schemas

Use cases

  • Custom business logic, like a payment API
  • Querying data that is not available in your database

You can handle these use cases by writing resolvers in a custom GraphQL server and making Hasura merge this “remote schema” with the existing auto-generated schema. You can also add multiple remote schemas. Think of the merged schema as a union of top-level nodes from each of the sub-schemas.

Note

If you are looking for adding authorization & access control for your app users to the GraphQL APIs that are auto-generated via Hasura, head to Authentication & Authorization

Health monitoring of remote schemas in Hasura Cloud

Hasura Cloud offers built-in API metrics with integrated health checks and distributed tracing for your remote schemas. Read more at Distributed Tracing in Hasura Cloud.

Learn more

Additional Resources

Data Federation with Hasura - Watch Webinar.