Compartilhar via


Gerenciar relacionamentos na API de Fabric para GraphQL

O GraphQL permite estabelecer relações entre tipos, incluindo relações um para um (1:1), um para muitos (1:N) e relações muitos para muitos (M:N).

Criar uma nova relação um-para-um

  1. No painel Explorador de Esquemas, selecione o ícone de reticências ao lado de um tipo e, em seguida, selecione Gerenciar relações. A tela Gerenciar relações é exibida.

    Captura de tela mostrando onde selecionar a nova relação no painel gerenciar relações.

  2. Selecione Novo relacionamento. Para este exemplo, criamos uma nova relação um-para-um entre o tipo Product e o tipo ProductModel, com base no campo ProductModelID que existe em ambos os tipos. Selecionamos Um a um para Cardinalidade, selecionamos os tipos De e Para e, em seguida, selecionamos os campos De e Para para esta relação.

    Captura de tela mostrando exemplos de seleções para os cinco campos necessários para uma nova relação.

Observação

Você pode selecionar vários campos nos seletores de campo De e Para. Esse recurso permite que você crie relações que incluam vários campos.

  1. Selecione Criar relação Sua lista de relações agora mostra a relação recém-criada.

    Captura de tela mostrando a relação recém-criada no painel gerenciar relações.

  2. Selecione o X no canto superior direito para fechar a tela Gerenciar relações .

Relações um para muitos (1:N) e muitos para muitos (M:N)

Para criar uma relação um-para-muitos (1:N), por exemplo, entre Product e Order, onde cada produto pode ser associado a vários pedidos, selecione Um para muitos como cardinalidade. Essa relação reflete a ideia de que um único produto pode ser vinculado a vários pedidos, mas cada pedido está vinculado a apenas um produto.

Para uma relação muitos-para-muitos (M:N), como entre Books e Authors, onde um livro pode ter vários autores e um autor pode ter vários livros, escolha Muitos para Muitos como a cardinalidade. Você precisa ter um tipo de vínculo em seu esquema para acomodar esse tipo de relacionamento.

A caixa de diálogo Novo relacionamento mostra outro conjunto de seletores quando você seleciona Muitos para muitos como cardinalidade. Por exemplo, em Livros e Autores, selecione um tipo de vinculação como BooksAuthors e campos como BookId e AuthorId como a vinculação de e para campos.

Captura de tela da nova caixa de diálogo para um relacionamento muitos para muitos.

Considerações para relações muitos para muitos

Se o tipo de vinculação tiver um ou mais campos que não são referenciados como Campo(s) ou Para campo(s), a API para GraphQL gerará automaticamente as seguintes quatro relações um-para-muitos:

  • Uma relação um-para-muitos do tipo De para o tipo de vínculo

  • Uma relação um-para-muitos do tipo de vínculo para o tipo De

  • Uma relação um-para-muitos do tipo Para para o tipo de vínculo

  • Uma relação um-para-muitos do tipo de vínculo para o tipo Para

Elas permitem que você faça referência aos campos desvinculados no tipo Vinculação em quaisquer consultas ou mutações e permitem que consultas ou mutações referenciem as relações em qualquer direção.

Se não houver campos desvinculados no Tipo de Vinculação, uma única relação muitos-para-muitos será criada, e consultas ou mutações não precisarão referenciar o Tipo de Vinculação para usar a relação.

Excluir um relacionamento

Exclua uma relação da tela Gerenciar relações selecionando a caixa de seleção ao lado da relação e selecionando Excluir.