split-schema

Provides a @splitSchema Type System Directive to split a subgraph schema into multiple shards in order to force concurrency at the gateway.

Usage

Install

$ npm i @yelp/split-schema

Command Line Usage

$ split-schema --schema "path/to/schema.graphql" --output-directory "path/to/output/shards/directory"

Check $ split-schema --help for more documentation.

Why?

Under certain circumstances, slow operations inside a federated GraphQL query may not be executed concurrently (as they otherwise could be without Federation) leading to unacceptably slower performance.

Example

See graphql/composite-schemas-spec#198 for more details.