Limitations de l’API Microsoft Fabric pour GraphQL
Cet article détaille les limitations actuelles de l’API Microsoft Fabric pour GraphQL.
Limitations
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 constamment l’API pour GraphQL avec de nouvelles fonctionnalités. Pour plus d'informations sur l'avenir de Microsoft Fabric, consultez Feuille de route Fabric.
- Toute source de données qui tire parti d’un point de terminaison SQL Analytics pour l’accès prend uniquement en charge les opérations de lecture sur celle-ci. Par exemple, les mutations ne sont pas disponibles pour les Lakehouses ou les bases de données mises en miroir.
- La taille de page par défaut actuelle est 100, ce qui signifie que chaque requête retourne un maximum de 100 éléments dans la réponse. Si votre jeu de résultats est supérieur à 100, effectuez une itération dans les résultats à l’aide de la pagination GraphQL.
- La taille maximale de pagination est de 100 000. Cela signifie qu’il existe un nombre maximal fixe d’éléments qu’une requête retourne et que vous pouvez effectuer une itération. Si vous devez retourner plus de 100 000 éléments pour votre application, émettez plusieurs demandes. Comprenez que ce modèle n’est pas courant dans GraphQL.
- La taille de réponse maximale prise en charge est de 64 Mo. Cela signifie que toute demande d’API dont la taille de réponse est supérieure à 64 Mo retourne une erreur. Pour contourner cette limitation, vous pouvez émettre plusieurs demandes filtrées.
- Limitations des procédures stockées (s’applique à Azure SQL, SQL Database dans Fabric et Data Warehouses) :
- Seul le premier jeu de résultats retourné par la procédure stockée est utilisé par l’API pour GraphQL.
- Seules les procédures stockées dont les métadonnées pour le premier jeu de résultats décrit par sys.dm_exec_describe_first_result_set sont prises en charge.
- Lorsqu’un paramètre de procédure stockée est spécifié à la fois dans le fichier de configuration et dans la chaîne de requête d’URL, le paramètre de la chaîne de requête d’URL est prioritaire.
- Les entités sauvegardées par une procédure stockée ne disposent pas de toutes les fonctionnalités automatiquement fournies pour les entités sauvegardées par des tables ou des vues.
- Les entités basées sur des procédures stockées ne prennent pas en charge la pagination, le tri ou le filtrage. De même, ces entités ne permettent pas le retour d’éléments spécifiés par les valeurs de clé primaire.
- Le délai d’expiration de la demande est actuellement de 100 secondes. Cela signifie que si vous envoyez une requête qui génère une interrogation de la source de données prenant plus de 100 secondes pour se terminer, votre requête pourrait échouer.
Problèmes connus
Pour connaître les problèmes connus dans l’API pour GraphQL, visitez Problèmes connus de Microsoft Fabric.