Veri API oluşturucusu sürüm 1.1 'deki yenilikler (Mayıs 2024)

Veri API oluşturucusu (DAB) sürüm 1.1'deki güncelleştirmeler ve geliştirmeler hakkında sürüm notları ve bilgiler.

Önemli

Bu sürüm, Veri API oluşturucusunun (DAB) ilk genel kullanılabilirlik (GA) sürümüdür.

GitHub sürüm notları

Tüm değişikliklerin ve iyileştirmelerin kapsamlı bir listesi için bu sürüm sayfalarını gözden geçirin:

Bağlantı
2024-05-14 - Sürüm 1.1.7 https://github.com/azure/data-api-builder/releases/tag/v1.1.7

.NET 8 desteği

DAB artık hem .NET 6 hem de .NET 8 uzun vadeli destek (LTS) sürümlerini desteklemek için çoklu hedefleme kullanıyor.

Daha fazla bilgi için bkz. azure/data-api-builder - .NET çoklu çerçeve hedefleme.

GraphQL çoklu mutasyon desteği

DAB artık birden çok mutasyon işlemini tek bir GraphQL işleminde birleştirmeyi destekliyor. Geçerli destek yalnızca create işlemleriyle sınırlıdır.

Örneğin, ilişkili olan Book ve Chapter varlıklarımız olduğunu varsayalım. Birden çok mutasyonla, birincil kitap varlığını ve tüm ilgili bölüm varlıklarını tek bir işlem olarak oluşturabilirsiniz.

mutation {
  createBook(
    item: {
      title: "Data API builder deep-dive"
      chapters: [
        { name: "Multiple mutations" }
        { name: "Relationships" }
      ]
    }
  ) {
    title
    chapters {
      items {
        name
      }
    }
  }
}

Bu özellik , Çoklu mutasyon kılavuzumuzda ayrıntılı olarak belgelenmiştir.

Daha fazla bilgi için bkz. azure/data-api-builder - GraphQL'de birden çok mutasyon.

Sayfalandırma geliştirmeleri

DAB artık yerleşik sayfalandırma desteğinin çeşitli özelliklerini ayarlamak için bir paginationOptions yapılandırma özelliğine sahiptir. Alt özellikler şunlardır:

Varsayılan değer Açıklama
default-page-size 100 Sayfa boyutu belirtilmeden bir istek yapılırsa, varsayılan sayfa boyutu kullanılır.
max-page-size 100,000 Sayfa boyutu için belirtilen bir istek -1 yapıldıysa sayfa boyutu.

Daha fazla bilgi için bkz. azure/data-api-builder - Sayfalama sınırları ekleme.

Sağlık durumu

DAB'nin önceki sürümlerinde API, kök () uç noktasında dize healthy iletisi / döndürseydi. Araç şimdi durum, sürüm ve DAB'nin barındırılıp barındırılmadığını veya açık kaynak yazılım (OSS) sürümünü gösteren uygulama adını içeren bir JSON nesnesi döndürür.

Örneğin, OSS kapsayıcı görüntüsünün sürümü 0.12.0 varsayılan olarak şu durum iletisini döndürür:

{
    "status": "Healthy",
    "version": "0.12.0",
    "app-name": "dab_oss_0.12.0"
}

Daha fazla bilgi için bkz. azure/data-api-builder - Sağlık uç noktasının geliştirilmiş meta verileri.

REST Birden çok veritabanı desteği

REST API'de artık birden çok veritabanı (veya veri kaynağı) desteklenmektedir. Veritabanı adı her bir varlığa göre belirlenir.

Daha fazla bilgi için bkz. azure/data-api-builder - REST'te birden çok veritabanı desteği.

NoSQL için Azure Cosmos DB geliştirmeleri

DAB'de mevcut NoSQL için Azure Cosmos DB desteğinde birkaç geliştirme yapıldı.

Düzeltme eki işlemi desteği

Azure Cosmos DB düzeltme eki işlemleri artık mutasyon kullanılarak patch<entity-name> desteklenmektedir.

Örneğin, publisher ile bölümlenmiş çeşitli yazar öğelerinin bulunduğu küçük bir kap olduğunu varsayalım. Şimdi kapsayıcının şu öğeye ve şemaya sahip olduğunu varsayalım:

{
  "id": "04511cbc-459d-4e39-b957-363f26771fc0",
  "firstName": "Jacob",
  "lastName": "Hancock",
  "publisher": "Contoso Books"
}

type Author @model {
  id: ID!
  firstName: String!
  middleName: String
  lastName: String!
  publisher: String!
}

GraphQL kullanarak düzeltme eki uygulamak için, hem benzersiz tanımlayıcıyı patchAuthor hem de bölüm anahtarını belirten mutasyonu kullanın:

mutation {
  patchAuthor(
    item: { 
      middleName: "A." 
    }
    id: "04511cbc-459d-4e39-b957-363f26771fc0"
    _partitionKeyValue: "Contoso Books"
  ) {
    middleName
  }
}

Daha fazla bilgi için bkz. azure/data-api-builder - Düzeltme eki desteği.

Öğe düzeyi güvenlik

Öğe düzeyinde güvenlik (veritabanı ilkeleri) artık NoSQL için Azure Cosmos DB ile desteklenmektedir. Geçerli rolün erişebileceği öğeleri belirlemek için veritabanı ilkesi ifadesi değerlendirilir.

Örneğin, scoped-reader adlı yeni bir rolü tanımlar. Bu rol, yalnızca kimlik sağlayıcısının ownerId nesnesinden var olan UserId ile eşdeğer olan öğeleri @claims okuyabilir.

{
  "<entity-name>": {
    "permissions": [
      {
        "role": "scoped-reader",
        "actions": [
          {
            "action": "read",
            "policy": {
              "database": "@item.ownerId eq @claims.UserId"
            }
          }
        ]
      }
    ]
  }
}

Daha fazla bilgi için bkz. azure/data-api-builder - Veritabanı ilkesini kullanarak öğe düzeyinde kimlik doğrulama desteği.

Bellek içi önbellek desteği

Mevcut NoSQL için Azure Cosmos DB sorgu altyapısını Azure Cosmos DB'nin bellek içi önbelleğini kullanacak şekilde güncelleştirir.

Daha fazla bilgi için bkz. azure/data-api-builder - Bellek içi önbellek desteği.

PostgreSQL geliştirmeleri

DAB'de mevcut PostgreSQL desteğinde bir geliştirme var.

Uygulama adını bağlantı dizesiyle birleştirme

DAB artık PostgreSQL bağlantı dizesini DAB uygulama adıyla tamamlar. Araç, bağlantı dizesinde bir uygulama adının zaten var olup olmadığını denetler ve aşağıdakilerden birini de gerçekleştirir:

  • Var olmayan bir DAB uygulama adı ekler veya
  • Var olan uygulama adından sonra bir , ayırıcı ile DAB uygulama adını ekler.

Daha fazla bilgi için bkz. azure/data-api-builder - PostgreSQL bağlantıları için uygulama adı ekleme.

  • Last updated on