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
- Outils enrichis - Permet l’utilisation d’un large ensemble d’outils de développement
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 ?
L’API Microsoft Fabric pour GraphQL est un service managé qui vous permet de créer une API GraphQL en secondes.
Sources de données prises en charge :
- Entrepôts de données Microsoft Fabric
- Entrepôts de données Microsoft Fabric
- Bases de données mises en miroir Microsoft Fabric
- Bases de données MICROSOFT Fabric SQL
- Bases de données SQL Azure
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 programmes de résolution sont des composants GraphQL qui fournissent la logique métier utilisée pour résoudre les champs dans GraphQL 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 l’accès à la source de données pour effectuer des requêtes ou des mutations ?
Authentification microsoft Entra ID : L’API pour GraphQL nécessite que les applications utilisent l’ID Microsoft Entra 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 l’autorisation GraphQLApi.Execute.All pour le service Power BI. Pour plus d’informations, consultez Créer une application Microsoft Entra dans Azure.
Configuration de l’authentification unique (SSO) : Si l’API est configurée pour utiliser l’authentification unique, l’utilisateur ou le principal de service authentifié nécessite l’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 : Vous pouvez également affecter 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 l’accès requis aux deux éléments à partir d’un emplacement unique. Pour plus d’informations, consultez Accorder aux utilisateurs l’accès aux espaces de travail.
Configuration des informations d’identification enregistrées : Si l’API est configurée pour utiliser les informations d’identification enregistrées, l’utilisateur ou le principal de service authentifié doit uniquement accéder à l’API (sélectionnez Exécuter des requêtes et mutations lors de l’ajout d’autorisations d’accès direct à 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 faire ouvrir un ticket de support pour l’API pour GraphQL ?
Pour obtenir de l’aide de Support Microsoft sur tout problème lié à l’API Fabric pour GraphQL, visitez notre site de support Fabric et choisissez l’option Ingénieurs Données.
L’API pour GraphQL prend-elle en charge Private Link ?
L’API pour GraphQL ne prend pas en charge Private Link 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 support Microsoft Fabric pour toutes les requêtes ou préoccupations spécifiques.