Modifier

Partager via


Fabric API pour GraphQL : questions fréquemment posées

Trouvez les réponses aux questions fréquemment posées sur Fabric API pour GraphQL.

Remarque

L’API Microsoft Fabric pour GraphQL est en aperçu.

Qu’est-ce GraphQL ?

GraphQL est un langage de requête open source pour les API et un runtime pour répondre à ces requêtes avec vos données existantes. GraphQL fournit une description complète et compréhensible des données dans votre API avec un système fortement typé, offre aux clients la possibilité de demander exactement ce dont ils ont besoin et rien de plus, facilite l’évolution des API au fil du temps et permet d’utiliser de puissants outils de développement.

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 quelques secondes pour accéder aux données à partir de vos sources de données telles que les entrepôts de données Microsoft Fabric, les lakehouses Microsoft Fabric et les bases de données mises en miroir Microsoft Fabric. 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. L’API Fabric pour GraphQL est actuellement en préversion.

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 ce qui est des 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. Fabric génère automatiquement des programmes de résolution 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. Actuellement, il n’est pas possible de personnaliser 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 ?

L’API pour GraphQL nécessite que les applications utilisent Microsoft Entra pour l’authentification. Votre application cliente doit être inscrite et configurée de manière appropriée pour effectuer des appels d’API à partir de Fabric. L’application inscrite dans Entra nécessite les autorisations d’API Item.Execute.All et Datamart.ReadWrite.All pour le service Power BI (Important : les étendues peuvent changer pendant la préversion publique). Pour plus d’informations, consultez Créer une application Microsoft Entra dans Azure. En plus d’Entra, l’utilisateur authentifié appelant l’API GraphQL dans l’application doit être membre de l’espace de travail où se trouvent à la fois l’API et les éléments de source de données avec un rôle Collaborateur. Pour plus d’informations, consultez Accorder aux utilisateurs l’accès aux espaces de travail. Les principaux de service ne sont actuellement pas pris en charge. Vous trouverez un exemple de bout en bout avec un exemple de code sur 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.