Berkolaborasi dengan kolega menggunakan editor SQL baru

Editor SQL bawaan di antarmuka pengguna Azure Databricks telah dirancang ulang untuk meningkatkan kolaborasi dan memperkenalkan fitur baru untuk meningkatkan kecepatan pengembangan SQL. Sebagian besar fungsi kueri dan visualisasi dasar tetap sama seperti di editor SQL klasik.

Artikel ini menjelaskan cara mengakses editor SQL baru, mengelola kueri dan izin, dan menggunakan fitur baru yang tersedia di UI. Untuk mempelajari selengkapnya tentang fungsionalitas dasar seperti menulis kueri, menelusuri data yang tersedia, dan membuat visualisasi, lihat Menulis kueri dan menjelajahi data di editor SQL.

Mengakses editor SQL baru

Jika editor kueri baru diaktifkan untuk ruang kerja Anda, editor SQL Baru tombol muncul di sebelah kanan pemilih drop-down katalog dan skema. Pada tampilan sempit, Anda dapat menemukan tombol editor SQL Baru dengan mengklik menu kebab di sebelah kanan pemilih katalog dan skema.

Anda dapat mengaktifkan editor baru untuk kueri apa pun yang Anda miliki. Untuk melakukannya, gunakan langkah-langkah berikut:

• Klik Editor SQL Baru: NONAKTIF. Menu popover editor SQL baru terbuka.
  • Kotak centang Terapkan ke semua kueri saya dipilih secara default. Pertahankan pengaturan ini untuk mengaktifkan editor untuk semua kueri yang Anda miliki.
  • Untuk mengaktifkan editor baru hanya untuk kueri aktif, batal pilih kotak centang Terapkan ke semua kueri saya.
• Atur toggle editor SQL Baru ke posisi ON .

Editor SQL baru tidak dapat digunakan untuk semua kueri. Anda tidak dapat beralih ke editor SQL baru untuk kueri jika salah satu hal berikut ini benar:

• Anda tidak memiliki kueri.
• Kueri berisi jenis parameter Daftar Dropdown berbasis Kueri atau Rentang , yang tidak didukung. Lihat Cara bekerja dengan parameter kueri.

Saat Anda mengaktifkan editor SQL baru, kueri Anda akan dibuka kembali di UI baru. Kumpulan hasil kosong hingga Anda menjalankan kueri.

Berbagi kueri

Izin untuk berbagi kueri di editor baru sebagian besar tidak berubah, dengan beberapa perbedaan untuk mendukung kolaborasi langsung. Lihat Mengonfigurasi izin kueri untuk mempelajari tentang Jalankan sebagai pemilik dan Jalankan sebagai pengaturan kredensial penampil . Lihat ACL kueri untuk mempelajari cara mengelola akses ke objek kueri.

Editor SQL baru menangani izin dalam dua bagian:

Eksekusi interaktif: kueri di editor SQL baru selalu berjalan menggunakan kredensial Jalankan sebagai penampil. Hasil kueri dapat diakses oleh siapa saja yang memiliki akses ke kueri. Pengguna dengan izin DAPAT MENGEDIT atau yang lebih tinggi dapat mengubah draf kueri bersama. Selain itu, pengeditan yang tidak disimpan dapat dilihat oleh siapa pun dengan izin CAN VIEW atau di atasnya. Pengguna harus memiliki setidaknya izin CAN USE pada gudang terkait untuk menjalankan kueri.

Pengaturan kredensial Pengaturan izin untuk pemberitahuan, Alur Kerja, dan dasbor warisan sama dengan pengaturan untuk editor SQL klasik. Bergantung pada preferensi Anda, aset ini dapat dijalankan menggunakan kredensial pemilik atau penampil.

Kontrol sumber sebuah kueri

File kueri Databricks SQL (ekstensi: .dbquery.ipynb) didukung di folder Databricks Git. Anda dapat menggunakan folder Git untuk mengontrol file kueri Anda dan membagikannya di ruang kerja lain dengan folder Git yang mengakses repositori Git yang sama. Jika Anda memilih untuk menolak editor SQL baru setelah menerapkan atau mengkloning kueri di folder Databricks Git, hapus dan buat ulang folder Git tersebut untuk menghindari perilaku yang tidak terduga.

Menyimpan kueri

