Menulis kueri dan menjelajahi data di editor SQL

Antarmuka pengguna Azure Databricks menyertakan editor SQL yang dapat Anda gunakan untuk menulis kueri, menelusuri data yang tersedia, dan membuat visualisasi. Anda juga dapat berbagi kueri yang disimpan dengan anggota tim lain di ruang kerja. Artikel ini menjelaskan cara menggunakan editor SQL untuk menulis, menjalankan, dan mengelola kueri. Versi baru editor SQL ada di Pratinjau Umum. Untuk mempelajari cara mengaktifkan dan bekerja dengan editor SQL baru, lihat Berkolaborasi dengan kolega menggunakan editor SQL baru.

Setelah membuka editor, Anda dapat menulis kueri SQL atau menelusuri data yang tersedia. Editor teks mendukung pelengkapan otomatis, pemformatan otomatis, dan berbagai pintasan keyboard lainnya.

Anda bisa membuka beberapa kueri menggunakan tab kueri di bagian atas editor teks. Setiap tab kueri memiliki kontrol untuk menjalankan kueri, menandai kueri sebagai favorit, dan menyambungkan ke gudang SQL. Anda juga dapat Menyimpan, Menjadwalkan, atau Berbagi kueri.

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, kueri baru akan terbuka. Ini secara otomatis bernama Kueri Baru dan tanda waktu pembuatan ditambahkan dalam judul.

Menyambungkan ke komputasi

Anda harus memiliki setidaknya izin CAN USE pada gudang SQL yang sedang berjalan 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.

Ikon di samping gudang SQL mengindikasikan status:

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

Menelusuri objek data di editor SQL

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 Unity Catalog.

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 memfilter skema dengan mengetik string filter di kotak pencarian.

Klik nama tabel untuk memperlihatkan kolom untuk tabel tersebut.

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.

   

2. (Opsional) Setelah selesai mengedit, klik Simpan. Secara default, kueri disimpan ke folder beranda pengguna Anda, atau Anda bisa memilih lokasi lain. Lalu, klik Simpan.

Mengaktifkan dan menonaktifkan pelengkapan otomatis

Pelengkapan otomatis langsung dapat melengkapi token skema, pengidentifikasi sintaksis kueri (seperti SELECT dan JOIN), dan judul cuplikan kueri. Ini diaktifkan secara default kecuali skema database Anda melebihi lima ribu token (tabel atau kolom).

Gunakan tombol di bawah editor SQL untuk menonaktifkan atau mengaktifkan pelengkapan otomatis langsung.

• Untuk menonaktifkan pelengkapan otomatis langsung, tekan Ctrl + Spasi atau klik tombol di bawah editor SQL.

Simpan kueri

Tombol Simpan di dekat kanan atas editor SQL menyimpan kueri Anda.

Penting

Saat Anda mengubah kueri tetapi tidak secara eksplisit mengklik Simpan, status tersebut dipertahankan sebagai draf kueri. Draf kueri dipertahankan selama 30 hari. Setelah 30 hari, draf kueri akan dihapus secara otomatis. Untuk mempertahankan perubahan, Anda harus menyimpannya secara eksplisit.

Mengedit beberapa kueri

Secara default, editor SQL menggunakan tab sehingga Anda dapat 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 yang disimpan. klik Kueri Saya atau Favorit untuk memfilter daftar kueri. Di baris yang berisi kueri yang ingin Anda lihat, klik Buka.

Menjalankan satu kueri atau beberapa kueri

Untuk menjalankan kueri atau semua 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

Batas 1000 dipilih secara default untuk semua kueri untuk membatasi kueri kembali ke 1000 baris. Jika kueri disimpan dengan pengaturan Batas 1000 , pengaturan ini berlaku untuk semua kueri yang dijalankan (termasuk di dasbor). Untuk mengembalikan semua baris untuk kueri ini, Anda dapat membatalkan pilihan LIMIT 1000 dengan mengklik drop-down Jalankan (1000). Jika Anda ingin menentukan batas yang berbeda pada jumlah baris, Anda bisa menambahkan LIMIT klausa dalam kueri Anda dengan nilai pilihan Anda.

Menghentikan kueri

