Menulis kueri dan menjelajahi data di editor SQL baru

UI Databricks menyertakan editor SQL yang dapat Anda gunakan untuk menulis kueri, berkolaborasi dengan kolega, menelusuri data yang tersedia, dan membuat visualisasi. Halaman ini menjelaskan cara menggunakan editor SQL untuk menulis, menjalankan, mengelola, dan berbagi kueri.

Artikel ini menjelaskan cara menggunakan editor SQL baru. Untuk mempelajari tentang bekerja dengan editor SQL warisan, lihat Menulis kueri dan menjelajahi data di editor SQL warisan.

Buka editor SQL

Untuk membuka editor SQL di antarmuka pengguna Azure Databricks, klik Editor SQL di bar samping.

Editor SQL terbuka untuk kueri terakhir Anda yang terbuka. Jika tidak ada kueri, atau semua kueri Anda telah ditutup secara eksplisit, halaman utama editor SQL akan terbuka.

Mengaktifkan editor SQL baru

Gunakan pengalih editor SQL Baru, yang berada di sebelah kanan pemilih drop-down katalog dan skema, untuk menyalakan editor baru. Pada tampilan sempit, Anda dapat menemukan Editor SQL Baru dengan mengklik di sebelah kanan pemilih katalog dan skema.

Aktifkan editor baru untuk kueri apa pun yang Anda miliki:

• 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 Daftar Dropdown berbasis Kueri, yang tidak didukung. Lihat 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.

Catatan

Hasil kueri dibagikan dengan semua kolaborator dan dibatasi hingga 64.000 baris.

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.

Menyambungkan ke komputasi

Anda harus memiliki setidaknya izin CAN USE pada gudang SQL untuk menjalankan kueri. Anda dapat menggunakan menu drop-down di dekat bagian atas editor untuk melihat opsi yang tersedia. Untuk memfilter daftar, masukkan teks dalam kotak teks.

Pertama kali Anda membuat kueri, daftar gudang SQL yang tersedia muncul menurut abjad. Gudang SQL yang terakhir digunakan dipilih saat Anda membuat kueri berikutnya. Jika ruang kerja Anda diaktifkan untuk memilih gudang SQL default, Anda dapat menyesuaikan gudang default Anda. Lihat Mengatur gudang default tingkat pengguna.

Ikon di samping gudang SQL mengindikasikan status:

• Menjalankan
• Berhenti

Catatan

Jika tidak ada gudang SQL dalam daftar, hubungi administrator ruang kerja Anda.

Gudang SQL yang dipilih akan dimulai ulang secara otomatis saat Anda menjalankan kueri Anda. Lihat Memulai gudang SQL untuk mempelajari cara lain untuk memulai gudang SQL.

Telusuri aset dan dapatkan bantuan

Gunakan panel kiri di editor SQL untuk menelusuri file ruang kerja, melihat objek data, dan mendapatkan bantuan dari Databricks Assitant.

Menelusuri file ruang kerja

Klik ikon folder untuk membuka folder pengguna ruang kerja Anda. Anda dapat menavigasi di semua file ruang kerja yang dapat Anda akses dari bagian UI ini.

Menelusuri objek data

Jika Anda memiliki izin baca metadata, browser skema di editor SQL memperlihatkan database dan tabel yang tersedia. Anda juga dapat menelusuri objek data dari Catalog Explorer.

Anda dapat menavigasi objek database yang diatur Katalog Unity di Catalog Explorer tanpa komputasi aktif. Untuk menjelajahi data di dan katalog lain yang hive_metastore tidak diatur oleh Katalog Unity, Anda harus melampirkan ke komputasi dengan hak istimewa yang sesuai. Lihat Tata kelola data dengan Azure Databricks.

Catatan

Jika tidak ada objek data di browser skema atau Catalog Explorer, hubungi administrator ruang kerja Anda.

Klik di dekat bagian atas browser skema untuk menyegarkan skema. Anda dapat mengetik di bilah pencarian untuk memfilter aset menurut nama. Klik ikon filter untuk memfilter objek menurut jenis.

