Condividi tramite


Gestire relazioni nell'API Fabric per GraphQL

GraphQL consente di stabilire relazioni tra tipi, tra cui relazioni uno-a-uno (1:1), uno-a-molti (1:N) e relazioni molti-a-molti (M:N).

Creare una nuova relazione uno-a-uno

  1. Nel riquadro Esplora schemi selezionare i puntini di sospensione accanto a un tipo e quindi selezionare l'opzione Gestisci relazioni . Appare la schermata Gestisci relazioni.

    Screenshot che mostra dove selezionare la nuova relazione nel riquadro Gestisci relazioni.

  2. Seleziona Nuova relazione. Per questo esempio viene creata una nuova relazione uno-a-uno tra il tipo Product e il tipo ProductModel, in base al campo ProductModelID esistente in entrambi i tipi. Selezionare Uno a uno per Cardinalità, selezionare i tipi Da e A e quindi selezionare i campi Da e A per questa relazione.

    Screenshot che mostra esempi di selezioni per i cinque campi obbligatori per una nuova relazione.

Nota

È possibile selezionare più campi nei selettori di campo Da e A. Questa funzionalità consente di creare relazioni che includono più campi.

  1. Selezionare Crea relazione. L'elenco di relazioni ora mostra la relazione appena creata.

    Screenshot che mostra la relazione appena creata nel riquadro Gestisci relazioni.

  2. Selezionare la X nell'angolo superiore destro per chiudere la schermata Gestisci relazioni .

Relazioni uno-a-molti (1:N) e molti-a-molti (M:N)

Per creare una relazione uno-a-molti (1:N), ad esempio tra Product e Order, in cui ogni prodotto può essere associato a più ordini, selezionare Uno a molti come cardinalità. Questa relazione riflette l'idea che un singolo prodotto possa essere collegato a più ordini, ma ogni ordine è collegato a un solo prodotto.

Per una relazione molti-a-molti (M:N), ad esempio tra Books e Authors, in cui un libro può avere più autori e un autore può avere più libri, scegliere Molti a molti come cardinalità. Per supportare questo tipo di relazione, è necessario avere un tipo di collegamento nello schema.

La finestra di dialogo Nuova relazione mostra un altro set di selettori quando si seleziona Molti-a-molti come cardinalità. Ad esempio, in Libri e autori selezionare un tipo di collegamento come BooksAuthors e campi come BookId e AuthorId come collegamento da e ai campi.

Screenshot della finestra di dialogo per una nuova relazione molti-a-molti.

Considerazioni per le relazioni molti-a-molti

Se il tipo di collegamento include uno o più campi a cui non viene fatto riferimento come da campi o a campi, l'API GraphQL genera automaticamente le seguenti quattro relazioni uno-a-molti:

  • Una relazione uno-a-molti dal tipo Da al tipo collegamento

  • Una relazione uno-a-molti dal tipo collegamento al tipo Da

  • Una relazione uno-a-molti dal tipo A e il tipo collegamento

  • Una relazione uno-a-molti dal tipo collegamentoal tipo A

Questi consentono di fare riferimento ai campi non collegati nel tipo di collegamento in qualsiasi query o mutazione, e di consentire alle query o mutazioni di fare riferimento alle relazioni in qualsiasi direzione.

Se nel tipo di collegamento non sono presenti campi scollegati, viene creata una singola relazione molti-a-molti e non è necessario fare riferimento al tipo di collegamento per usare la relazione.

Eliminazione di una relazione

Eliminare una relazione dalla schermata Gestisci relazioni selezionando la casella di controllo accanto alla relazione e selezionando Elimina.