Compartir vía


Consulta de varios orígenes de datos en la API de Fabric para GraphQL

Nota:

La API de Microsoft Fabric para GraphQL está en versión preliminar.

En la API de Fabric para GraphQL, puede exponer muchos orígenes de datos a través de un único elemento de API. Esta característica le permite emitir una sola consulta que recupera datos en varios orígenes de datos.

Una consulta de un origen de datos múltiple es una secuencia de consultas que usan operaciones en orígenes de datos diferentes.

Esta funcionalidad puede mejorar el rendimiento de las aplicaciones reduciendo el número de recorridos de ida y vuelta entre la aplicación y la API para GraphQL.

Nota:

Un origen de datos múltiple efectúa una distribución ramificada las solicitudes individuales a los orígenes de datos. No puede crear relaciones entre tipos que abarquen múltiples orígenes de datos. Además, no se puede garantizar el orden en que se ejecutarán las solicitudes individuales.

Ejemplo de consulta

En el ejemplo siguiente se muestra una consulta que abarca los orígenes de datos ContosoSales y ContosoInventory:

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

Esta solicitud recupera el primer nodo de la consulta de clientes, que se deriva del origen de datos ContosoSales y el primer nodo de la consulta de inventarios, que se deriva del origen de datos ContosoInventory.

La salida de la solicitud es:

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

Hay dos partes en la salida: la primera sección, "datos" contiene la salida de la consulta de clientes. La segunda sección, "inventarios", contiene la salida de la consulta de inventarios.

Este es el aspecto de la vista de consulta al ejecutar esta solicitud:

Captura de pantalla de la pantalla del editor en la que se muestra un ejemplo de una consulta que abarca dos orígenes de datos.