Bagikan melalui


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 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, kemudian pilih Pengaturan select 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.

    cuplikan kueri

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:

  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 autocomplete windowmenggunakan select. Anda juga dapat membuka window secara manual dengan menekan Option + Space dan select cuplikan.

    kueri memilih cuplikan

  4. Jalankan kueri dengan klausa WHERE dari cuplikan kueri.

    memperlihatkan cuplikan yang digunakan dalam 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:

  1. Buka Editor SQL.

  2. Ketik kueri Anda di panel kueri editor SQL.

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

    Kueri menggunakan cuplikan kueri titik penyisipan tanpa nilai default

  4. Masukkan nilai untuk klausa WHERE, seperti 200.

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

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

    Kueri menggunakan cuplikan kueri posisi penyisipan yang berisi nilai bawaan

  7. Ulangi langkah-langkah sebelumnya tetapi select 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.