Encuentre respuestas a las preguntas frecuentes sobre la API de Fabric para GraphQL.
¿Qué es GraphQL?
GraphQL es un lenguaje de consulta de código abierto para las API y un runtime para satisfacer esas consultas con los datos existentes. GraphQL proporciona una descripción completa y comprensible de los datos de la API con un sistema fuertemente tipado, ofrece a los clientes la capacidad de pedir exactamente lo que necesitan, ni más ni menos, facilita la evolución de las API con el paso del tiempo y habilita herramientas de desarrollo eficaces.
¿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. La API de Fabric para GraphQL está actualmente en versión preliminar.
¿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 las mutaciones se generen automáticamente.
¿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?
La API para GraphQL requiere que las aplicaciones utilicen Microsoft Entra 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 necesita los permisos Item.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 consiste en tener 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, lo que proporcionará el acceso necesario a ambos elementos desde un único 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 (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.