Cuplikan kueri
Seringkali lebih mudah untuk menduplikasi pekerjaan sebelumnya dan memodifikasi daripada menulis sesuatu dari awal. Ini terutama berlaku untuk pernyataan JOIN
umum atau ekspresi CASE
kompleks. Seiring pertumbuhan list kueri Anda, mungkin akan sulit untuk mengenali kueri mana yang berisi pernyataan yang Anda butuhkan. Anda juga bisa membuat cuplikan kueri yang berisi titik penyisipan dengan teks tempat penampung yang dapat diganti pengguna saat runtime.
Cuplikan kueri adalah segmen kueri yang bisa Anda bagikan dan picu menggunakan lengkapi otomatis. Gunakan cuplikan kueri untuk:
- Pernyataan
JOIN
yang sering - Klausa rumit seperti
WITH
atauCASE
. - Pemformatan bersyarat
Berikut adalah contoh cuplikan:
--Simple snippet
WHERE fare_amount > 100
--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}
--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}
--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}
Membuat cuplikan kueri
Gunakan langkah-langkah berikut untuk membuat cuplikan menggunakan contoh cuplikan ini:
Klik nama pengguna Anda di bilah atas ruang kerja, kemudian pilih Pengaturan select dari menu drop-down.
Klik tab Pengembang.
Di samping cuplikan kueri SQL klik Kelola.
Klik Buat cuplikan kueri.
Di bidang Ganti, masukkan nama cuplikan. Anda akan menggunakan nama ini saat menulis kueri menggunakan cuplikan.
Secara opsional masukkan deskripsi.
Di bidang Cuplikan, masukkan cuplikan.
Klik Buat.
Menggunakan cuplikan kueri dalam kueri
Berikut adalah contoh kueri sederhana di mana Anda dapat menggunakan cuplikan kueri ini:
--Simple query
SELECT * FROM samples.nyctaxi.trips
Gunakan langkah-langkah berikut untuk menggunakan cuplikan kueri dengan kueri ini:
Buka Editor SQL.
Ketik kueri Anda di panel kueri editor SQL.
Ketik 3 huruf pertama dari nama cuplikan, lalu pilih cuplikan dari autocomplete windowmenggunakan select. Anda juga dapat membuka window secara manual dengan menekan
Option
+Space
dan select cuplikan.kueri
Jalankan kueri dengan klausa
WHERE
dari cuplikan kueri.
Bekerja dengan titik penyisipan dalam cuplikan kueri
Anda menunjuk titik penyisipan dengan membungkus urutan tab berupa bilangan bulat dengan satu tanda dolar dan kurung kurawal ${}
. Placeholder teks yang didahului oleh titik dua :
bersifat opsional tetapi berguna bagi pengguna yang asing dengan cuplikan Anda. Dalam cuplikan kueri dengan titik penyisipan yang Anda buat sebelumnya, ${1:value}
adalah titik penyisipan dengan tempat penampung, dan ${1:100}
adalah titik penyisipan dengan nilai default untuk tempat penampung yang bisa Anda gantikan saat waktu menjalankannya. Ketika Databricks SQL merender cuplikan, tanda dolar $
dan kurung kurawal {}
dihilangkan dan kata value
atau default yaitu 100
disorot untuk penggantian.
Ketika ada beberapa titik penyisipan, kursor teks melompat ke titik penyisipan pertama untuk meminta nilai yang diinginkan. Saat Anda menekan Tab
, kursor melompat ke titik berikutnya untuk memasukkan nilai berikutnya. Saat Anda menekan Tab
lagi, kursor akan melompat ke titik penyisipan berikutnya hingga mencapai titik penyisipan akhir.
Nota
Titik penyisipan nol ${0}
selalu menjadi titik terakhir dalam urutan tab.
Gunakan langkah-langkah berikut untuk menggunakan cuplikan kueri titik sisipan dengan kueri:
Buka Editor SQL.
Ketik kueri Anda di panel kueri editor SQL.
Ketik 3 huruf pertama dari nama cuplikan kueri Anda lalu select cuplikan kueri dengan titik penyisipan tanpa nilai default.
Cuplikan kueri ditambahkan ke kueri dan kursor penyisipan teks melompat ke titik penyisipan.
Masukkan nilai untuk klausa
WHERE
, seperti200
.Secara opsional, jalankan kueri dengan klausa
WHERE
dari cuplikan kueri.Ulangi langkah-langkah sebelumnya tetapi select cuplikan kueri dengan titik penyisipan menggunakan nilai default.
Ulangi langkah-langkah sebelumnya tetapi select cuplikan kueri dengan beberapa titik penyisipan.
Masukkan nilai untuk titik penyisipan pertama, tab ke titik penyisipan berikutnya dan masukkan nilai, lalu tab ke titik penyisipan akhir dan masukkan nilai.