Memperbarui ke versi Databricks SQL API terbaru

Halaman ini menjelaskan perubahan pada API Kueri, Pemberitahuan, Izin, Sumber Data, dan Visualisasi yang disertakan dalam versi terbaru Databricks SQL API. API warisan tidak digunakan lagi dan dukungan akan segera berakhir. Gunakan halaman ini untuk memigrasikan aplikasi dan integrasi Anda ke versi API baru.

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.
• Mencakup definisi peringatan baru dengan nama dan jenis lapangan yang lebih deskriptif yang digunakan.
• 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 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.

API Izin tidak digunakan lagi

API Izin sekarang ditandai sebagai tidak digunakan lagi. Gunakan API Ruang Kerja untuk mengelola izin objek. Gunakan API pembaruan kueri dan peringatan untuk mentransfer kepemilikan objek.

API Sumber Data tidak digunakan lagi

API Sumber Data sekarang ditandai sebagai tidak digunakan lagi. 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.

Meningkatkan versi SDK

Jika Anda mengakses Databricks SQL API warisan melalui Databricks SDK, tingkatkan ke versi SDK terbaru dan migrasikan ke API baru. Lihat Dokumentasi SDK Databricks untuk informasi lebih lanjut tentang SDK.

Memigrasikan perintah CLI

Jika Anda mengakses Databricks SQL API warisan melalui Databricks CLI, migrasikan dari grup perintah yang tidak digunakan lagi ini:

Deprecated	Gunakan Sebagai gantinya
kueri-warisan	queries
alerts-legacy	alerts
sumber data	Tidak ada penggantian

Memigrasikan sumber daya Terraform

Jika Anda menggunakan Terraform untuk mengelola sumber daya Databricks SQL Anda, migrasikan ke definisi sumber daya baru:

Sumber Daya yang Tidak Digunakan Lagi	Gunakan Sebagai gantinya	Panduan Migrasi
databricks_sql_query	databricks_query	Panduan migrasi
databricks_sql_alert	databricks_alert	Panduan migrasi
databricks_sql_visualization	databricks_dashboard	Tidak ada panduan migrasi

Untuk databricks_sql_endpoint dan databricks_sql_warehouse:

Tingkatkan ke penyedia Databricks Terraform v1.105.0 atau yang lebih baru. Bidang data_source_id tidak digunakan lagi. Tingkatkan untuk mencegah kesalahan saat API sumber data yang tidak digunakan lagi dinonaktifkan.