Aracılığıyla paylaş

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

  • Makale

Bu makalede Databricks SQL API'sinin en son sürümünde yer alan Sorgular, Uyarılar, İzinler ve Veri Kaynakları API'lerinde yapılan değişiklikler açıklanmaktadır. Uygulamalarınızı ve tümleştirmelerinizi yeni API sürümüne geçirmenize yardımcı olması için bu makaleyi kullanın.

Eski API altı ay boyunca desteklenmeye devam edecektir. Bu geçiş dönemi, eski sürüm aşamalı olarak kapatılana kadar geçiş yapmak için size zaman verir.

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 POSTyerine PATCH 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 POSTyerine PATCH 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'sinde yapılan değişiklikler

İzinleri API artık Get object ACL ve Set object ACLdesteklemiyor. Bu eylemlerin izinlerini yönetmek için Çalışma Alanı API'sini kullanın.

Eski olarak işaretlenmiş Veri Kaynakları API'si

Veri Kaynakları API'si artık eski 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.