Bagikan melalui


Cuplikan kueri

Sering kali lebih mudah untuk menduplikasi pekerjaan sebelumnya dan memodifikasi daripada menulis sesuatu dari awal. Hal ini terutama berlaku untuk pernyataan umum JOIN atau ekspresi yang kompleks CASE. Seiring bertambahnya daftar kueri Anda, mungkin sulit untuk mengingat 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 dapat Anda bagikan dan picu menggunakan selesai otomatis. Gunakan cuplikan kueri untuk:

  • Pernyataan yang JOIN sering
  • Klausul 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

Gunakan langkah-langkah berikut untuk membuat cuplikan menggunakan contoh cuplikan ini:

  1. Klik nama pengguna Anda di bilah atas ruang kerja dan pilih Pengaturan dari menu drop-down.

  2. Klik tab Pengembang .

  3. Di samping cuplikan kueri SQL klik Kelola.

  4. Klik Buat cuplikan kueri.

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

  6. Secara opsional masukkan deskripsi.

  7. Di bidang Cuplikan, masukkan cuplikan.

  8. Klik Buat.

    Cakupan kueri

Menggunakan cuplikan kueri dalam kueri

Berikut adalah contoh kueri sederhana yang dapat Anda gunakan 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. Ketik 3 huruf pertama dari nama cuplikan lalu pilih cuplikan dari jendela lengkapi otomatis. Anda juga dapat membuka jendela secara manual dengan menekan Option + Space dan memilih cuplikan.

    Kueri memilih cuplikan

  4. Jalankan kueri dengan WHERE klausa dari cuplikan kueri.

    kueri memperlihatkan cuplikan yang digunakan dalam kueri

Bekerja dengan titik penyisipan dalam cuplikan kueri

Anda menunjuk titik penyisipan dengan membungkus urutan tab bilangan bulat dengan tanda dolar tunggal dan kurung kurawal${}. Penampung teks yang didahului oleh titik dua : bersifat opsional tetapi berguna bagi pengguna yang tidak terbiasa 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 dilucuti dan kata value atau default 100 disorot {} untuk penggantian.

Ketika ada beberapa titik penyisipan, karat penyisipan teks melompat ke titik penyisipan pertama untuk meminta nilai yang diinginkan. Saat Anda menekan Tab, karat melompat ke titik penyisipan berikutnya untuk nilai berikutnya. Ketika Anda menekan Tab lagi, karat akan melompat ke garis titik penyisipan berikutnya hingga mencapai titik penyisipan akhir.

Catatan

Titik penyisipan nol ${0} selalu menjadi titik terakhir dalam urutan tab.

Gunakan langkah-langkah berikut untuk menggunakan cuplikan kueri titik penyisipan dengan kueri:

  1. Buka Editor SQL.

  2. Ketik kueri Anda di panel kueri editor SQL.

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

    Cuplikan kueri ditambahkan ke kueri dan karat penyisipan teks melompat ke titik penyisipan.

    Kueri menggunakan cuplikan kueri titik penyisipan tanpa nilai default

  4. Masukkan nilai untuk WHERE klausa, 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.

    Kueri menggunakan cuplikan kueri titik penyisipan yang berisi nilai default

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

    Kueri menggunakan cuplikan kueri titik penyisipan yang berisi 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.