Konten kueri di editor SQL baru terus disimpan secara otomatis. Tombol Simpan mengontrol apakah konten kueri draf harus diterapkan ke aset terkait, seperti dasbor warisan, Alur Kerja, atau pemberitahuan. Jika kueri dibagikan dengan info masuk Jalankan sebagai pemilik , hanya pemilik kueri yang bisa menggunakan tombol Simpan untuk menyebarkan perubahan. Jika kredensial diatur ke Jalankan sebagai penampil, setiap pengguna dengan setidaknya izin KELOLA BISA menyimpan kueri.

Berkolaborasi pada kueri secara real time

Setelah berbagi kueri, Anda dapat melakukan penulisan bersama atau men-debug kueri secara langsung melalui pengeditan kolaboratif. Editor juga dapat mengomentari baris kode individual untuk mengajukan pertanyaan atau menambahkan saran.

Orientasi

Bagian ini menyoroti perbedaan utama di UI dan menjelaskan cara menemukan dan menggunakan fitur yang tersedia.

1. Mengakses sistem file ruang kerja: Anda dapat mengakses dan mengatur objek ruang kerja Langsung dari editor SQL.
2. Gunakan Asisten Databricks terintegrasi: Mengobrol dengan asisten untuk membantu Anda menulis, memperbaiki, atau memahami kueri. Jalankan kode yang dihasilkan oleh asisten dari panel samping.
3. Ciutkan bagian kode: Klik panah ciutkan di sebelah kiri blok kode untuk menyembunyikan dan memperluas bagian kode secara selektif. Ini dapat mempermudah bekerja melalui file besar.
4. Buka palet perintah: Palet perintah mencakup tindakan umum, pintasan keyboard, tema kustom, dan tautan untuk membantu Anda menemukan apa yang Anda butuhkan dengan cepat. Setelah Anda membukanya, gunakan bilah pencarian untuk mencari alat dan pintasan tertentu.
5. Komentari kode: Tambahkan komentar ke kode untuk meningkatkan kolaborasi.
6. Tinjau riwayat versi: Tinjau perubahan terbaru pada kueri Anda.

Gunakan pintasan keyboard

Editor SQL baru mencakup banyak pintasan keyboard bawaan untuk membantu Anda bekerja dengan cepat. Tabel berikut mengidentifikasi pintasan keyboard yang umum digunakan.

Jelajahi semua hasil

Anda dapat membandingkan output dari setiap pernyataan dengan beberapa pernyataan hasil. Saat menjalankan beberapa pernyataan SQL dari satu jendela edit, Anda dapat menggunakan UI di panel Output di dekat bagian bawah layar untuk menggulir berbagai tataan hasil.

Perubahan sintaks parameter

Kueri yang menggunakan kurung kurawal ganda ({{}}) untuk menunjukkan parameter harus dimodifikasi untuk dijalankan di editor SQL baru. Editor SQL baru menggunakan sintaks parameter yang sama dengan alat Databricks lainnya, seperti dasbor AI/BI, AI/BI Genie, dan notebook.

Parameter di editor SQL baru didefinisikan menggunakan sintaks parameter bernama. Parameter dengan nama adalah parameter dalam kueri yang diawali dengan titik dua, misalnya :parameter_name.

Lihat Penanda parameter bernama untuk dokumentasi referensi SQL. Lihat Contoh sintaks parameter bernama untuk contoh konversi sintaks parameter dari editor SQL klasik ke penanda parameter bernama.

Menonaktifkan editor SQL baru

Untuk menonaktifkan editor SQL baru, gunakan langkah-langkah berikut:

• Klik Editor SQL Baru: AKTIF. Menu popover editor SQL baru terbuka.
• Atur Editor SQL Baru tombol pengalih ke NONAKTIF.
• Dalam dialog konfirmasi, pilih untuk menonaktifkan editor baru hanya untuk kueri aktif atau untuk semua kueri yang memenuhi syarat.
  • Nonaktifkan untuk semua kueri yang memenuhi syarat tidak dipilih. Pertahankan pengaturan ini jika Anda ingin menonaktifkan editor baru hanya untuk kueri aktif.
  • Untuk menonaktifkan editor SQL baru untuk semua kueri Anda, pilih kotak centang Nonaktifkan untuk semua kueri yang memenuhi syarat.

Admin ruang kerja dapat menonaktifkan pratinjau di tingkat ruang kerja dengan mengunjungi portal pratinjau. Lihat Mengelola Pratinjau Azure Databricks.