Veri API oluşturucusu sürüm 1.3 (Kasım 2024) ile ilgili yenilikler

Veri API oluşturucusu (DAB) sürüm 1.3'teki güncelleştirmeler ve geliştirmeler hakkında sürüm notları ve bilgiler.
Sürüm 1.3: Azure Veritabanları için Veri API oluşturucusu

Anında Yeniden Yükleme

Geliştirici döngünüz artık daha küçük, daha hızlı ve daha verimli. Daha önce yapılandırma dosyasını değiştirmek için altyapının durdurulması ve yeniden başlatılması gerekiyordu. Anında Yeniden Yükleme ile DAB, yapılandırma değişikliklerini otomatik olarak algılar ve motoru yeniden başlatmadan güncelleştirmeleri uygular. Değişiklikleri anında test edebilir ve akışta kalabilirsiniz. Sürüm 1.3 itibarıyla, neredeyse tüm DAB özellikleri Hot Reload'u destekler.

Hot Reload her zaman açık ve kapatılamaz. Ancak, production modunda, bu yapılandırma değişiklikleri uygulanmaz. Bu davranış, yetkisiz güncelleştirmelerin uç noktaları sessizce yeniden yapılandırmasına engel olur. Gelecek bir sürümde, production modu, log-level ayarını da destekleyecek—bu ayar, çalışma zamanı davranışını tanılamaya yardımcı olmak için günlük ayrıntı düzeyini ad alanına göre ayarlayan bir özelliktir.

Giriş: Cosmos şema oluşturma

Veri API oluşturucusu, geliştiricilerin NoSQL veri kaynakları için şemalar oluşturmasına yardımcı olan ilk komut satırı arabirimlerinden biridir. Cosmos DB'yi yapılandırdığınızda, DAB'nin yapılandırılmış bir GraphQL uç noktası oluşturmak için bir şemaya ihtiyacı vardır.

Bu şemayı el ile oluşturmak karmaşık olabilir. Bu sürümle, DAB CLI bir şema oluşturma özelliği içerir. Verilerinizi tanımladığınız varlıklara göre örnekleme yaparak, çalışmaya başlamak için yalnızca en az inceleme ve güncelleştirme gerektiren bir çalışma şeması oluşturur.

dab init 
  --database-type cosmosdb_nosql 
  --connection-string @env('cosmos-connection-string') 
  --cosmosdb_nosql-database MyDatabase
  --cosmosdb_nosql-container MyContainer

dab add MyEntity
  --source "MyDatabase.MyEntity"
  --permissions "anonymous:*"
  --graphQL "MyEntity:MyEntities"

dab export
  --graphql
  --generate
  -o ./schemas

dab start

Komut satırıyla her şey

Veri API oluşturucusu geliştikçe, yapılandırma dosyası daha uzun ve daha karmaşık bir şekilde büyür. Bu biçim, okunması ve düzenlenmesi kolay JSON biçimidir; yanlış yerleştirilmiş virgül veya köşeli ayraçla kolayca kırabilirsiniz. Bu seçenek, DAB CLI'nin geliştiricilerin JSON'ı doğrudan düzenlemeden yapılandırmayı güvenli bir şekilde değiştirmesine yardımcı olmasının nedeni budur.

Sürüm 1.3'te, yeni dab configure alt komut ve data-source bölümlerindeki runtime neredeyse tüm ayarları güncelleştirir. Bu güncelleştirme DAB'yi tam CLI kapsamına yaklaştırıyor ve her sürüm bu kapsamı genişletmeye devam ediyor.

Örnek: Güncelleştirme data-source

Seçenek 1: Kapsamlı bir komut

dab configure 
  --data-source.database-type cosmosdb_nosql
  --data-source.options.database testdbname 
  --data-source.options.schema testschema.gql

Seçenek 2: Birkaç küçük komut

dab configure --data-source.database-type cosmosdb_nosql
dab configure --data-source.options.database testdbname
dab configure --data-source.options.schema testschema.gql

Hakkında bir not database-type

Bazı seçenekler veritabanı türüne özeldir. Yapılandırmanız şu anda kullanıyorsa mssql ve cosmos DB seçeneklerini ilk kez öğesine geçmeden cosmosdb_nosqluygularsanız komut başarısız olur.

Diğer örnekler

dab configure --runtime.graphql.enabled true
dab configure --runtime.graphql.path /updatedPath
dab configure --runtime.graphql.allow-introspection true 
dab configure --runtime.graphql.multiple-mutations.create.enabled true

DAB, iç içe yerleştirilmiş yapılandırma özellikleri için bile tam komut satırı kapsamına doğru ilerlemeye devam eder.