Klik nama objek di browser untuk melihat detail selengkapnya tentang objek. Misalnya, klik nama skema untuk memperlihatkan tabel dalam skema tersebut. Klik nama tabel untuk memperlihatkan kolom dalam tabel tersebut.

Dapatkan bantuan dari Asisten Databricks

Klik ikon Asisten untuk membuka jendela obrolan dengan Asisten Databricks. Klik pertanyaan yang disarankan atau masukkan pertanyaan Anda sendiri untuk berinteraksi dengan Asisten Databricks.

Membuat kueri

Anda bisa memasukkan teks untuk membuat kueri di editor SQL. Anda dapat menyisipkan elemen dari browser skema untuk mereferensikan katalog dan tabel.

1. Ketik kueri Anda di editor SQL.

   Editor SQL mendukung pelengkapan otomatis. Saat Anda mengetik, pelengkapan otomatis menyarankan penyelesaian. Misalnya, jika penyelesaian yang valid di lokasi kursor adalah kolom, pelengkapan otomatis akan menyarankan nama kolom. Jika Anda mengetik select * from table_name as t where t., pelengkapan otomatis mengenali bahwa t adalah alias untuk table_name dan akan menyarankan kolom di dalam table_name. Anda juga dapat menggunakan pelengkapan otomatis untuk merujuk cuplikan kueri.

   

2. (Opsional) Setelah selesai mengedit, klik Simpan. Secara default, kueri disimpan ke folder beranda pengguna Anda. Untuk menyimpan kueri ke lokasi lain, pilih folder target dan klik Pindahkan.

Catatan

Kueri baru secara otomatis diberi nama Kueri baru dengan tanda waktu pembuatan ditambahkan dalam judul. Secara default, kueri baru yang dibuat tanpa konteks folder tertentu dibuat di folder Draf di direktori beranda Anda. Saat kueri baru disimpan atau diganti namanya, kueri tersebut akan dihapus dari Draf.

Mengkueri sumber data

Anda dapat mengidentifikasi sumber kueri menggunakan nama tabel yang sepenuhnya memenuhi syarat dalam kueri itu sendiri atau dengan memilih kombinasi katalog dan skema dari pemilih drop-down bersama dengan nama tabel dalam kueri. Nama tabel yang sepenuhnya memenuhi syarat dalam kueri mengambil alih katalog dan pemilih skema di editor SQL. Jika nama tabel atau kolom menyertakan spasi, bungkus pengidentifikasi tersebut dengan tanda backtick pada kueri SQL Anda.

Catatan

Jumlah maksimum hasil yang dikembalikan dalam tabel adalah 64.000 baris atau 10MB, mana yang lebih kecil.

Contoh berikut menunjukkan cara mengkueri berbagai objek seperti tabel yang bisa Anda simpan dalam katalog.

Mengkueri tabel atau tampilan standar

Contoh berikut mengkueri tabel dari samples katalog.

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

Mengkueri tampilan metrik

Contoh berikut mengkueri tampilan metrik yang menggunakan tabel dari katalog sampel sebagai sumbernya. Ini mengevaluasi tiga langkah yang tercantum dan menggabungkan atas Order Month dan Order Status. Ini mengembalikan hasil yang diurutkan menurut Order Month. Untuk membuat tampilan metrik serupa di ruang kerja Anda, lihat Membuat tampilan metrik.

Semua evaluasi pengukuran harus dibungkus dengan fungsi MEASURE. Lihat fungsi agregat measure.

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

Mengoptimalkan kueri dengan Asisten Databricks

Klik di sisi kanan editor untuk mendapatkan bantuan dan saran sebaris saat menulis kueri. Perintah /optimize slash menginstruksikan Asisten untuk mengevaluasi dan mengoptimalkan kueri. Untuk informasi selengkapnya, lihat Mengoptimalkan kode Python, PySpark, dan SQL.

Mengedit beberapa tab kueri

