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. Usa un sistema de tipos seguro para describir claramente los datos disponibles, reduce la captura excesiva al permitir solicitudes precisas, facilita las actualizaciones de API sin interrumpir el código existente y 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 para acceder a los datos de los orígenes de datos, como Almacenes de datos de Microsoft Fabric, Microsoft Fabric Lakehouses bases de datos reflejadas de Microsoft Fabric, bases de datos SQL de Microsoft Fabric y 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. 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. Actualmente, no es posible personalizar solucionadores. Para la lógica de negocios personalizada en API para GraphQL, puede crear un procedimiento almacenado en el origen de datos y exponerlo en la API de GraphQL.
¿La API para la aplicación cliente de GraphQL necesita acceso al origen de datos para realizar consultas o mutaciones?
API para GraphQL requiere que las aplicaciones usen microsoft Entra ID para la autenticación. La aplicación cliente se debe registrar y configurar adecuadamente para ejecutar llamadas API en Fabric. 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. Además de Microsoft Entra, si la API está configurada para utilizar el inicio de sesión único (SSO), el usuario autenticado o el principal del servicio en la aplicación que llama a la API GraphQL requiere acceso tanto a la API GraphQL como a la fuente de datos. Más específicamente, ejecute el permiso Consultas y mutaciones en GraphQL API y el acceso de lectura o escritura necesarios en el origen de datos que prefiera en consecuencia. Otra opción es tener el usuario o la entidad de servicio como miembro del área de trabajo con un rol de colaborador de donde se encuentran tanto la API como los elementos de origen de datos, lo que 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. Como alternativa, si la API está configurada para usar credenciales guardadas, el usuario autenticado o la entidad de servicio solo necesita tener acceso a la API (seleccione opción Ejecutar consultas y mutaciones al agregar permisos de acceso directo a la API). Puede encontrar un ejemplo completo con código de ejemplo para entidades de seguridad 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.
¿Qué regiones aún no son compatibles con la API para GraphQL?
Actualmente, la API para GraphQL no se admite en la región Oeste de EE. UU. 3.
¿Admite API para GraphQL Private Link?
La API para GraphQL no admite Private Link en este momento. Sin embargo, estamos planeando admitir esta característica en el futuro y proporcionaremos actualizaciones a medida que estén disponibles.
He habilitado Private Link para mi inquilino de Fabric. ¿Por qué mis elementos de GraphQL no funcionan?
Si la configuración del inquilino "Bloquear el acceso público a Internet" está habilitada (es decir, el acceso público está deshabilitado), los artefactos o elementos no admitidos se deshabilitan automáticamente, incluida la API para GraphQL. Esto significa que no se puede acceder a los elementos creados previamente, ni se pueden crear nuevos. La única manera de acceder a estos elementos es permitir el acceso público.
¿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. En primer lugar, la primera solicitud puede tardar más tiempo si es necesario preparar un origen de datos si es frío. Incluso si el origen de datos no está en frío, es posible que la recuperación de datos no sea tan eficaz la primera vez que GraphQL emite una consulta, si el origen de datos no tiene los datos necesarios cargados en memoria. La segunda razón es que la primera solicitud a una API para el punto de conexión de GraphQL puede tardar más porque el sistema debe cargar el esquema y la configuración para estar listo para aceptar solicitudes. Este es un costo único y las solicitudes posteriores son más rápidas porque el sistema ya está preparado y listo para atender sus solicitudes.
¿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.