Create GraphQL APIs on Azure Cosmos DB for NoSQL in 2 minutes

Connect Hasura to your new or existing Azure Cosmos NoSQL database and generate high-quality, secure, and performant GraphQL APIs.

Instant GraphQL APIs

Build high-quality GraphQL APIs on Azure Cosmos DB, instantly

Connect to a new or existing Azure Cosmos for NoSQL database and get standardized, highly composable GraphQL APIs. The Hasura GraphQL Engine introspects the database and automatically generates GraphQL schemas and resolvers based on the CosmosDB indices.

GraphQL Queries on Azure Cosmos DB

Leverage the full power of GraphQL API to interact with your Azure Cosmos database for all your read use cases.

Query exactly what you want from your Cosmos DB index and documents.

Relationships and nesting

The GraphQL API on Azure Cosmos handles relationships between models, and queries can be nested to any depth if required.

Pagination

Easily manage large datasets with built-in pagination capabilities. Cursor-based, Relay-style, and offset-based pagination is supported natively.

Filtering

Filter query results on Cosmos DB documents and fields using advanced WHERE clauses and Boolean / logical operators like _and / _or, etc.

Sorting

Sort data based on multiple fields in Cosmos DB documents and specify the sort direction (ascending or descending), making it easy to present your data.

Aggregation

Perform various aggregations to get summary about your Cosmos DB data directly within your GraphQL queries. Leverage aggregate functions in Azure Cosmos DB like count, sum, min, max, avg, etc.

Search

Perform similarity, nearest neighbor search using native queries.

query fetchAccountsAndCustomer {
  accounts(where: { account_id: { _eq: "AZ2376" } }) {
    id
    account_id
    name
    customer {
      id
      first_name 
      last_name
      zip_code
    }
  }
}

Fetch accounts' data like the `id` and `name` where the account_id is equal to some value, and fetch the `customer` data for the account.

query {
 authors(where: { articles: { rating: { _gt: 4 } } }) {
   id
   name
   articles(where: { rating: { _gt: 3 } }) {
     id
     title
     rating
   }
 }
}

Fetch a list of authors who have articles with a rating greater than 4 along with those articles which have a rating greater than 3.

query {
  authors (order_by: {name: asc}, limit: 10) {
    id
    name
    articles(order_by: {rating: desc}) {
      id
      title
      rating
    }
  }
}

Fetch a list of 10 authors sorted by their names with a list of their articles sorted by their rating.

query {
  articles_aggregate {
    aggregate {
      count
      sum {
        rating
      }
      avg {
        rating
      }
      max {
        rating
      }
    }
    nodes {
      id
      title
      rating
    }
  }
}

Fetch a list of articles with aggregated data of their rating.

query MyQuery {
 moviesSearch(
   ninGenres: ["Drama", "Western", "Crime"]
   inGenres: ["Action", "Adventure", "Family"]
   gteYear: 1960
   lteYear: 2000
   numCandidates: 200
   limit: 2
 ) {
   genres
   plot
   score
   year
   title
 }
}

Search movies based on vector.

GraphQL Mutations on Azure Cosmos DB

Perform robust data manipulation operations on your Cosmos database with GraphQL mutations. Insert, update, or delete data in Cosmos DB via Hasura’s native queries.

mutation {
 insert_artist(id: 100, name: "New Artist") {
   ArtistId
   Name
 }
}

Insert into the artist document in Azure Cosmos DB index with values for `id` and `name` fields.

High-performance GraphQL APIs, at scale

Hasura takes a domain-driven approach to GraphQL, where a GraphQL query is compiled to a query on a domain model (a database query or existing APIs) resulting in superior API performance.

Hasura leverages the goodness of Cosmos DB to create efficient GraphQL queries.

Compile vs. resolve

Hasura avoids the GraphQL N+1 query problem by compiling a query instead of resolving. This compiler-based approach allows Hasura to form a single database query for a GraphQL query of any depth and avoids the N+1 problem in GraphQL.

Predicate pushdown database query Azure Cosmos DB

Hasura filters data at the source with a predicate pushdown of queries to Azure Cosmos DB. Hasura is able to push down a majority of queries like Projection, Permissions, Relationships and joins, Arguments and filtering.

Performance benchmarks

Hasura’s GraphQL APIs are faster than handwritten subgraphs on top of Azure Cosmos DB

Learn more about how Hasura does high-performance domain-driven APIs.

Add caching to existing Azure Cosmos DB GraphQL APIs for faster response times

Get up to 10x faster API performance on Cosmos DB with end-to-end caching, scaling vertically and horizontally.

Hasura has metadata about the data models across data sources, and the authorization rules at the application level, which helps provide end-to-end caching.