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.

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 des entrepôts de données Microsoft Fabric, des lakehouses Microsoft Fabric, des bases de données en miroir Microsoft Fabric, des bases de données SQL Microsoft Fabric et des 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. 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 exécuter des appels d’API sur Fabric. L’application inscrite dans Microsoft Entra nécessite des autorisations Item.Execute.All pour le service Power BI. Pour plus d’informations, consultez Créer une application Microsoft Entra dans Azure. En plus de Microsoft Entra, si l’API est configurée pour utiliser l’authentification unique (SSO), l’utilisateur ou le principal de service authentifié dans l’application appelant l’API GraphQL doit avoir accès à l’API GraphQL et à la source de données. Plus précisément, il s’agit de l’autorisation Exécuter des requêtes et des mutations dans l’API GraphQL et de l’autorisation d’accès en lecture ou en écriture à la source de données choisie. Une autre option consiste à faire de l’utilisateur ou du principal de service un membre de l’espace de travail avec un rôle de contributeur où se trouvent les éléments de l’API et de la source de données, ce qui fournit l’accès requis aux deux éléments à partir d’un même emplacement. Pour plus d’informations, consultez Accorder aux utilisateurs l’accès aux espaces de travail. Sinon, si l’API est configurée pour utiliser les informations d’identification enregistrées, l’utilisateur ou le principal de service authentifié doit simplement avoir accès à l’API (Sélectionnez Exécuter des requêtes et mutations option lors de l’ajout d’autorisations d’accès direct à l’API). Vous trouverez un exemple de bout en bout avec des exemples de code pour les principaux d’utilisateur et les principaux de service dans Connecter des 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.

Quelles régions ne sont pas encore prises en charge par l’API pour GraphQL ?

L’API pour GraphQL n’est actuellement pas prise en charge dans la région USA Ouest 3.