Untuk menghentikan kueri saat sedang berjalan, klik Batalkan. Administrator dapat menghentikan kueri eksekusi yang dimulai pengguna lain dengan menampilkan kueri Penghentian eksekusi.

Opsi kueri

Anda dapat menggunakan menu konteks kebab di dekat bagian atas editor kueri untuk mengakses opsi menu untuk mengkloning, mengembalikan, memformat, dan mengedit informasi kueri.

Kembali ke kueri tersimpan

Saat Anda mengedit kueri, opsi Kembalikan perubahan muncul di menu konteks untuk kueri. Anda dapat mengklik Kembali untuk kembali ke versi tersimpan Anda.

Membuang dan memulihkan kueri

Untuk memindahkan kueri ke sampah:

• Klik menu konteks kebab di samping kueri di editor SQL dan pilih Pindahkan ke Sampah.
• Klik Pindahkan ke sampah untuk mengonfirmasi.

Untuk memulihkan kueri dari sampah:

1. Di daftar Semua Kueri, klik .
2. Klik kueri.
3. Klik menu konteks kebab di kanan atas editor SQL dan klik Pulihkan.

Mengatur deskripsi kueri dan menampilkan info kueri

Untuk mengatur deskripsi kueri:

1. Klik menu konteks kebab di samping kueri dan klik Edit info kueri.

   

2. Dalam kotak teks Deskripsi , masukkan deskripsi Anda. Lalu, klik Simpan. Anda juga bisa menampilkan riwayat kueri, termasuk saat dibuat dan diperbarui, dalam dialog ini.

Kueri favorit dan tag

Anda dapat menggunakan favorit dan tag untuk memfilter daftar kueri dan dasbor yang ditampilkan di halaman arahan ruang kerja Anda, dan di setiap halaman daftar untuk dasbor dan kueri.

Favorit: Untuk memfavoritkan kueri, klik bintang di sebelah kiri judulnya di daftar Kueri. Bintang akan berubah menjadi kuning.

Tag: Anda dapat menandai kueri dan dasbor dengan string yang bermakna ke organisasi Anda.

Menambahkan tag

Tambahkan tag di editor kueri.

1. Klik menu konteks kebab di samping kueri dan klik Edit info kueri. Dialog Info kueri muncul.

2. Jika kueri tidak memiliki tag yang diterapkan, Tambahkan beberapa tag yang diperlihatkan di kotak teks tempat tag akan muncul. Untuk membuat tag baru, ketikkan ke dalam kotak. Untuk memasukkan beberapa tag, tekan tab di antara entri.

   

3. Klik Simpan untuk menerapkan tag dan menutup dialog.

Hapus tag

1. Klik menu konteks kebab di samping kueri dan klik Edit info kueri.
2. Klik X pada tag apa pun yang ingin Anda hapus.
3. Klik Simpan untuk menutup dialog.

Menampilkan hasil kueri

Setelah kueri berjalan, hasilnya muncul di panel di bawahnya. Tabel Hasil baru aktif untuk kueri baru. Jika perlu, klik menu drop-down untuk menonaktifkannya. Gambar di bagian ini menggunakan tabel hasil baru.

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

Visualisasi, filter, dan parameter

Klik untuk menambahkan visualisasi, filter, atau parameter. Opsi berikut muncul:

Visualisasi: Visualisasi dapat membantu menjelajahi kumpulan hasil. Lihat Jenis visualisasi untuk daftar lengkap jenis visualisasi yang tersedia.

Filter: Filter memungkinkan Anda membatasi kumpulan hasil setelah kueri dijalankan. Anda dapat menerapkan filter untuk menampilkan subset data yang berbeda secara selektif. Lihat Filter kueri untuk mempelajari cara menggunakan filter.

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.

Mengedit, mengunduh, atau menambahkan ke dasbor

Penting

• Databricks merekomendasikan penggunaan dasbor AI/BI (sebelumnya dasbor Lakeview). Versi dasbor sebelumnya, yang sebelumnya disebut sebagai dasbor Databricks SQL sekarang disebut dasbor warisan. Databricks tidak merekomendasikan pembuatan dasbor warisan baru.
• Mengonversi dasbor warisan menggunakan alat migrasi atau REST API. Lihat Mengkloning dasbor warisan ke dasbor AI/BI untuk petunjuk tentang menggunakan alat migrasi bawaan. Lihat Tutorial dasbor untuk tutorial tentang membuat dan mengelola dasbor menggunakan REST API.

