Compartir vía

Vista de esquema y explorador de esquemas de la API de Fabric para GraphQL

  • Artículo

Nota:

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

El esquema de GraphQL, que se basa en el lenguaje de definición de esquemas (SDL) de GraphQL, define el formato de los datos expuestos en la API. Es una capa de abstracción que proporciona flexibilidad a los consumidores y, al mismo tiempo, oculta los detalles de implementación de back-end. El esquema se basa en una colección de tipos de objeto que contienen campos.

Vista de esquema

Para acceder a la vista de esquema, seleccione Esquema en la esquina inferior izquierda de la pantalla Desarrollo de datos. La vista muestra una versión basada en texto del SDL de GraphQL con tipos, campos y operaciones generados.

La imagen siguiente es un ejemplo de la vista de esquema, incluida una lista extensa de objetos disponibles en este esquema.

Nota:

La vista de esquema es de solo lectura. Solo puede modificar objetos en el Explorador de esquemas.

Captura de pantalla de la pantalla de vista de esquema de API, que incluye el Explorador de esquemas en el panel izquierdo.

Explorador de esquemas

El Explorador de esquemas se encuentra en el panel de la izquierda y también está disponible cuando se usa el editor en la vista de consulta. El explorador permite a los usuarios visualizar rápidamente los tipos y campos disponibles, así como consultas y mutaciones, definidos en la API.

Todos los tipos de GraphQL que están disponibles en los objetos que elija al conectarse a un origen de datos aparecen en la lista Explorador de esquemas. Los tipos aparecen bajo el nombre del origen de datos desde el que se derivaron. En la imagen siguiente, verá el tipo SalesOrderDetail derivado de la tabla SalesOrderDetail en el punto de conexión de Análisis SQL de AdventureWorks.

Captura de pantalla del panel Explorador de esquemas que muestra la lista expandida de tipos disponibles en un origen de datos de ejemplo denominado SalesOrderDetail.

Además de los tipos, la API de Fabric para GraphQL genera automáticamente consultas y mutaciones para los nuevos objetos que elija exponer.

En nuestro ejemplo de AdventureWorks, al expandir la lista de consultas se muestran las consultas generadas automáticamente para el origen de datos.

Captura de pantalla del panel Explorador de esquemas, en la que se muestra una lista expandida de consultas generadas de forma automática.

Para ver las mutaciones generadas de forma automática por la API, expanda el nodo de mutaciones en el árbol del Explorador de esquemas.

Captura de pantalla del panel Explorador de esquemas, en la que se muestra una lista expandida de mutaciones generadas de forma automática.

Modificación de objetos mediante el Explorador de esquemas

Puede utilizar el Explorador de esquemas para modificar objetos después de que la API los cree. En el ejemplo siguiente, seleccionamos los puntos suspensivos junto al tipo SalesOrderDetail derivado de nuestra base de datos AdventureWorks:

Captura de pantalla del explorador de esquemas con los puntos suspensivos seleccionados, en la que se muestran las opciones de menú disponibles.

Están disponibles las opciones siguientes:

  • Actualizar esquema: permite actualizar el esquema con nuevos objetos del origen de datos.
  • Cambiar nombre: cambia el nombre del objeto. NOTA: Este cambio solo afecta al esquema de API y no tiene ningún efecto en el objeto de origen de datos original del que se ha derivado.
  • Quitar del esquema: elimina eficazmente el objeto del esquema GraphQL para que ya no pueda hacer referencia a él.
  • Administrar relaciones: le lleva a la experiencia de administración de relaciones. Para más información, consulte Administrar relaciones en la API de Fabric para GraphQL.
  • Propiedades: muestra información adicional sobre el objeto.

Contenido relacionado