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.
Las limitaciones actuales del producto general para API para GraphQL en Microsoft Fabric se enumeran en este artículo. Estamos mejorando continuamente la API para GraphQL con nuevas características. Para obtener más información sobre el futuro de Microsoft Fabric, vea Fabric Roadmap.
Quién necesita comprender las limitaciones
Comprender las limitaciones de GraphQL API es fundamental para:
- Desarrolladores de aplicaciones que diseñan aplicaciones que funcionan dentro de las restricciones de la API de GraphQL de Fabric
- Ingenieros de datos que planean estrategias de exposición de datos y comprensión de los límites de la plataforma
- Arquitectos de soluciones que definen el alcance de las soluciones basadas en Fabric y establecen las expectativas técnicas adecuadas
- Colaboradores del área de trabajo de Fabric solucionan problemas e implementan soluciones alternativas para las limitaciones actuales
- Administradores de proyectos que comunican las restricciones de la plataforma fabric a las partes interesadas durante el planeamiento del proyecto
Revise estas limitaciones al planear implementaciones de GraphQL API o solucionar problemas de comportamiento inesperado de la API.
Operaciones de origen de datos
Los orígenes de datos de los endpoints de SQL Analytics solo admiten operaciones de lectura. Los orígenes de datos a los que se accede a través de puntos de conexión de SQL Analytics (como Lakehouses y bases de datos reflejadas) no admiten mutaciones. Puede consultar datos, pero no puede crear, actualizar ni eliminar registros a través de GraphQL API.
Límites de tamaño y rendimiento
En la tabla siguiente se resumen las restricciones de tamaño de clave, paginación y rendimiento:
| Tipo de límite | Importancia | Description | Solución |
|---|---|---|---|
| Tamaño de página predeterminado | 100 elementos | Número máximo de elementos devueltos por solicitud de forma predeterminada | Uso de la paginación de GraphQL para recorrer en iteración conjuntos de resultados más grandes |
| Tamaño máximo de paginación | 100 000 elementos | Número máximo de elementos totales que se pueden recuperar a través de la paginación | Emita varias solicitudes filtradas si necesita más de 100 000 elementos (patrón poco común en GraphQL) |
| Tamaño máximo de respuesta | 64 MB | Tamaño máximo de la carga de respuesta de API | Emitir varias solicitudes filtradas para recuperar datos en fragmentos más pequeños |
| Tiempo de espera de solicitud | 100 segundos | Tiempo máximo de ejecución para una sola solicitud | Optimización de consultas o interrupción de operaciones complejas en solicitudes más pequeñas |
| Profundidad máxima de consulta | 10 niveles | Nivel máximo de anidamiento de campos en una consulta | Reducir el anidamiento de consultas para evitar problemas de rendimiento de la captura excesiva de datos |
Limitaciones de los procedimientos almacenados
Los procedimientos almacenados en Azure SQL, SQL Database in Fabric y Data Warehouse tienen restricciones específicas:
- Control de conjuntos de resultados: solo se usa el primer conjunto de resultados devuelto por el procedimiento almacenado. No se admiten varios conjuntos de resultados.
-
Requisitos de metadatos: solo se admiten procedimientos almacenados cuyos metadatos del primer conjunto de resultados pueden describirse.
sys.dm_exec_describe_first_result_set - Precedencia de parámetros: cuando se especifica un parámetro de procedimiento almacenado tanto en el archivo de configuración como en la cadena de consulta de dirección URL, el valor de la cadena de consulta url tiene prioridad.
-
Características limitadas de GraphQL: las entidades respaldadas por procedimientos almacenados han reducido las funcionalidades en comparación con las entidades respaldadas por tablas o vistas:
- Soporte para la paginación no está disponible
- Sin ordenación ni filtrado
- No hay búsquedas basadas en claves principales
Problemas conocidos
Para ver los problemas conocidos de la API de GraphQL, visite Problemas conocidos de Microsoft Fabric.