Preguntas frecuentes sobre la API de Fabric para GraphQL

GraphQL es un lenguaje de consulta para las API que permite a las aplicaciones solicitar exactamente los datos que necesitan. Entre las ventajas clave se incluyen las siguientes:

• Sistema de tipos fuerte - Describe claramente los datos disponibles
• Captura precisa de datos : reduce la captura excesiva al permitir solicitudes específicas.
• Compatibilidad con versiones anteriores : facilita las actualizaciones de API sin interrumpir el código existente
• Rich tooling - habilita el uso de un amplio conjunto de herramientas de desarrollo.

Es una manera más eficaz de que las aplicaciones se comuniquen con servidores y bases de datos.

Microsoft Fabric API para GraphQL es un servicio administrado que permite crear una API de GraphQL en segundos.

Orígenes de datos admitidos:

• almacenamientos de datos de Microsoft Fabric
• Microsoft Fabric Lakehouses
• Microsoft Fabric bases de datos en espejo
• bases de datos SQL de Microsoft Fabric
• bases de datos de Azure SQL

Proporciona una capa de API unificada para consultar y mutar datos de estos orígenes de datos admitidos.

En este momento solo se admiten las consultas de GraphQL (lectura) y las mutaciones (escritura). Los orígenes de datos expuestos a través de endpoints de SQL Analytics son de solo lectura, por lo que únicamente admiten consultas. En el caso de los almacenamientos de datos, es necesario definir una clave principal para que se generen automáticamente las mutaciones.

Los solucionadores son componentes de GraphQL que proporcionan lógica de negocios para resolver campos en la API y realizar operaciones con datos que residen en los orígenes de datos.

Generación automática: Fabric genera automáticamente resoluciones cada vez que se adjunta un nuevo origen de datos o se seleccionan nuevos objetos que se van a exponer desde un origen de datos existente.

Personalización: Actualmente, no es posible personalizar los solucionadores directamente. Para la lógica de negocios personalizada en API para GraphQL, puede crear un procedimiento almacenado en el origen de datos y exponerlo en GraphQL API.

Microsoft Entra ID authentication: API para GraphQL requiere que las aplicaciones usen Microsoft Entra ID para la autenticación. La aplicación cliente debe estar registrada y configurada para ejecutar llamadas API en Fabric.

Permisos necesarios:

• La aplicación registrada en Microsoft Entra requiere permisos GraphQLApi.Execute.All para el Power BI service. Para obtener más información, consulte Crear una aplicación de Microsoft Entra en Azure.

Configuración de inicio de sesión único (SSO): Si la API está configurada para usar SSO, el usuario autenticado o el principal del servicio requiere acceso a ambos:

• GraphQL API (permiso Ejecutar consultas y mutaciones )
• Origen de datos (acceso de lectura o escritura según sea necesario)

Opción de acceso a nivel de espacio de trabajo: También puede asignar al usuario o al principal de servicio como miembro del área de trabajo con un rol de colaborador donde se encuentran tanto la API como los elementos de origen de datos. Esto proporciona el acceso necesario a ambos elementos desde un solo lugar. Para obtener más información, consulte Dar acceso a los usuarios a las áreas de trabajo.

Configuración de credenciales guardadas: Si la API está configurada para usar credenciales guardadas, el usuario autenticado o la entidad de servicio solo necesita acceso a la API (seleccione Ejecutar consultas y mutaciones al agregar permisos de acceso directo a la API).

Ejemplos: Puede encontrar un ejemplo de extremo a extremo con código de ejemplo para principales de usuario y entidades de servicio en Connect Applications.

Para obtener ayuda de Microsoft Support sobre cualquier problema relacionado con Fabric API for GraphQL, visite nuestro sitio de soporte técnico Fabric y elija la opción Ingeniería de datos.

API para GraphQL solo admite Tenant Level Private Link en este momento.

Hay dos razones principales para este comportamiento de "arranque en frío":

Preparación del origen de datos:

• La primera solicitud podría tardar más tiempo si es necesario activar una fuente de datos desde un estado inactivo.
• Aunque el origen de datos no esté en frío, la recuperación de datos podría no ser tan eficiente la primera vez que GraphQL ejecuta una consulta si el origen de datos no tiene los datos necesarios cargados en memoria.

Inicialización del punto de conexión de API:

• La primera solicitud a un punto de conexión de API para GraphQL puede tardar más porque el sistema debe cargar el esquema y la configuración.
• Las solicitudes posteriores son más rápidas porque el sistema ya está preparado para atender las solicitudes.

Puede encontrar más información en los procedimientos recomendados de rendimiento.

¡Agradecemos sus comentarios y sugerencias! Puede proporcionar comentarios a través de Fabric Ideas. Nuestro equipo supervisa activamente los comentarios y sugerencias enviados a través de esta plataforma. También puede ponerse en contacto con nosotros a través del soporte de Microsoft Fabric para cualquier consulta o inquietud específica.

Contenido relacionado

¿Qué es Microsoft Fabric API para GraphQL?