Klik di tab hasil untuk melihat opsi lainnya.

1. Klik Edit untuk mengkustomisasi hasil yang diperlihatkan dalam visualisasi.
2. Klik Hapus untuk menghapus tab hasil.
3. Klik Duplikat untuk mengkloning tab hasil.
4. Klik Tambahkan ke dasbor untuk menyalin kueri dan visualisasi ke dasbor baru.
   • Tindakan ini membuat dasbor baru yang menyertakan semua visualisasi yang terkait dengan kueri. Lihat Dasbor untuk mempelajari cara mengedit dasbor Anda.
   • Anda diminta untuk memilih nama untuk dasbor baru. Dasbor baru disimpan ke folder utama Anda.
   • Anda tidak dapat menambahkan hasil ke dasbor yang sudah ada.
5. Klik Tambahkan ke dasbor warisan untuk menambahkan tab hasil ke dasbor warisan baru atau yang sudah ada.
6. Klik salah satu opsi unduhan untuk mengunduh hasil. Lihat deskripsi berikut untuk detail dan batasan.

Hasil unduhan: Anda dapat mengunduh hasil sebagai file CSV, TSV, atau Excel.

Anda dapat mengunduh hingga sekitar 1GB data hasil dari Databricks SQL dalam format CSV dan TSV dan hingga 100.000 baris ke file Excel.

Ukuran unduhan file akhir mungkin sedikit lebih atau kurang dari 1GB, karena batas 1GB 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.

Eksekusi lama

Anda bisa menampilkan eksekusi sebelumnya untuk kueri, termasuk sintaks kueri lengkap. Eksekusi sebelumnya terbuka dalam mode baca-saja dan sertakan tombol untuk Mengkloning ke kueri baru atau Melanjutkan pengeditan. Tab ini tidak menampilkan eksekusi terjadwal.

Menjelajahi hasil

Hasil kueri yang dikembalikan muncul di bawah kueri. Tab Hasil mentah diisi dengan baris yang dikembalikan. Anda dapat menggunakan filter bawaan untuk menyusun ulang hasil dengan nilai naik atau turun. Anda juga dapat menggunakan filter untuk mencari baris hasil yang menyertakan nilai tertentu.

Anda bisa menggunakan tab di panel hasil untuk menambahkan visualisasi, filter, dan parameter.

Memfilter daftar kueri yang disimpan di jendela kueri

Di jendela kueri, Anda bisa memfilter daftar semua kueri menurut daftar kueri yang telah Anda buat (Kueri Saya), menurut favorit, dan menurut tag.

Mengotomatiskan pembaruan

Anda bisa menggunakan tombol Jadwalkan untuk mengatur irama otomatis untuk eksekusi kueri. Pembaruan otomatis dapat membantu menjaga dasbor dan laporan Anda tetap terbarui dengan data terbaru. Kueri terjadwal juga dapat mengaktifkan pemberitahuan Databricks SQL, jenis khusus tugas terjadwal yang mengirim pemberitahuan ketika nilai mencapai ambang yang ditentukan.

Lihat Menjadwalkan kueri.

Lihat Apa itu pemberitahuan Databricks SQL?.

Berbagi kueri

Tombol Bagikan memungkinkan Anda berbagi kueri dengan pengguna lain di ruang kerja Anda. Saat berbagi, pilih antara opsi berikut:

• Jalankan sebagai pemilik (kredensial pemilik): Pengaturan ini berarti bahwa penonton dapat melihat hasil kueri yang sama dengan pemilik kueri. Ini berlaku untuk eksekusi kueri terjadwal atau manual.
• Jalankan sebagai penampil (kredensial pemirsa): Pengaturan ini membatasi hasil ke izin yang ditetapkan penampil.

Lihat Mengonfigurasi izin kueri.

Langkah selanjutnya

Lihat Mengakses dan mengelola kueri tersimpan untuk mempelajari cara bekerja dengan kueri dengan antarmuka pengguna Azure Databricks.