Relazioni
Una relazione è un campo di riferimento in cui un record punta a un altro. Una query lo legge attraverso la relazione nella stessa richiesta, e il campo dichiara che tipo di relazione è, il che decide se accesso ed eliminazioni la seguono.
Leggere attraverso un riferimento
In GraphQL un riferimento si risolve nel tipo del record di destinazione, quindi selezioni i campi correlati direttamente nella query. Un campo può essere limitato ai modelli a cui può puntare. Se ne ammette due o più, restituisce una union che leggi con i frammenti inline. Nel client dati dell'SDK le relazioni sono opt-in: le richiedi con include, che annida fino a tre livelli.
All'interno di una richiesta, i riferimenti a record dello stesso modello vengono recuperati insieme in batch. Per impostazione predefinita una query può arrivare a 24 livelli di profondità.
Filtrare e scrivere
Una query di elenco può filtrare attraverso un riferimento usando il filtro del modello referenziato, per esempio i post dell'autore con una determinata chiave naturale. Una scrittura collega un riferimento a un record tramite la chiave naturale di quel record, oppure lo scollega per svuotarlo.
Tipi di relazione
Un riferimento semplice è strutturale e non concede alcun accesso al record a cui punta. Un'associazione in lettura cambia questo per le letture: chi può leggere il record referenziato può leggere quello che lo referenzia, per un salto. Una composizione rende il figlio di proprietà del padre, quindi accesso ed eliminazioni si propagano a cascata dal padre al figlio, ed è sempre a valore singolo. Il quarto tipo trasforma un modello in un albero, descritto in gerarchie.
Attraversamento inverso
Indica un inverse sul riferimento e il modello di destinazione ottiene un campo che elenca i record che puntano ad esso. Per una composizione quel campo è un semplice elenco. Per un'associazione è una connessione paginata che accetta gli stessi argomenti di filtro, ordinamento e paginazione della query di elenco del modello.
Leggi i dettagli
La guida di riferimento ai tipi di campo documenta il campo di riferimento e le sue opzioni, e il riferimento alla configurazione dei modelli tratta i tipi di relazione.