En son Databricks SQL API sürümüne güncelleştirme

Bu sayfada Databricks SQL API'sinin en son sürümünde yer alan Sorgular, Uyarılar, İzinler, Veri Kaynakları ve GörselleştirmeLER API'lerinde yapılan değişiklikler açıklanmaktadır. Eski API kullanım dışı bırakıldı ve destek yakında sona erecek. Uygulamalarınızı ve tümleştirmelerinizi yeni API sürümüne geçirmek için bu sayfayı kullanın.

Sorgular API'sinde yapılan değişiklikler

Yeni Sorgular API'sinde daha açıklayıcı adlar, sayfalandırılmış yanıtlar ve oluşturma zamanına göre otomatik olarak sıralanan liste yanıtları ile daha kullanıcı dostu bir deneyim bulunur. Aşağıdaki listede Sorgular API'sinde yapılan değişiklikler açıklanmaktadır:

• API yolu artık api/2.0/sql/querieseski yolunun /api/2.0/preview/sql/queriesyerine kullanılır.
• Daha açıklayıcı alan adları ve türleri içeren yeni bir sorgu tanımı içerir.
• Güncelleştirme uç noktası artık PATCHyerine POST kullanarak kısmi güncelleştirmeleri destekliyor.
• Güncelleştirme uç noktası artık sorguların sahipliğini aktarmayı destekliyor. Daha önce buna yalnızca aktarım nesnesi sahipliği API'sinin kullanılmasına izin veriliyordu.
• Liste uç noktası yanıtları artık belirteç tabanlı sayfalandırma kullanılarak sayfalandırılmıştır.
• Liste uç noktası artık ada veya özel sıralamaya göre filtrelemeyi desteklemez. Bunun yerine, tüm erişilebilir sorgular döndürülür ve oluşturma saatlerine göre artan düzende sıralanır.
• Geri yükleme uç noktası artık desteklenmiyor. Çöpe atılan sorgular Azure Databricks kullanıcı arabirimi aracılığıyla geri yüklenmeye devam edebilir.

Güncelleştirilmiş Sorgular API'sinin tüm belgeleri için bkz . Sorgular.

Uyarılar API'sinde yapılan değişiklikler

Yeni Uyarılar API'sinde daha açıklayıcı alan adları ve türleri, liste uç noktalarına sayfalandırılmış yanıtlar ve kısmi güncelleştirme desteği ile daha kullanıcı dostu bir deneyim bulunur. Aşağıdaki listede Uyarılar API'sinde yapılan değişiklikler açıklanmaktadır:

• API yolu artık api/2.0/sql/alertseski yolunun /api/2.0/preview/sql/alertsyerine kullanılır.
• Daha açıklayıcı alan adları ve türleri kullanılan yeni bir uyarı tanımı içerir.
• Güncelleştirme uç noktası artık PATCHyerine POST kullanarak kısmi güncelleştirmeleri destekliyor.
• Güncelleştirme uç noktası artık sorguların sahipliğini aktarmayı destekliyor. Daha önce buna yalnızca aktarım nesnesi sahipliği API'sinin kullanılmasına izin veriliyordu.
• Liste uç noktası yanıtları artık belirteç tabanlı sayfalandırma kullanılarak sayfalandırılmıştır.
• Silme uç noktası artık uyarıyı kalıcı olarak silmek yerine çöp kutusuna taşır. Çöpe atılan uyarılar 30 gün sonra otomatik olarak temizlenir. Çöpe atılan uyarılar, Silme işleminden sonraki 30 gün içinde Azure Databricks kullanıcı arabirimi aracılığıyla geri yüklenebilir.

Güncelleştirilmiş Uyarılar API'sinin tüm belgeleri için bkz . Uyarılar.

İzinler API'si kullanım dışı bırakıldı

İzinler API'si artık kullanım dışı olarak işaretlendi. Nesne izinlerini yönetmek için Çalışma Alanı API'sini kullanın. Nesne sahipliğini aktarmak için sorguları ve uyarıları güncelleştirme API'lerini kullanın.

Veri Kaynakları API'si kullanım dışı bırakıldı

Veri Kaynakları API'si artık kullanım dışı olarak işaretlendi. Şu anda işlevselliği SQL ambarlarının listesini almakla sınırlıdır. Yeni Sorgular API'si veri kaynağı kimlikleri yerine SQL ambarı kimliklerini geçirmeyi ve döndürmeyi desteklediğinden, veri kaynakları ile SQL ambarları arasında dönüştürmeye yönelik ayrı bir API çağrısı artık gerekli değildir.

SDK sürümlerini yükseltme

Databricks SDK'ları aracılığıyla eski Databricks SQL API'sine erişiyorsanız en son SDK sürümüne yükseltin ve yeni API'lere geçin. SDK için Databricks SDK'ları belgelerine bakın.

CLI komutlarını taşıma

Databricks CLI aracılığıyla eski Databricks SQL API'sine erişiyorsanız, bu kullanım dışı komut gruplarından geçiş yapın:

Deprecated	Bunun yerine kullan
queries-legacy	queries
alerts-legacy	alerts
veri kaynakları	Değiştirme yok

Terraform kaynaklarını taşıma

Databricks SQL kaynaklarınızı yönetmek için Terraform kullanıyorsanız yeni kaynak tanımlarına geçiş yapın:

Kullanım Dışı Bırakılan Kaynak	Bunun yerine kullan	Geçiş Kılavuzu
databricks_sql_query	databricks_query	Geçiş kılavuzu
databricks_sql_alert	databricks_alert	Geçiş kılavuzu
databricks_sql_visualization	databricks_dashboard	Geçiş kılavuzu yok

databricks_sql_endpoint ve databricks_sql_warehouse için:

Databricks Terraform sağlayıcısı v1.105.0 veya sonraki bir sürüme yükseltin. Alan data_source_id kullanım dışı bırakıldı. Kullanım dışı bırakılan veri kaynakları API'si kapatıldığında hataları önlemek için yükseltin.