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 bertambahnya daftar kueri Anda, mungkin sulit untuk mengingat kueri mana yang berisi pernyataan yang Anda butuhkan. Anda juga bisa membuat potongan kueri yang berisi titik penyisipan dengan teks tempat penampung yang dapat diganti pengguna ketika aplikasi berjalan.

Cuplikan kueri adalah segmen kueri yang bisa Anda bagikan dan aktifkan menggunakan pelengkapan otomatis. Gunakan cuplikan kueri untuk:

• Pernyataan JOIN yang sering
• Klausa rumit seperti WITH atau CASE.
• 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

Anda bisa membuat cuplikan kueri dari editor SQL, notebook, atau file. Ikuti langkah-langkah ini:

1. Di editor SQL baru, klik menu kebab, lalu klik Tampilkan.

   Di buku catatan atau editor file, klik Tampilkan.

2. Klik Cuplikan kueri.

3. Klik Buat cuplikan kueri.

4. Di bidang Ganti, masukkan nama cuplikan. Anda akan menggunakan nama ini saat menulis kueri yang menggunakan cuplikan.

5. (Opsional) Masukkan deskripsi.

6. Di bidang Cuplikan, masukkan cuplikan.

7. Klik Buat.

   

Menggunakan cuplikan kueri

Cuplikan kueri dapat digunakan kueri SQL apa pun. Anda dapat mengakses cuplikan kueri di editor SQL, sel SQL notebook, file SQL, dan kueri dasbor AI/BI.

Berikut adalah contoh kueri sederhana yang dapat Anda gunakan dengan cuplikan kueri ini:

--Simple query
SELECT * FROM samples.nyctaxi.trips

Gunakan langkah-langkah berikut untuk menggunakan cuplikan kueri dengan kueri ini:

1. Buka Editor SQL.

2. Ketik kueri Anda di panel kueri editor SQL.

3. Mulai ketik nama cuplikan kueri Anda, lalu pilih cuplikan tersebut dari jendela pelengkapan otomatis.

   Di editor SQL, Anda juga dapat membuka jendela secara manual dengan Control+Space dan memilih cuplikan.

   

4. Jalankan kueri dengan klausa WHERE dari cuplikan kueri.

   

Bekerja dengan titik penyisipan data dalam potongan 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} merupakan titik penyisipan dengan nilai default untuk tempat penampung yang bisa Anda ambil alih saat runtime. Ketika Databricks SQL merender cuplikan, tanda dolar $ dan kurung kurawal {} dihilangkan, dan kata value atau default dari 100 disorot untuk diganti.

Ketika ada beberapa titik penyisipan, tanda sisipan teks melompat ke titik penyisipan pertama guna meminta nilai yang diinginkan. Saat Anda menekan Tab, kursor melompat ke titik penyisipan berikutnya untuk nilai selanjutnya. Ketika Anda menekan Tab lagi, tanda sisipan akan melompat ke garis 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:

1. Buka Editor SQL.

2. Ketik kueri Anda di panel kueri editor SQL.

3. Ketik tiga huruf pertama dari nama cuplikan kueri Anda lalu pilih cuplikan kueri dengan titik penyisipan tanpa nilai default.

   Cuplikan kueri yang sesuai ditambahkan ke kueri, dan tanda sisipan teks berpindah ke titik penyisipan.

   

4. Masukkan nilai untuk klausa WHERE, seperti 200.

5. Secara opsional, jalankan kueri dengan WHERE klausa dari cuplikan kueri.

6. Ulangi langkah-langkah sebelumnya, tetapi pilih cuplikan kueri dengan titik penyisipan menggunakan nilai default.

   

7. Ulangi langkah-langkah sebelumnya, tetapi pilih cuplikan kueri dengan beberapa titik penyisipan.

   

8. Masukkan nilai untuk titik penyisipan pertama, tab ke titik penyisipan berikutnya, dan masukkan nilai, lalu tab ke titik penyisipan akhir dan masukkan nilai.