Secara default, editor SQL menggunakan tab sehingga Anda dapat membuka dan mengedit beberapa kueri secara bersamaan. Untuk membuka tab baru, klik +, lalu pilih Buat kueri baru atau Buka kueri yang ada. Klik Buka kueri yang sudah ada untuk melihat daftar kueri. Tab Untuk Anda menawarkan daftar saran terkurasi berdasarkan aktivitas Anda. Gunakan tab Semua untuk menemukan kueri apa pun yang dapat Anda akses.

Menjalankan kueri tunggal atau kueri dengan beberapa pernyataan

Anda dapat menulis kueri multi-pernyataan ke dalam satu tab editor. Untuk menggunakan beberapa pernyataan kueri dalam satu tab, akhiri setiap pernyataan dengan titik koma (;).

Untuk melakukan satu kueri:

1. Memilih gudang SQL.
2. Sorot kueri di editor SQL (jika beberapa kueri ada di panel kueri).
3. Tekan Ctrl/Cmd + Enter atau klik Jalankan (1000) untuk menampilkan hasil sebagai tabel di panel hasil.

Catatan

Secara default, Jalankan semua pernyataan dan Batas 1000 dipilih.

• Untuk menjalankan pernyataan aktif saja, batal pilih Jalankan semua pernyataan.
• Jika kueri disimpan dengan pengaturan Batas 1000 , pengaturan ini berlaku untuk semua kueri yang dijalankan. Untuk mengembalikan semua baris (hingga 64.000 baris atau 10 MB, mana yang lebih kecil), bersihkan LIMIT 1000 dari menu drop-down Jalankan (1000). Untuk menentukan batas yang berbeda pada jumlah baris, tambahkan LIMIT klausa dalam kueri Anda.

Menghentikan kueri

Untuk mengakhiri kueri saat dijalankan, klik Batal. Administrator dapat menghentikan kueri yang sedang berjalan yang dimulai oleh pengguna lain dengan menggunakan fitur Penghentian Kueri yang Sedang Dieksekusi.

Berbagi 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 perizinan untuk pemberitahuan lama, Alur Kerja, dan dasbor lama sama dengan pengaturan untuk editor SQL lama. Bergantung pada preferensi Anda, aset ini dapat dijalankan menggunakan kredensial pemilik aset atau penonton.

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.

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.

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 warisan. 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, pengguna dengan setidaknya CAN MANAGE izin dapat menyimpan kueri.

Menampilkan hasil kueri

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.

Anda bisa berinteraksi dengan dan menjelajahi hasil kueri Anda menggunakan panel hasil. Panel hasil menyertakan fitur berikut untuk menjelajahi hasil.

Visualisasi

Klik untuk menambahkan visualisasi. Visualisasi dapat membantu menjelajahi kumpulan hasil. Lihat Jenis visualisasi editor Notebook dan SQL untuk daftar lengkap jenis visualisasi yang tersedia.

Klik tanda pada tab visualisasi untuk memperlihatkan opsi tambahan.

• Klik Unduh untuk mengunduh data yang diwakili dalam visualisasi sebagai file CSV, TSV, atau Excel.
• Klik Hapus untuk menghapus visualisasi.
• Klik Duplikat untuk mengkloning tab hasil.
• Klik Ganti nama untuk mengganti nama visualisasi.

1. Klik Edit untuk mengedit visualisasi.
2. Klik Tambahkan ke dasbor untuk menyalin kueri dan visualisasi ke dasbor AI/BI baru.
3. Pilih Buat dasbor baru atau Tambahkan ke dasbor yang sudah ada.
   • Buat dasbor baru: Membuat dasbor baru yang menyertakan semua visualisasi yang terkait dengan kueri. Anda diminta untuk memilih nama untuk dasbor baru. Dasbor baru disimpan ke folder utama Anda.
   • Tambahkan ke dasbor yang sudah ada: Menambahkan kueri dan visualisasi terkait ke dasbor yang sudah ada. Gunakan menu drop-down untuk memilih dasbor tempat himpunan data dan visualisasi harus ditambahkan.

Unduh hasil

