Compartir a través de


Limitaciones de la API de Microsoft Fabric para GraphQL

En este artículo se detallan las limitaciones actuales de Microsoft Fabric API para GraphQL.

Limitaciones

Las limitaciones actuales del producto general para API para GraphQL en Microsoft Fabric se enumeran en este artículo. Estamos mejorando constantemente la API para GraphQL con nuevas características. Para obtener más información sobre el futuro de Microsoft Fabric, vea Fabric Roadmap.

  • Cualquier origen de datos que aproveche un punto de conexión de SQL Analytics para el acceso solo admite operaciones de lectura en él. Por ejemplo, las mutaciones no están disponibles para lagos de datos o bases de datos reflejadas.
  • El tamaño de página máximo actual es 100, lo que significa que cada solicitud devolverá un máximo de 100 elementos en la respuesta. Si el conjunto de resultados es mayor que 100, recorra en iteración los resultados mediante la paginación de GraphQL.
  • El tamaño máximo de respuesta que se admite es de 64 MB. Esto significa que cualquier solicitud de API con un tamaño de respuesta mayor que 64 MB devuelve un error. Para solucionar esta limitación, puede emitir varias solicitudes filtradas o usar la paginación.
  • Limitaciones de los procedimientos almacenados (se aplica a Azure SQL, SQL Database en Fabric y almacenes de datos):
    • La API usa solo el primer conjunto de resultados devuelto por el procedimiento almacenado para GraphQL.
    • Solo se admiten los procedimientos almacenados cuyos metadatos para el primer conjunto de resultados se describen en sys.dm_exec_describe_first_result_set.
    • Cuando se especifica un parámetro de procedimiento almacenado en el archivo de configuración y en la cadena de consulta url, el parámetro de la cadena de consulta url tiene prioridad.
    • Las entidades respaldadas por un procedimiento almacenado no tienen todas las funcionalidades proporcionadas automáticamente para las entidades respaldadas por tablas o vistas.
    • Las entidades respaldadas por procedimientos almacenados no admiten paginación, ordenación ni filtrado. Tampoco son estas entidades las que admiten la devolución de elementos especificados por valores de clave principal.

Problemas conocidos

Para ver los problemas conocidos de la API de GraphQL, visite Problemas conocidos de Microsoft Fabric.