Encuentre respuestas a las preguntas frecuentes sobre la API de Fabric para GraphQL.
¿Qué es 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
- Herramientas enriquecidas : permite 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.
¿Qué es la API de Microsoft Fabric para GraphQL?
La API de Microsoft Fabric 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
- Bases de datos espejo de Microsoft Fabric
- 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.
¿Qué operaciones de GraphQL se admiten en la API de Fabric para GraphQL?
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 puntos de conexión de SQL Analytics son de solo lectura, por lo que solo admiten consultas. En el caso de los almacenamientos de datos, es necesario definir una clave principal para que se generen automáticamente las mutaciones.
¿Cómo se puede ver y editar solucionadores en API de Fabric para GraphQL?
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.
¿La API para la aplicación cliente de GraphQL necesita acceso al origen de datos para realizar consultas o mutaciones?
Autenticación de Microsoft Entra ID: 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 de GraphQLApi.Execute.All para el servicio Power BI. Para obtener más información, vea Crear una aplicación de Microsoft Entra en Azure.
Configuración del inicio de sesión único (SSO): Si la API está configurada para usar el inicio de sesión único, el usuario autenticado o la entidad de 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 de nivel de área de trabajo: Como alternativa, asigne el usuario o la entidad 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 más información, consulte Proporcionar acceso a los usuarios a las áreas de trabajo en Power BI.
Configuración de credenciales guardadas: Si la API está configurada para usar credenciales guardadas, el usuario autenticado o la entidad de servicio solo necesitan acceso a la API (seleccione la opción 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.
¿Cómo abrir una incidencia de soporte técnico para API para GraphQL?
Para obtener ayuda de Soporte técnico de Microsoft sobre cualquier problema relacionado con API de Fabric para GraphQL, visite nuestro sitio de soporte técnico de Fabric y elija la opción de Ingeniero de datos.
¿Admite API para GraphQL Private Link?
La API para GraphQL no admite Private Link en este momento.
¿Por qué mi solicitud funciona mal la primera vez que la emito y luego funciona bien en las solicitudes posteriores?
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.
¿Cómo puedo proporcionar comentarios o sugerencias para API para GraphQL?
¡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 de soporte técnico de Microsoft Fabric para cualquier consulta o preocupación específica.