Sdílet prostřednictvím

Správa relací v rozhraní API Fabric pro GraphQL

  • Článek

Jednou z nejvýkonnějších funkcí v GraphQL je schopnost vytvářet relace napříč typy, včetně podpory relací 1:1 (1:1), 1:N (1:N) a relací M:N (M:N).

Vytvoření nové relace 1:1

  1. V podokně Průzkumník schémat vyberte tři tečky vedle typu a vyberte možnost Spravovat relace. Zobrazí se obrazovka Spravovat relace .

    Snímek obrazovky Spravovat relace znázorňující, kde vybrat možnost Nová relace

  2. Vyberte Nový vztah. V tomto příkladu vytvoříme novou relaci 1:1 mezi typem Produktu a typem ProductModel na základě pole ProductModelID , které existuje v obou typech. Pro kardinalitu vybereme jednu k jedné, vybereme typy Od a Do a pak pro tuto relaci vybereme pole Od a To.

    Snímek obrazovky Nový vztah zobrazující příklady výběrů pro pět požadovaných polí

    Poznámka:

    V nástroji Pro výběr polí Od a Do můžete zvolit více polí. Tato funkce umožňuje vytvářet relace, které tvoří více polí.

  3. Vyberte Vytvořit relaci. V seznamu relací se teď zobrazuje nově vytvořená relace.

    Snímek obrazovky Spravovat relace zobrazující nově vytvořenou relaci v seznamu

  4. Výběrem symbolu X v pravém horním rohu zavřete obrazovku Spravovat relace .

Relace 1:N (1:N) a M:N

Pokud chcete vytvořit relaci 1:N (1:N), například mezi produktem a objednávkou, kde lze každý produkt přidružit k více objednávkám, vyberte jednu k mnoha jako kardinalitu. Tento vztah odráží myšlenku, že jeden produkt může být propojený s více objednávkami, ale každá objednávka je propojená pouze s jedním produktem.

Pro vztah M:N (M:N), například mezi knihami a autory, kde může mít kniha více autorů a autor může mít více knih, zvolte jako kardinalitu M:N. Aby bylo možné tento typ relace přizpůsobit, musíte mít ve schématu typ propojení.

Dialogové okno Nová relace zobrazuje další sadu výběrů, když jako kardinalitu zvolíte M:N . V příkladu Knihy a autoři byste vybrali typ propojení, jako jsou BooksAuthors, a pole, jako je BookId a AuthorId, jako propojení z a do polí.

Snímek obrazovky s dialogovým oknem Nová relace pro relaci M:N

Důležité informace o relacích M:N

Pokud typ propojení obsahuje jedno nebo více polí, na která se neodkazuje jako na pole Od nebo do polí, rozhraní API pro GraphQL automaticky vygeneruje čtyři relace 1:N následujícím způsobem:

  • Relace 1:N z typu Od k typu Propojení
  • Relace 1:N z typu Propojení s typem Od
  • Relace 1:N z typu To na typ Propojení
  • Relace 1:N z typu Propojení na typ To

Díky tomu můžete odkazovat na nepřipojená pole v typu Propojení v jakýchkoli dotazech nebo mutacích, a zároveň povolit dotazy nebo muty, které odkazují na relace v libovolném směru.

V případě, že typ propojení neobsahuje žádná nepřipojená pole, vytvoří se jedna relace M:N a všechny dotazy nebo změny nebudou muset odkazovat na typ propojení, aby bylo možné tuto relaci využít.

Odstranění relace

Relaci můžete odstranit na obrazovce Spravovat relace tak, že zaškrtnete políčko vedle relace a pak vyberete Odstranit.

Související obsah