Adds the @extends directive to the type to indicate that the type as owned by another service.

example

Example

object :user do
  extends()
  key_fields("id")
  field :id, non_null(:id)
end

sdl-output

SDL Output

type User @key(fields: "id") @extends {
  id: ID!
}

Adds the @external directive to the field which marks a field as owned by another service. This allows service A to use fields from service B while also knowing at runtime the types of that field.

example

Example

object :user do
  extends()
  key_fields("email")
  field :email, :string do
    external()
  end
  field :reviews, list_of(:review)
end

sdl-output

SDL Output

# extended from the Users service
type User @key(fields: "email") @extends {
  email: String @external
  reviews: [Review]
}

This type extension in the Reviews service extends the User type from the Users service. It extends it for the purpose of adding a new field called reviews, which returns a list of Reviews.

The @inaccessible directive indicates that a field or type should be omitted from the gateway's API schema, even if it's also defined in other subgraphs.

example

Example

object :user do
  key_fields("id")
  field :id, non_null(:id)

  field :name, :string do
    inaccessible()
  end
end

sdl-output

SDL Output

type User @key(fields: "id") {
  id: ID!
  name: String @inaccessible
}

Adds the @interfaceObject directive to the field which indicates that the object definition serves as an abstraction of another subgraph's entity interface. This abstraction enables a subgraph to automatically contribute fields to all entities that implement a particular entity interface.

During composition, the fields of every @interfaceObject are added both to their corresponding interface definition and to all entity types that implement that interface.

More information can be found on: https://www.apollographql.com/docs/federation/federated-types/interfaces

example

Example

object :media do
  key_fields("id")
  interface_object()

  field :id, non_null(:id), do: external()
  field :reviews, non_null(list_of(non_null(:review)))
end

object :review do
  field :score, non_null(:integer)
end

sdl-output

SDL Output

type Media @interfaceObject @key(fields: "id") {
  id: ID! @external
  reviews: [Review!]!
}

type Review {
  score: Int!
}

Adds a @key directive to the type which indicates a combination of fields that can be used to uniquely identify and fetch an object or interface. This allows the type to be extended by other services. A string rather than atom is used here to support composite keys e.g. id organization { id }

example

Example

object :user do
  key_fields("id")
  field :id, non_null(:id)
end

sdl-output

SDL Output

type User @key(fields: "id") {
  id: ID!
}

The @link directive links definitions from an external specification to this schema. Every Federation 2 subgraph uses the @link directive to import the other federation-specific directives.

NOTE: If you're using Absinthe v1.7.1 or later, instead of using this macro, it's preferred to use the extend schema method you can find in the README.

example

Example

link(url: "https://specs.apollo.dev/federation/v2.0", import: ["@key", "@tag", "@shareable"])

query do
  field :me, :user
end

object :user do
  key_fields("id")
  shareable()
  field :id, non_null(:id)

  field :ssn, :string do
    tag("internal")
  end
end

sdl-output

SDL Output

schema @link(url: "url: https:\/\/specs.apollo.dev\/federation\/v2.0", import: ["@key", "@tag", "@shareable"])

type User @key(fields: "id") @shareable {
  id: ID!
  name: String @tag(name: "internal")
}

Adds The @override directive is used to indicate that the current subgraph is taking responsibility for resolving the marked field away from the subgraph specified in the from argument.

example

Example

object :user do
  key_fields("id")
  field :id, non_null(:id)

  field :name, :string do
    override_from("SubgraphA")
  end
end

sdl-output

SDL Output

type User @key(fields: "id") {
  id: ID!
  name: String @override(from: "SubgraphA")
}

Adds the @provides directive which is used to annotate the expected returned fieldset from a field on a base type that is guaranteed to be selectable by the gateway.

example

Example

object :review do
  key_fields("id")
  field :id, non_null(:id)
  field :product, :product do
    provides_fields("name")
  end
end

object :product do
  extends()
  key_fields("upc")
  field :upc, :string do
    external()
  end
  field :name, :string do
    external()
  end
end

sdl-output

SDL Output

type Review @key(fields: "id") {
  product: Product @provides(fields: "name")
}

type Product @key(fields: "upc") @extends {
  upc: String @external
  name: String @external
}

When fetching Review.product from the Reviews service, it is possible to request the name with the expectation that the Reviews service can provide it when going from review to product. Product.name is an external field on an external type which is why the local type extension of Product and annotation of name is required.

Adds the @requires directive which is used to annotate the required input fieldset from a base type for a resolver. It is used to develop a query plan where the required fields may not be needed by the client, but the service may need additional information from other services.

example

Example

object :user do
  extends()
  key_fields("id")
  field :id, non_null(:id) do
    external()
  end
  field :email, :string do
    external()
  end
  field :reviews, list_of(:review) do
    requires_fields("email")
  end
end

sdl-output

SDL Output

# extended from the Users service
type User @key(fields: "id") @extends {
  id: ID! @external
  email: String @external
  reviews: [Review] @requires(fields: "email")
}

In this case, the Reviews service adds new capabilities to the User type by providing a list of reviews related to a User. In order to fetch these reviews, the Reviews service needs to know the email of the User from the Users service in order to look up the reviews. This means the reviews field / resolver requires the email field from the base User type.

Adds the @shareable directive to the type to indicate that a field can be resolved by multiple subgraphs.

example

Example

object :user do
  key_fields("id")
  shareable()
  field :id, non_null(:id)
end

sdl-output

SDL Output

type User @key(fields: "id") @shareable {
  id: ID!
}

The @tag directive indicates whether to include or exclude the field/type from your contract schema.

example

Example

object :user do
  key_fields("id")
  field :id, non_null(:id)

  field :ssn, :string do
    tag("internal")
  end
end

sdl-output

SDL Output

type User @key(fields: "id") {
  id: ID!
  name: String @tag(name: "internal")
}