Udostępnij przez

Zarządzanie relacjami w interfejsie API sieci szkieletowej dla języka GraphQL

Narzędzie GraphQL umożliwia ustanawianie relacji między typami, w tym relacjami jeden do jednego (1:1), jeden do wielu (1:N) i relacjami wiele do wielu (M:N).

Tworzenie nowej relacji jeden do jednego

  1. W okienku Eksplorator schematu wybierz wielokropek obok typu, a następnie wybierz opcję Zarządzaj relacjami . Zostanie wyświetlony ekran Zarządzanie relacjami .

    Zrzut ekranu przedstawiający miejsce wybierania nowej relacji w okienku zarządzania relacjami.

  2. Wybierz Nowa relacja. W tym przykładzie utworzymy nową relację jeden do jednego między typem Product a typem ProductModel na podstawie pola ProductModelID, które istnieje w obu typach. Wybieramy opcję Jeden do jednego dla opcji Kardynalność, wybieramy typy Od i Do, a następnie wybieramy pola Od i Do dla tej relacji.

    Zrzut ekranu przedstawiający przykłady wyboru pięciu wymaganych pól dla nowej relacji.

Uwaga

Możesz wybrać wiele pól w selektorach pól Od i Do. Ta funkcja umożliwia tworzenie relacji obejmujących wiele pól.

  1. Wybierz pozycję Utwórz relację. Lista relacji zawiera teraz nowo utworzoną relację.

    Zrzut ekranu przedstawiający nowo utworzoną relację w okienku zarządzanie relacjami.

  2. Wybierz znak X w prawym górnym rogu, aby zamknąć ekran Zarządzanie relacjami .

Relacje jeden do wielu (1:N) i wiele do wielu (M:N)

Aby utworzyć relację jeden do wielu (1:N), na przykład między produktem i zamówieniem, gdzie każdy produkt może być skojarzony z wieloma zamówieniami, wybierz jeden do wielu jako kardynalność. Ta relacja odzwierciedla ideę, że jeden produkt może być połączony z wieloma zamówieniami, ale każde zamówienie jest połączone tylko z jednym produktem.

W przypadku relacji wiele do wielu (M:N), takich jak między książkami i autorami, gdzie książka może mieć wielu autorów, a autor może mieć wiele książek, wybierz pozycję Wiele do wielu jako kardynalność. Aby dopasować ten rodzaj relacji, musisz mieć typ łączenia w schemacie.

W oknie dialogowym Nowa relacja jest wyświetlany inny zestaw selektorów po wybraniu opcji Wiele do wielu jako kardynalności. Na przykład, w Książki i Autorzy, wybierz typ połączenia, taki jak BooksAuthors, oraz pola, takie jak BookId i AuthorId, jako pola łączące z i do.

Zrzut ekranu przedstawiający okno dialogowe nowej relacji dla relacji wiele-do-wielu.

Zagadnienia dotyczące relacji wiele-do-wielu

Jeśli twój typ łączenia zawiera co najmniej jedno pole, które nie jest wskazane jako Pole Od lub Pole Do, API GraphQL automatycznie generuje następujące cztery relacje typu jeden do wielu:

  • Relacja jeden do wielu z typu Od do typu Łączenie

  • Relacja jeden do wielu z typu Łączenie z typemFrom

  • Relacja jeden do wielu z typu To do typu Łączenie

  • Relacja jeden do wielu z typu Łączenie z typemTo

Umożliwiają odniesienie się do niepowiązanych pól w typie łączenia w zapytaniach lub mutacjach, a zapytania lub mutacje mogą odwoływać się do relacji w dowolnym kierunku.

Jeśli w typie Link nie ma niezlinkowanych pól, zostanie utworzona relacja wiele-do-wielu, a zapytania lub mutacje nie muszą odwoływać się do typu łączenia, aby użyć relacji.

Usuwanie relacji

Usuń relację z ekranu Zarządzanie relacjami , zaznaczając pole wyboru obok relacji i wybierając pozycję Usuń.

Powiązana zawartość

  • Last updated on