Command line utility for generating an Apollo Federation 1 query plan

The code in this repository is experimental and has been provided for reference purposes only. Community feedback is welcome but this project may not be supported in the same way that repositories in the official Apollo GraphQL GitHub organization are. If you need help you can file an issue on this repository, contact Apollo to talk to an expert, or create a ticket directly in Apollo Studio.

The main branch of this repo has moved to supporting Federation 2. This branch (version-0.x) is for Federation 1 support.

The code in this branch will only work with Federation 1 schemas. If you need Federation 2 support, you can switch to the main branch.

Whenever your federated gateway receives an incoming GraphQL operation, it needs to figure out how to use your subgraphs to populate data for each of that operation's fields. To do this, the gateway generates a query plan. A query plan is a blueprint for dividing a single incoming operation into one or more operations that are each resolvable by a single subgraph. Some of these operations depend on the results of other operations, so the query plan also defines any required ordering for their execution. Because query plans are generated based on the operation, they only way to debug performance issues is to run the query plan code itself.

A query plan is built from two pieces:

• Supergraph Schema
• GraphQL Operation

You can also view query plans in Apollo Studio Explorer and by logging the runtime results of your gateway.

If you have a Federation 1 supergraph file available locally, you can use the following command:

npx github:@apollosolutions/generate-query-plan#version-0.x \
  --supergraph supergraph.graphql \
  --operation operation.graphql

If you have a federated graph in Apollo Studio, you can pass an API key and the graphref, and the CLI will fetch the supergraph for you first, then generate the query plan:

export APOLLO_KEY="your api key"
npx github:@apollosolutions/generate-query-plan#version-0.x \
  --graphref mygraph@current \
  --operation operation.graphql