Cara menggunakan referensi SQL

Berlaku untuk:Ditandai centang ya Databricks SQL Ditandai centang ya Databricks Runtime

Panduan ini menjelaskan cara membaca dan menavigasi referensi bahasa SQL, termasuk label ketersediaan platform dan notasi sintaksis.

Label "Berlaku untuk"

Referensi SQL mencakup Databricks SQL, Databricks Runtime, dan Unity Catalog. Setiap artikel menyertakan label "Berlaku untuk" di dekat bagian atas yang menunjukkan produk dan versi mana yang mendukung fitur tersebut.

Membaca label

Etiket Meaning
centang ditandai ya Pemeriksaan Databricks SQL ditandai ya Databricks Runtime Semua versi Databricks SQL dan Databricks Runtime
centang ditandai ya Databricks SQL Databricks SQL saja (tidak didukung di Databricks Runtime)
centang ditandai ya Pemeriksaan Databricks SQL ditandai ya Databricks Runtime 11.3 LTS ke atas Semua versi Databricks SQL dan Databricks Runtime 11.3 LTS dan yang lebih baru
centang ditandai ya Pemeriksaan Databricks SQL ditandai ya Databricks Runtime 11.3 LTS ke atas ditandai ya Unity Catalog saja Unity Catalog saja, semua versi Databricks SQL, dan Databricks Runtime 11.3 LTS dan yang lebih baru

Label tingkat parameter

Beberapa artikel memiliki label "Berlaku untuk" di label atas dan tambahan untuk parameter tertentu dalam artikel. Label tingkat parameter mengambil alih label tingkat artikel hanya untuk parameter tersebut.

Contoh 1: Parameter memerlukan versi Runtime Databricks minimum

Label artikel: centang tandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime

Label parameter: centang tandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 11.3 LTS ke atas

Ini berarti sebagian besar artikel berlaku untuk semua versi Databricks SQL dan Databricks Runtime, tetapi parameter tertentu tersebut memerlukan Databricks Runtime 11.3 LTS atau yang lebih baru.

Contoh 2: Parameter tidak tersedia untuk beban kerja gudang SQL

Label artikel: centang tandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime

Label parameter: centang bertanda ya Databricks Runtime 11.3 LTS ke atas

Ini berarti sebagian besar halaman berlaku untuk semua versi kedua produk, tetapi parameter spesifik tersebut hanya didukung di Databricks Runtime 11.3 LTS dan yang lebih baru (tidak didukung di Databricks SQL).

Diagram sintaksis

Pernyataan SQL didokumenkan menggunakan diagram sintaksis yang menunjukkan cara membuat perintah yang valid.

Elemen dasar

Diagram sintaks menggunakan komponen dasar ini untuk mewakili pernyataan SQL. Setiap komponen diikuti dengan contoh.

Keyword

Kata kunci muncul dalam huruf besar tetapi tidak peka huruf besar/kecil.

SELECT

Tanda

Karakter harfiah yang harus Anda masukkan persis seperti yang ditunjukkan: (, , )<, >, , *.,

Klausul

Klausul adalah bagian sintaksis bernama. Klausa huruf besar (seperti LIMIT clause) ditautkan ke dokumentasinya. Klausa huruf kecil dengan garis bawah (seperti named_expression) didefinisikan secara lokal.

LIMIT clause
named_expression

Argumen

Argumen fungsi menggunakan camelCase dan dijelaskan di bagian Argumen dari referensi fungsi Databricks SQL.

mapExpr

Notasi sintaks

Simbol khusus menunjukkan bagaimana komponen dapat digabungkan, diulang, atau dihilangkan.

Urutan yang diperlukan

Komponen yang dipisahkan oleh spasi kosong harus muncul secara berurutan.

SELECT expr

Pilihan wajib

Kurung kurawal { } dengan | pemisah berarti Anda harus memilih tepat satu opsi.

{ INT | INTEGER }

Pilihan opsional

Kurung siku [ ] dengan | pemisah berarti Anda dapat memilih paling banyak satu opsi.

[ ASC | DESC ]

Pengelompokan

Kurung kurawal { } tanpa | berarti Anda harus menyertakan semua komponen.

{ SELECT expr }

Elemen opsional

Kurung siku [ ] berarti komponen yang diapit bersifat opsional.

[ NOT NULL ]

Pengulangan

Elipsis [...] berarti Anda dapat mengulangi komponen sebelumnya. Jika didahului oleh pemisah (, ...), Anda harus menggunakan pemisah tersebut di antara pengulangan.

col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]

Komentar

Databricks SQL mendukung komentar gaya C (/* ... */) dan komentar baris (-- ...).

  • Last updated on