Azure Veritabanları için Veri API oluşturucusu nedir?

Veri API oluşturucusu (DAB), SQL Server, Azure Cosmos DB, PostgreSQL ve MySQL gibi desteklenen veritabanları için REST ve GraphQL API'leri oluşturan açık kaynak, yapılandırma tabanlı bir altyapıdır. DAB herhangi bir bulutta veya şirket içinde çalışır ve kullanımı ücretsizdir. Özel bir API yazmadan veritabanı nesnelerini kullanıma sunmanız için bunu tek bir JSON dosyası kullanarak yapılandırabilirsiniz.

Veri API oluşturucusu, bir veritabanında genel CRUD (Oluşturma, Okuma, Güncelleştirme, Silme) işlemleri gerçekleştiren çoğu özel veri API'sinin yerini alır. DAB dil, teknoloji ve çerçeveden bağımsızdır. Uygulama kodu ve tek bir yapılandırma dosyası gerektirmez. En iyisi, premium katmanı yoktur ve durumsuz bir şekilde her yerde çalışabilen tamamen ücretsizdir.

Uç nokta desteği

Veri API oluşturucu, REST ve GraphQL uç noktalarını kutudan çıktığı gibi ve aynı anda destekler. Sürüm 1.7 ve üzeri ile DAB, aynı zengin işlevselliğe sahip aracı uygulamaları için Model Bağlam Protokolü'ne (MCP) de destek verir.

DAB, platformlar arası CLI, OpenTelemetry ve sistem durumu denetimleri içerir. Ayrıca REST uç noktaları için OpenAPI ve Swagger ve GraphQL uç noktaları için Nitro (daha önce Banana Cake Pop olarak adlandırılırdı) desteği sağlar.

Tip

Kutudan çıktığı anda hazır uç nokta özellikleri:

• Veri Sayfalaması
• Veri Filtreleme
• Veri Sıralama
• Sütun Seçimi
• Saklı Prosedürler
• İlişki yönetimi
• SQL ailesi veritabanları için toplama

Veritabanı desteği

Veri API'si oluşturucusu (DAB), ilişkisel ve NoSQL kaynakları da dahil olmak üzere aynı anda birden çok arka uç veri kaynağını destekler. Desteklenen veritabanları SQL Server ve Azure SQL, Azure Cosmos DB, PostgreSQL ve MySQL'dir. Veritabanına göre ayrıntılar ve sınırlamalar için bkz . Özellik kullanılabilirliği.

Veri API'sinin oluşturucusu aynı anda birden çok veri kaynağına bağlanabilir. İlişkisel kaynakları JSON veya belge veritabanlarıyla birleştirebilir ve bulut ile şirket içi veritabanlarını karıştırabilirsiniz. Bu esneklik, DAB'nin basit kurulumlardan karmaşık dağıtım topolojilerine kadar her şeyi desteklemesini sağlar.

Security

Veri API oluşturucusunun durumsuz, Docker dostu kapsayıcısı Azure App Service EasyAuth, Microsoft Entra ID veya herhangi bir JSON Web Belirteci (JWT) sunucusu ile güvenli hale getirilebilir. Esnek bir ilke altyapısına, ayrıntılı güvenlik denetimlerine sahiptir ve talep verilerini otomatik olarak SQL oturumu bağlamlarına geçirir.

Veri API'si oluşturucusu birden çok kimlik doğrulama sağlayıcısını destekler:

Provider	Kullanım örneği
Microsoft Entra ID	Microsoft kimliği kullanan üretim uygulamaları
Özel JWT	Üçüncü taraf kimlik sağlayıcıları (Okta, Auth0, Keycloak)
App Service	Azure App Service EasyAuth'un arkasında çalışan uygulamalar
Simülatör	Yerel geliştirme ve test

Adım adım yapılandırma kılavuzları için bkz . Güvenliğe genel bakış.

Mimarlık

Bu diyagram, Veri API'sinin oluşturucusunun tüm bileşenleri arasındaki ilişkiyi ayırır. Tabloları, görünümleri ve saklı yordamları tanımlayan veritabanı şemasıyla başlar. DAB yapılandırma dosyası bu nesneleri bir soyutlama katmanına projeler. Bu katmanda varlıkları adlandırabilir, alanları seçebilir veya alanlara takma adlar atayabilir, ilişkileri tanımlayabilir ve izinler atayabilirsiniz. Veri API oluşturucusu çalışma zamanında tutarlı bir API yüzeyi oluşturmak için bu yapılandırmayı okur ve rest ve GraphQL uç noktaları aracılığıyla aynı varlık modelini ortaya çıkartır. Bu ayrım, uygulamalar ve istemciler için kararlı ve güvenli bir sözleşme tutarken veritabanını bağımsız olarak geliştirmenizi sağlar.

Veri API'si oluşturucusunu tek bir JSON dosyasıyla yapılandırabilirsiniz. Dosyasında şunları tanımlarsınız:

• Sunucu veri kaynaklarına nasıl bağlanır?
• Hangi tabloların, görünümlerin ve saklı yordamların erişime açık olduğu
• Varlıkların şekli, adı ve ilişkisi
• Her işleme hangi rollerin erişmesine izin verilir?

Dağıtım seçenekleri

DAB, Azure Container Apps, Azure Container Instances, Azure Kubernetes Service ve Kapsayıcılar için Azure Web Apps ile harika çalışır. DAB, özel, şirket içi dağıtımları tam olarak desteklerken bu hizmetlerle çalışır.

Tümleştirmeler ve özellikler

DAB ayrıca Application Insights ile sorunsuz bir şekilde tümleşir. Yapılandırma dosyası veritabanındaki ilişkileri yansıtabilir veya sık erişimli yeniden yükleme desteğine sahip yeni sanal dosyalar tanımlayabilir. GraphQL uç noktaları tek bir işlem içinde birden çok iç içe Create deyimine izin verirken REST uç noktaları bellek içi önbelleğe alma özelliğine ve OData benzeri sorgu dizesi anahtar sözcükleri için zengin desteğe sahiptir.

Daha az kod, daha fazla özellik

DAB, özel API kodunu azaltmaya, CI/CD işlem hatlarını kısaltmaya ve genellikle en büyük geliştirme ekiplerine ayrılmış standartlar ve gelişmiş özellikler sunma konusunda yardımcı olabilir. Son derece basit, ölçeklenebilir ve gözlemlenebilir kalırken güvenli ve özellik bakımından zengindir.

Açık kaynak

Veri API oluşturucusu açık kaynaktır ve MIT lisansı altında yayınlanır. Depo GitHub'da azure/data-api-builder adresinde kullanılabilir.