Administración de relaciones en Fabric API para GraphQL

Nota:

La API de Microsoft Fabric para GraphQL está en versión preliminar.

Una de las características más eficaces de GraphQL es la capacidad de establecer relaciones entre tipos, incluida la compatibilidad con relaciones uno a uno (1:1), uno a varios (1:N) y relaciones de varios a varios (M:N).

Crear nueva relación uno a uno (1:1)

1. En el panel Explorador de esquemas, seleccione los puntos suspensivos situados junto a un tipo y seleccione la opción Administrar relaciones. Aparece la pantalla Administrar relaciones.

   

2. Seleccione Nueva relación. En este ejemplo, creamos una nueva relación uno a uno entre el tipo Product y el tipo ProductModel, en función del campo ProductModelID que existe en ambos tipos. Seleccionamos Uno a uno para Cardinalidad, seleccionamos los tipos Origen y Destino y, a continuación, seleccionamos los campos Origen y Destino para esta relación.

   

   Nota:

   Puede elegir varios campos en los selectores de campos Origen y Destino. Esta característica permite crear relaciones que comprenden varios campos.

3. Seleccione la Crear relación. La lista de relaciones ahora muestra la relación recién creada.

   

4. Seleccione la X en la esquina superior derecha para cerrar la pantalla Administrar relaciones.

Relaciones de uno a varios (1:N) y entre varios (M:N)

Para crear una relación de uno a varios (1:N), por ejemplo, entre Producto y Pedido, donde cada producto se puede asociar a varios pedidos, seleccione Uno a varios como cardinalidad. Esta relación refleja la idea de que un único producto se puede vincular a varios pedidos, pero cada pedido está vinculado a un solo producto.

Para una relación de varios a varios (M:N), como entre Books y Authors, donde un libro puede tener varios autores y un autor puede tener varios libros, elija Entre varios como la cardinalidad. Debe tener un tipo de vinculación en el esquema para dar cabida a este tipo de relación.

El cuadro de diálogo Nueva relación muestra otro conjunto de selectores al elegir Entre varios como cardinalidad. En el ejemplo de Books y Authors, seleccionaría un tipo de vinculación como BooksAuthors y campos como BookId y AuthorId como la vinculación de y a los campos.

Aspectos a tener en cuenta en relaciones de varios a varios

Si el tipo de vinculación contiene uno o varios campos a los que no se hace referencia como Campos de origen o Campos de destino, API para GraphQL genera automáticamente cuatro relaciones de uno a varios, como se indica a continuación:

• Relación uno a varios del tipo de origen al tipo de vínculo
• Relación uno a varios del tipo de vínculo al tipo de origen
• Relación uno a varios del tipo de destino al tipo de vínculo
• Relación uno a varios del tipo de vínculo al tipo de destino

Estos le permiten hacer referencia a los campos desvinculados del tipo de vínculo en cualquier consulta o mutación, al tiempo que permiten consultas o mutaciones que hacen referencia a las relaciones en cualquier dirección.

En el caso de que no haya campos desvinculados en el tipo de vínculo, se creará una única relación de varios a varios y las consultas o mutaciones no tendrán que hacer referencia al tipo de vínculo para sacar provecho de la relación.

Eliminar una relación

Puede eliminar una relación de la pantalla Administrar relaciones activando la casilla situada junto a la relación y seleccionando Eliminar.

Contenido relacionado

• Editor de la API de Fabric para GraphQL