Bagikan melalui

Memperbarui ke versi Databricks SQL API terbaru

  • Artikel

Artikel ini menjelaskan perubahan pada API Kueri, Pemberitahuan, Izin, dan Sumber Data yang disertakan dalam versi terbaru Databricks SQL API. Gunakan artikel ini untuk membantu Anda memigrasikan aplikasi dan integrasi ke versi API baru.

API warisan akan terus didukung selama enam bulan. Periode transisi ini memberi Anda waktu untuk bermigrasi sebelum versi yang lebih lama dihapus.

Perubahan pada API Kueri

API Kueri baru mencakup pengalaman yang lebih ramah pengguna dengan nama-nama yang lebih deskriptif, respons yang dibagi dalam halaman, dan respons berbasis daftar yang diurutkan secara otomatis menurut waktu pembuatan. Daftar berikut ini menjelaskan perubahan pada API Kueri:

  • Jalur API sekarang api/2.0/sql/queries, menggantikan jalur warisan dari /api/2.0/preview/sql/queries.
  • Menyertakan definisi kueri baru dengan nama dan jenis bidang yang lebih deskriptif.
  • Titik akhir pembaruan sekarang mendukung pembaruan parsial dengan menggunakan PATCH alih-alih POST.
  • Titik akhir pembaruan sekarang mendukung pemindahan kepemilikan kueri. Sebelumnya, ini hanya diizinkan menggunakan API kepemilikan objek transfer.
  • Respons titik akhir daftar sekarang dipaginasi menggunakan penomoran halaman berbasis token.
  • Titik akhir daftar tidak lagi mendukung pemfilteran menurut nama atau urutan kustom. Sebagai gantinya, semua kueri yang dapat diakses dikembalikan dan diurutkan dalam urutan naik berdasarkan waktu pembuatannya.
  • Titik akhir pemulihan tidak lagi didukung. Kueri yang dibuang dapat terus dipulihkan melalui antarmuka pengguna Azure Databricks.

Untuk dokumentasi lengkap tentang API Kueri yang diperbarui, lihat Kueri.

Perubahan pada API Pemberitahuan

API Pemberitahuan baru mencakup pengalaman yang lebih ramah pengguna dengan nama dan jenis bidang yang lebih deskriptif, respons paginasi untuk mencantumkan titik akhir, dan dukungan untuk pembaruan parsial. Daftar berikut menjelaskan perubahan pada API Pemberitahuan:

  • Jalur API sekarang api/2.0/sql/alerts, menggantikan jalur warisan dari /api/2.0/preview/sql/alerts.
  • Menyertakan definisi pemberitahuan baru dengan nama dan jenis bidang yang lebih deskriptif digunakan.
  • Titik akhir pembaruan sekarang mendukung pembaruan parsial dengan menggunakan PATCH alih-alih POST.
  • Titik akhir pembaruan sekarang mendukung transfer kepemilikan kueri. Sebelumnya, ini hanya diizinkan menggunakan API kepemilikan objek transfer.
  • Respons titik akhir daftar sekarang dipaginasi menggunakan penomoran halaman berbasis token.
  • Titik akhir penghapusan sekarang memindahkan pemberitahuan ke sampah alih-alih menghapus pemberitahuan secara permanen. Pemberitahuan yang dibuang akan dibersihkan secara otomatis setelah 30 hari. Pemberitahuan yang dibuang dapat dipulihkan dalam waktu 30 hari setelah penghapusan melalui antarmuka pengguna Azure Databricks.

Untuk dokumentasi lengkap tentang API Pemberitahuan yang diperbarui, lihat Pemberitahuan.

Perubahan pada API Izin

API Izin tidak lagi mendukung Dapatkan objek ACL dan Atur objek ACL. Gunakan API Ruang Kerja untuk mengelola izin untuk tindakan ini.

API Sumber Data ditandai sebagai warisan

API Sumber Data sekarang ditandai sebagai warisan. Saat ini, fungsionalitasnya terbatas untuk mendapatkan daftar gudang SQL. Karena API Kueri baru mendukung passing in dan mengembalikan ID gudang SQL alih-alih ID sumber data, panggilan API terpisah untuk mengonversi antara sumber data dan gudang SQL tidak lagi diperlukan.