Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 predeterminado 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 paginación es de 100 000. Esto significa que hay un número máximo fijo de elementos que una solicitud devolverá y que podrá recorrer en iteración. Si necesita devolver más de 100 000 elementos para la aplicación, emita varias solicitudes. Comprenda que este patrón no es común en 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.
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.
El tiempo de espera de la solicitud es actualmente de 100 segundos. Esto significa que si emite una solicitud que genera una consulta de fuente de datos que tarda más de 100 segundos en completarse, es posible que la solicitud falle y produzca un error.
La profundidad máxima de consulta admitida es 10. La profundidad de la consulta es el nivel de anidamiento de campos en una consulta, lo que puede afectar al rendimiento si es demasiado profundo debido a la recursividad potencial y la captura excesiva de datos.
Problemas conocidos
Para ver los problemas conocidos de la API de GraphQL, visite Problemas conocidos de Microsoft Fabric.