Relações

Lendo através de uma referência

No GraphQL, uma referência resolve para o tipo do próprio registro de destino, então você seleciona os campos relacionados inline. Um campo pode ser limitado aos modelos para os quais pode apontar. Se admitir dois ou mais, ele retorna uma union que você lê com inline fragments. No cliente de dados do SDK, as relações são opt-in: peça-as com include, que aninha até três níveis.

Dentro de uma requisição, as referências a registros do mesmo modelo são buscadas juntas em lotes. Por padrão, uma consulta pode aninhar 24 níveis de profundidade.

Filtrando e gravando

Uma consulta de lista pode filtrar através de uma referência usando o filtro do próprio modelo referenciado, por exemplo posts do autor com determinada chave natural. Uma gravação conecta uma referência a um registro pela chave natural desse registro, ou a desconecta para limpá-la.

Tipos de relacionamento

Uma referência simples é estrutural e não concede acesso ao registro para o qual aponta. Uma associação de leitura muda isso para leituras: quem pode ler o registro referenciado pode ler o que se refere a ele, a um salto de distância. Uma composição faz o filho pertencer ao pai, então o acesso e as exclusões se propagam do pai para o filho, e ela é sempre de valor único. O quarto tipo transforma um modelo em uma árvore, descrita em hierarquias.

Travessia reversa

Nomeie um inverse na referência e o modelo de destino ganha um campo que lista os registros que apontam para ele. Para uma composição, esse campo é uma lista simples. Para uma associação, é uma conexão paginada que aceita os mesmos argumentos de filtro, ordenação e paginação da consulta de lista do modelo.