Partager via


Interroger plusieurs sources de données dans l’API Fabric pour GraphQL

Remarque

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

Dans l’API Fabric pour GraphQL, vous pouvez exposer de nombreuses sources de données via un seul article d’API. Cette fonctionnalité vous permet d’émettre une requête unique qui récupère des données sur plusieurs sources de données.

Une requête de source de données multiples est une séquence de requêtes qui utilisent des opérations sur différentes sources de données.

Cette fonctionnalité peut améliorer les performances de vos applications en réduisant le nombre d’allers-retours entre votre application et l’API pour GraphQL.

Remarque

Une demande de source de données multiples a pour conséquence d’extraire les demandes individuelles adressées aux sources de données. Vous ne pouvez pas créer de relations entre les types qui s’étendent sur plusieurs sources de données. En outre, il n’existe aucune garantie sur l’ordre que les demandes individuelles s’exécuteront.

Exemple de requête

L’exemple suivant montre une requête qui s’étend sur les sources de données ContosoSales et ContosoInventory :

query {
  customers (first: 1) {
    items {
      FirstName
      LastName
    }
  }
  inventories (first: 1) {
    items {
      Name
    }
  }
}

Cette requête récupère le premier nœud de la requête clients, qui est dérivée de la source de données ContosoSales, et le premier nœud de la requête inventaires, qui est dérivé de la source de données ContosoInventory.

Le résultat de la requête est le suivant :

{
  "data": {
    "customers": {
      "items": [
        {
          "FirstName": "Orlando",
          "LastName": "Gee"
        }
      ]
    },
    "inventories": {
      "items": [
        {
          "Name": "AWC Logo Cap"
        }
      ]
    }
  }
}

le résultat comprend deux parties : la première section, « données », contient le résultat de la requête des clients. La deuxième section, « inventaires », contient le résultat de la requête inventaires.

Voici à quoi ressemble l’affichage des requêtes lors de l’exécution de cette requête :

Capture d’écran de l’éditeur montrant un exemple de requête qui s’étend sur deux sources de données.