Condividi tramite


Eseguire query su più origini dati nell'API infrastruttura per GraphQL

Nota

L'API Microsoft Fabric per GraphQL è disponibile in anteprima.

Nell'API fabric per GraphQL è possibile esporre molte origini dati tramite un singolo elemento API. Questa funzionalità consente di eseguire una singola query che recupera i dati in più origini dati.

Una query su più origini dati è una sequenza di query che usano operazioni su origini dati diverse.

Questa funzionalità può migliorare le prestazioni delle applicazioni riducendo il numero di round trip tra l'applicazione e l'API per GraphQL.

Nota

Una richiesta di origine dati multipla consente di inviare singole richieste alle origini dati. Non è possibile creare relazioni tra tipi che si estendono su più origini dati. Inoltre, non esistono garanzie sull'ordine in cui verranno eseguite le singole richieste.

Esempio di query

L'esempio seguente illustra una query che si estende su entrambe le origini dati ContosoSales e ContosoInventory :

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

Questa richiesta recupera il primo nodo dalla query dei clienti , derivata dall'origine dati ContosoSales e dal primo nodo dalla query di inventario, derivato dall'origine dati ContosoInventory .

L'output per la richiesta è:

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

L'output include due parti: la prima sezione "data" contiene l'output della query dei clienti . La seconda sezione , "inventari", contiene l'output della query di inventario .

Questo è l'aspetto della visualizzazione query durante l'esecuzione di questa richiesta:

Screenshot della schermata dell'editor, che mostra un esempio di query che si estende su due origini dati.