Aracılığıyla paylaş


GraphQL için Doku API'sinde birden çok veri kaynağını sorgulama

GraphQL için Doku API'sinde, tek bir API öğesi aracılığıyla birçok veri kaynağını kullanıma sağlayabilirsiniz. Bu özellik, birden çok veri kaynağında veri alan tek bir sorgu vermenizi sağlar.

Çok veri kaynağı sorgusu, farklı veri kaynaklarına yönelik işlemler gerçekleştiren bir dizi sorgudur.

Bu işlevsellik, uygulamanızla GraphQL API'si arasındaki gidiş dönüş sayısını azaltarak uygulama performansını artırır.

Not

Çoklu veri kaynağı isteği, tek tek veri kaynaklarına yönelik isteklerin hayranıdır. Birden çok veri kaynağına yayılan türler arasında ilişki oluşturamazsınız. Ayrıca, tek tek isteklerin yürütülmesi için bir garanti yoktur.

Sorgu örneği

Aşağıdaki örnekte hem ContosoSales hem de ContosoInventory veri kaynaklarına yayılan bir sorgu gösterilmektedir:

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

Bu istek ContosoSales veri kaynağından türetilen müşteriler sorgusundan ilk düğümü ve ContosoInventory veri kaynağından türetilen envanterler sorgusundan ilk düğümü alır.

İsteğin çıktısı şu şekildedir:

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

Çıktının iki bölümü vardır: birinci bölüm olan "veri", müşteriler sorgusunun çıkışını içerir ve ikinci bölüm olan "envanterler", envanterler sorgusunun çıkışını içerir.

Bu isteği yürütürken sorgu görünümü şöyle görünür:

İki veri kaynağına yayılan bir sorguyu gösteren düzenleyici ekranının ekran görüntüsü.