Trouvez les réponses aux questions fréquemment posées sur Fabric API pour GraphQL.
Qu’est-ce GraphQL ?
GraphQL est un langage de requête pour les API qui permet aux applications de demander exactement les données dont elles ont besoin. Les principaux avantages sont les suivants :
- Système de type fort - Décrit clairement les données disponibles
- Extraction de données précises - Réduit la sur-extraction en autorisant des requêtes spécifiques
- Compatibilité descendante : facilite les mises à jour d’API sans interrompre le code existant
- Rich tooling : permet l’utilisation d’un large ensemble de developer tools
Il s’agit d’un moyen plus efficace pour les applications de communiquer avec les serveurs et les bases de données.
Qu’est-ce que l’API Microsoft Fabric pour GraphQL ?
Microsoft Fabric’API pour GraphQL est un service managé qui vous permet de créer une API GraphQL en secondes.
Sources de données prises en charge :
- Microsoft Fabric Entrepôts de données
- Microsoft Fabric Lakehouses
- Bases de données mises en miroir de Microsoft Fabric
- bases de données SQL Microsoft Fabric
- bases de données Azure SQL
Il fournit une couche d’API unifiée pour interroger et muter des données à partir de ces sources de données prises en charge.
Quelles sont les opérations GraphQL prises en charge par Fabric API pour GraphQL ?
Seules les requêtes GraphQL (lecture) et les mutations (écriture) sont actuellement prises en charge. Les sources de données exposées via des points de terminaison analytiques SQL sont en lecture seule, ne prenant en charge que les requêtes. Pour les entrepôts de données, une clé primaire doit être définie pour que les mutations soient générées automatiquement.
Comment puis-je afficher et modifier des programmes de résolution dans l’API Fabric pour GraphQL ?
Les résolveurs sont des composants GraphQL qui fournissent la logique métier utilisée pour résoudre les champs dans l'API et effectuer des opérations avec des données résidant dans les sources de données.
Génération automatique : Fabric génère automatiquement des résolveurs chaque fois que vous attachez une nouvelle source de données ou sélectionnez de nouveaux objets à exposer à partir d’une source de données existante.
Personnalisation: Actuellement, il n’est pas possible de personnaliser directement les résolveurs. Pour une logique métier personnalisée dans l’API pour GraphQL, vous pouvez créer une procédure stockée dans la source de données et l’exposer dans l’API GraphQL.
L’API pour l’application cliente GraphQL nécessite-t-elle access à la source de données pour effectuer des requêtes ou des mutations ?
Microsoft Entra ID authentication : API pour GraphQL nécessite que les applications utilisent Microsoft Entra ID pour l’authentification. Votre application cliente doit être inscrite et configurée pour exécuter des appels d’API sur Fabric.
Autorisations requises :
- L’application inscrite dans Microsoft Entra nécessite des autorisations GraphQLApi.Execute.All pour le Power BI service. Pour plus d’informations, consultez Create a Microsoft Entra app in Azure.
configuration de l’authentification Single sign-on (SSO) : Si l’API est configurée pour utiliser l’authentification unique, l’utilisateur ou le principal de service authentifié nécessite un accès aux deux :
- L’API GraphQL (Autorisation Exécuter les requêtes et mutations )
- Source de données (accès en lecture ou en écriture si nécessaire)
Option d'accès au niveau de l'espace de travail : Affectez également l’utilisateur ou le principal de service en tant que membre de l’espace de travail avec un rôle contributeur où se trouvent à la fois l’API et les éléments de source de données. Cela donne les accès requis aux deux éléments depuis un emplacement unique. Pour plus d’informations, consultez Donner aux utilisateurs accès aux espaces de travail.
configuration des informations d’identification Saved credentials configuration : Si l’API est configurée pour utiliser les informations d’identification enregistrées, l’utilisateur ou le principal de service authentifié n’a besoin que de access à l’API (sélectionnez Exécuter les requêtes et mutations lors de l’ajout d’autorisations de access directes à l’API).
Exemples : Vous pouvez trouver un exemple de bout en bout avec du code d'exemple pour les principaux d'utilisateurs et principaux de service dans Connect Applications.
Comment puis-je ouvrir un ticket de support pour l'API GraphQL ?
Pour obtenir de l’aide de Microsoft Support sur tout problème lié à l’API Fabric pour GraphQL, visitez notre site de support Fabric et choisissez l’option Data Engineering.
L’API pour GraphQL prend-elle en charge Private Link ?
L'API pour GraphQL prend en charge uniquement le lien privé au niveau du locataire pour l'instant.
Pourquoi ma demande s’exécute-t-elle mal la première fois que je l’émets, puis s’exécute correctement sur les demandes suivantes ?
Il existe deux raisons principales pour ce comportement de « démarrage à froid » :
Préchauffement de la source de données :
- La première requête peut prendre plus de temps si une source de données doit être réchauffée à partir d’un état froid
- Même si la source de données n’est pas froide, la récupération de données peut ne pas être aussi efficace la première fois que GraphQL émet une requête si la source de données n’a pas les données nécessaires chargées en mémoire
Initialisation du point de terminaison d’API :
- La première requête adressée à un point de terminaison API pour GraphQL peut prendre plus de temps, car le système doit charger votre schéma et votre configuration
- Les requêtes suivantes sont plus rapides, car le système est déjà réchauffé et prêt à traiter vos demandes
Vous trouverez plus d’informations dans les meilleures pratiques en matière de performances.
Comment puis-je fournir des commentaires ou des suggestions pour l’API pour GraphQL ?
Nous vous invitons à nous faire part de vos commentaires et suggestions ! Vous pouvez fournir des commentaires par le biais de Idées de structure. Notre équipe surveille activement les commentaires et suggestions soumis via cette plateforme. Vous pouvez également nous contacter via Microsoft Fabric Support pour toutes les requêtes ou problèmes spécifiques.