Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les limitations générales actuelles des produits pour l’API pour GraphQL dans Microsoft Fabric sont répertoriées dans cet article. Nous améliorons continuellement l’API pour GraphQL avec de nouvelles fonctionnalités. Pour plus d'informations sur l'avenir de Microsoft Fabric, consultez Feuille de route Fabric.
Qui doit comprendre les limitations
Comprendre les limitations de l’API GraphQL est cruciale pour :
- Développeurs d’applications qui conçoivent des applications qui fonctionnent dans des contraintes d’API Fabric GraphQL
- Les ingénieurs données planifient des stratégies d’exposition des données et comprennent les limites de la plateforme
- Les architectes de solutions définissent des solutions basées sur Fabric et définissent des attentes techniques appropriées
- Contributeurs d’espaces de travail Fabric qui résolvent les problèmes et implémentent des solutions de contournement pour les limitations actuelles
- Responsables de projets qui communiquent les contraintes de plateforme Fabric aux parties prenantes lors de la planification du projet
Passez en revue ces limitations lors de la planification des implémentations d’API GraphQL ou de la résolution des problèmes de comportement d’API inattendu.
Opérations de source de données
Les sources de données de point de terminaison SQL Analytics prennent uniquement en charge les opérations de lecture. Les sources de données accessibles via des points de terminaison SQL Analytics (tels que les entrepôts de données et les bases de données mises en miroir) ne prennent pas en charge les modifications. Vous pouvez interroger des données, mais pas créer, mettre à jour ou supprimer des enregistrements via l’API GraphQL.
Limites de taille et de performances
Le tableau suivant récapitule la taille de clé, la pagination et les contraintes de performances :
| Type de limite | Valeur | Descriptif | Contournement |
|---|---|---|---|
| Taille de page par défaut | 100 éléments | Nombre maximal d’éléments retournés par requête par défaut | Utiliser la pagination GraphQL pour itérer dans des jeux de résultats plus volumineux |
| Taille de pagination maximale | 100 000 éléments | Nombre maximal d’éléments pouvant être récupérés via la pagination | Émettre plusieurs requêtes filtrées si vous avez besoin de plus de 100 000 éléments (modèle rare dans GraphQL) |
| Taille maximale de la réponse | 64 Mo | Taille maximale de la charge utile de réponse de l’API | Émettre plusieurs requêtes filtrées pour récupérer des données en blocs plus petits |
| Délai d’expiration de la demande | 100 secondes | Durée d’exécution maximale pour une requête unique | Optimiser les requêtes ou interrompre les opérations complexes en requêtes plus petites |
| Profondeur maximale de requête | 10 niveaux | Niveau d’imbrication maximal de champs dans une requête | Réduire l’imbrication des requêtes pour éviter les problèmes de performances d’extraction excessive de données |
Limitations de procédure stockée
Les procédures stockées dans Azure SQL, SQL Database dans Fabric et Data Warehouses ont des contraintes spécifiques :
- Gestion du jeu de résultats : seul le premier jeu de résultats retourné par la procédure stockée est utilisé. Plusieurs jeux de résultats ne sont pas pris en charge.
-
Exigences relatives aux métadonnées : seules les procédures stockées dont les métadonnées du premier ensemble de résultats peuvent être décrites par
sys.dm_exec_describe_first_result_setsont prises en charge. - Priorité des paramètres : lorsqu’un paramètre de procédure stockée est spécifié dans le fichier de configuration et la chaîne de requête URL, la valeur de la chaîne de requête d’URL est prioritaire.
-
Fonctionnalités GraphQL limitées : les entités sauvegardées par des procédures stockées ont des fonctionnalités réduites par rapport aux entités de table ou d’affichage :
- Aucune prise en charge de la pagination
- Aucun tri ni filtrage
- Aucune recherche basée sur une clé primaire
Problèmes connus
Pour connaître les problèmes connus dans l’API pour GraphQL, visitez Problèmes connus de Microsoft Fabric.