Condividi tramite


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

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 effettua il fan-out di 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 clienti, derivata dall'origine dati ContosoSales e dal primo nodo dalla query inventari, derivata 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 clienti. La seconda sezione, "inventari", contiene l'output della query inventari.

L'aspetto della visualizzazione query durante l'esecuzione di questa richiesta è il seguente:

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