Anda dapat mengunduh hasil sebagai file CSV atau Excel. Unduhan CSV mendukung hingga sekitar 5GB data. Klik di tab hasil untuk melihat opsi unduhan. Ukuran unduhan file akhir mungkin sedikit lebih atau kurang dari 5GB, karena batas 5GB diterapkan ke langkah sebelumnya daripada unduhan file akhir.

Catatan

Jika Anda tidak dapat mengunduh kueri, administrator ruang kerja Anda telah menonaktifkan unduhan untuk ruang kerja Anda.

Filter

Filter memungkinkan Anda membatasi tataan hasil setelah kueri dijalankan. Anda dapat menerapkan filter untuk menampilkan subset data yang berbeda secara selektif. Gunakan Asisten untuk membantu Anda menambahkan filter untuk hasil.

Untuk menambahkan filter:

1. Klik ikonnya, ikon filter.
2. Masukkan teks untuk menjelaskan jenis filter yang ingin Anda terapkan. Filter bernama diterapkan ke kumpulan hasil.

Untuk mengedit filter:

1. Klik nama filter.
2. Gunakan menu drop-down dan bidang teks untuk menyesuaikan pengaturan filter.
3. (Opsional) Pilih Sensitif huruf besar/kecil untuk membuat filter peka terhadap huruf besar/kecil.
4. (Opsional) Klik Tambahkan kondisi OR untuk menambahkan filter tambahan.

Tambah parameter

Parameter memungkinkan Anda membatasi hasil yang ditetapkan dengan mengganti nilai ke dalam kueri saat runtime. Lihat Bekerja dengan parameter kueri untuk mempelajari cara menerapkan parameter.

Perubahan sintaks parameter

Kueri yang ditulis dalam editor SQL warisan yang menggunakan kurung kurawal ganda ({{}}) untuk menandai 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.

Jenis filter yang didukung

Tabel berikut ini memperlihatkan jenis filter yang didukung di editor SQL baru. Kolom kedua menunjukkan apakah filter juga berfungsi di editor SQL warisan.

Jenis filter	Didukung di editor lama
Sama dengan	Ya
Tidak sama dengan	Tidak.
Adalah salah satu dari	Ya
Bukan salah satu dari	Tidak.
Berisi	Ya
Tidak berisi	Tidak.
Dimulai dengan	Ya
Tidak dimulai dengan	Tidak.
Di akhir dengan	Tidak.
Tidak diakhir dengan	Tidak.
Tidak ada	Tidak.
Bukan null	Tidak.
Lebih besar dari	Tidak.
Lebih besar dari atau sama dengan	Tidak.
Kurang dari	Tidak.
Kurang dari atau sama dengan	Tidak.
Antara	Ya
Sebelumnya	Tidak.
Setelahnya	Tidak.
Benar	Ya
Salah	Ya
Kondisi OR	Tidak.

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.

Fungsi	Pintasan macOS	Pintasan Windows
Menjalankan kueri	Cmd + Enter	Ctrl + Enter
Menjalankan satu pernyataan yang disorot	Cmd + Shift + Enter	Ctrl + Shift + Enter
Pelengkapan otomatis	Ctrl + Space	Ctrl + Space
Memperbesar ukuran font	Option + + (kunci plus)	Alt + + (kunci plus)
Kurangi ukuran font	Option + - (kunci minus)	Alt + - (kunci minus)
Format kode SQL	Cmd + Shift + F	Ctrl + Shift + F
Lihat semua pintasan	Esc kemudian H	Esc kemudian H

Menonaktifkan editor SQL baru

Untuk menonaktifkan editor SQL baru:

• 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.

Untuk mencegah kueri dibuka secara otomatis di editor SQL baru:

1. Di ruang kerja Databricks, klik nama pengguna Anda di bilah atas dan pilih Pengaturan.
2. Di panel kiri, di bawah Pengguna, klik tab Pengembang .
3. Nonaktifkan Buat dan buka semua kueri yang memenuhi syarat di editor SQL baru.

Admin ruang kerja dapat menonaktifkan fitur ini di tingkat ruang kerja dengan mengunjungi portal pratinjau dan mencari editor SQL. Lihat Kelola Pratinjau Azure Databricks.