Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Ini adalah referensi perintah SQL untuk Databricks SQL dan Databricks Runtime.
Untuk informasi tentang cara memahami dan menggunakan notasi sintaks dan simbol dalam referensi ini, lihat Cara menggunakan referensi SQL.
Untuk informasi tentang menggunakan SQL dengan Alur Deklaratif Lakeflow Spark, lihat Referensi bahasa Alur SQL.
Note
Databricks SQL Serverless tidak tersedia di Azure Tiongkok. Databricks SQL tidak tersedia di wilayah Azure Government.
Referensi umum
Referensi umum ini menjelaskan jenis data, fungsi, pengidentifikasi, literal, dan semantik.
Dasar-dasar bahasa
| Reference | Deskripsi |
|---|---|
| Menambahkan komentar ke pernyataan SQL | Menambahkan komentar ke kode SQL Anda |
| Kata dan skema yang dipesan | Kata kunci yang dicadangkan oleh pengurai SQL |
| Identifiers | Aturan untuk penamaan objek database |
| Names | Konvensi penamaan objek |
| IDENTIFIER klausa | Resolusi pengidentifikasi dinamis |
| Ekspresi SQL | Sintaks dan evaluasi ekspresi SQL |
| Semantik NULL | Bagaimana nilai NULL ditangani |
| Penanda parameter | Tempat penampung kueri berparameter |
| Variables | Variabel sesi dan sementara |
| Resolusi nama | Bagaimana nama objek diselesaikan |
| Ekspresi jalur JSON | Menavigasi struktur data JSON |
| Collation | Perbandingan string dan aturan pengurutan |
| Partitions | Konsep pemartisian tabel |
Jenis data
| Reference | Deskripsi |
|---|---|
| Jenis data | Gambaran umum semua jenis data yang didukung |
| aturan jenis data SQL | Ketik aturan koersi dan konversi |
| Pola tanggalwaktu | Memformat pola untuk tanggal dan waktu |
Parameter konfigurasi
| Reference | Deskripsi |
|---|---|
| Parameter konfigurasi | Gambaran umum konfigurasi SQL |
| ANSI_MODE | Mode kepatuhan ANSI SQL |
| LEGACY_TIME_PARSER_POLICY | Perilaku penguraian waktu |
| MAX_FILE_PARTITION_BYTES | Batas ukuran partisi file |
| READ_ONLY_EXTERNAL_METASTORE | Mode akses metastore eksternal |
| STATEMENT_TIMEOUT | Pengaturan batas waktu kueri |
| TIMEZONE | Zona waktu sesi |
| USE_CACHED_RESULT | Penembolokan hasil kueri |
Functions
| Reference | Deskripsi |
|---|---|
| Functions | Gambaran umum fungsi SQL |
| Fungsi bawaan | Semua fungsi bawaan |
| Daftar alfabet fungsi bawaan | Referensi fungsi A-Z lengkap |
| Fungsi jendela | Fungsi analitik dan peringkat |
| Fungsi Lambda | Ekspresi fungsi anonim |
| Fungsi geospasial H3 | Indeks spasial hierarkis heksagonal |
| Fungsi geospasial ST | Fungsi geospasial standar |
| Fungsi agregat yang ditentukan pengguna | Fungsi agregasi kustom |
| Fungsi skalar eksternal yang ditentukan pengguna (UDF) | Fungsi skalar kustom |
| Integrasi dengan Apache Hive UDF, UDAF, dan UDTF | Kompatibilitas fungsi Apache Hive |
| Pemanggilan fungsi | Cara memanggil fungsi |
Konsep Unity Catalog
| Reference | Deskripsi |
|---|---|
| Kepala sekolah | Pengguna, grup, dan perwakilan layanan |
| Hak Istimewa dan objek yang dapat diamankan di Katalog Unity | Kontrol akses di Katalog Unity |
| Hak istimewa dan objek yang dapat diamankan di metastore Hive | Kontrol akses metastore warisan |
| Lokasi eksternal | Lokasi penyimpanan cloud |
| Tabel eksternal | Tabel yang didukung oleh data eksternal |
| Credentials | Kredensial akses penyimpanan |
| Volumes | Penyimpanan file terkelola dan eksternal |
Topik khusus
| Reference | Deskripsi |
|---|---|
| Kepatuhan ANSI dalam Databricks Runtime | Kompatibilitas standar ANSI SQL |
| Kompatibilitas Apache Hive | Kompatibilitas Apache Hive SQL |
| Pembuatan skrip SQL | Logika SQL prosedural |
| Berbagi Delta | Berbagi data lintas organisasi |
| Kueri gabungan (Federasi Lakehouse) | Mengkueri database eksternal |
| Skema informasi | Tabel sistem metadata |
Pernyataan DDL
Pernyataan definisi data membuat atau mengubah struktur objek database.
Pernyataan ALTER
| Statement | Deskripsi |
|---|---|
| ALTER CATALOG | Mengubah properti katalog |
| ALTER CONNECTION | Mengubah pengaturan koneksi |
| ALTER CREDENTIAL | Mengubah properti kredensial |
| ALTER DATABASE | Mengubah properti database |
| ALTER EXTERNAL LOCATION | Mengubah lokasi eksternal |
| ALTER MATERIALIZED VIEW | Memodifikasi tampilan materialisasi |
| ALTER PROVIDER | Mengubah penyedia data |
| ALTER RECIPIENT | Mengubah penerima berbagi |
| ALTER SCHEMA | Mengubah properti skema |
| ALTER SHARE | Mengubah konfigurasi berbagi |
| ALTER STREAMING TABLE | Mengubah tabel streaming |
| ALTER TABLE | Mengubah struktur tabel |
| ALTER VIEW | Ubah definisi tampilan |
| ALTER VOLUME | Mengubah properti volume |
Pernyataan CREATE
| Statement | Deskripsi |
|---|---|
| CREATE BLOOM FILTER INDEX | Membuat indeks filter mekar |
| CREATE CATALOG | Membuat katalog baru |
| CREATE CONNECTION | Membuat koneksi eksternal |
| CREATE DATABASE | Buat database baru |
| CREATE FUNCTION (SQL dan Python) | Membuat fungsi SQL |
| CREATE FUNCTION (Eksternal) | Membuat fungsi eksternal |
| CREATE EXTERNAL LOCATION | Membuat lokasi eksternal |
| CREATE MATERIALIZED VIEW | Membuat tampilan materialisasi |
| BUAT PROSEDUR | Membuat prosedur tersimpan |
| CREATE RECIPIENT | Membuat penerima berbagi |
| CREATE SCHEMA | Membuat skema baru |
| CREATE SERVER | Membuat server asing |
| CREATE SHARE | Membuat berbagi data |
| CREATE STREAMING TABLE | Membuat tabel streaming |
| CREATE TABLE | Membuat tabel baru |
| CREATE VIEW | Buat tampilan |
| CREATE VOLUME | Membuat volume |
Pernyataan DROP
Menganalisis pernyataan
Pernyataan DDL lainnya
| Statement | Deskripsi |
|---|---|
| COMMENT ON | Menambahkan komentar ke objek |
| DECLARE VARIABLE | Mendeklarasikan variabel sesi |
| REPAIR TABLE | Memulihkan partisi tabel |
| REFRESH FOREIGN (CATALOG, SCHEMA, dan TABLE) | Refresh metadata asing |
| REFRESH (MATERIALIZED VIEW atau STREAMING TABLE) | Menyegarkan data materialisasi |
| SET TAG | Menambahkan tag ke objek |
SYNC |
Menyinkronkan metadata |
| TRUNCATE TABLE | Menghapus semua data tabel |
| UNDROP | Memulihkan tabel yang dihilangkan |
| UNSET TAG | Menghapus tag dari objek |
Pernyataan DML
Pernyataan manipulasi data menambahkan, mengubah, atau menghapus data dalam tabel Delta Lake.
| Statement | Deskripsi |
|---|---|
COPY INTO |
Memuat data dari file ke dalam tabel |
| DELETE FROM | Menghapus baris dari tabel |
| INSERT | Menyisipkan baris ke dalam tabel |
| INSERT OVERWRITE DIRECTORY | Menulis hasil kueri ke direktori |
| INSERT OVERWRITE DIRECTORY dengan format Hive | Menulis hasil dalam format Apache Hive |
| LOAD DATA | Memuat data dari file |
| MERGE INTO | Meningkatkan data ke dalam tabel |
| UPDATE | Memperbarui baris dalam tabel |
Pernyataan pengambilan data
Mengambil baris dari tabel sesuai dengan klausul yang ditentukan. Azure Databricks mendukung sintaks standar SELECT dan Sintaks Alur SQL.
Pernyataan kueri
| Statement | Deskripsi |
|---|---|
| Query | Referensi sintaks kueri penuh |
| SELECT (pilihan lanjutan) | Memilih data dari tabel |
| VALUES klausa | Membuat tabel sebaris |
| sintaks alur SQL | Komposisi kueri berbasis pipa |
| EXPLAIN | Perlihatkan rencana eksekusi kueri |
Klausa kueri
| Klausul | Deskripsi |
|---|---|
| SELECT klausa | Pilihan kolom |
| * Klausul (bintang) | Pilih semua kolom |
| referensi tabel | Sumber tabel dan subkueri |
| JOIN | Menggabungkan baris dari tabel |
| WHERE klausa | Memfilter baris |
| GROUP BY klausa | Mengelompokkan baris untuk agregasi |
| HAVING klausa | Memfilter baris yang dikelompokkan |
| QUALIFY klausa | Memfilter hasil fungsi jendela |
| ORDER BY klausa | Mengurutkan baris hasil |
| SORT BY klausa | Mengurutkan dalam partisi |
| klausa CLUSTER BY (SELECT) | Mendistribusikan dan mengurutkan data |
| DISTRIBUTE BY klausa | Mendistribusikan data di seluruh partisi |
| LIMIT klausa | Batasi baris hasil |
| OFFSET klausa | Lewati baris hasil |
| PIVOT klausa | Memutar baris ke kolom |
| UNPIVOT klausa | Memutar kolom ke baris |
| LATERAL VIEW klausa | Menerapkan fungsi pembuatan tabel |
| TABLESAMPLE klausa | Contoh baris tabel |
| pemanggilan fungsi bernilai tabel (TVF) | Fungsi yang mengembalikan tabel |
| ekspresi tabel umum (CTE) | Subkueri bernama |
| Operator Set | UNION, INTERSECT, EXCEPT |
| WINDOW klausa | Definisi jendela bernama |
| Petunjuk | Petunjuk pengoptimal kueri |
Pernyataan Delta Lake
Kelola tabel yang disimpan dalam format Delta Lake. Untuk detailnya, lihat Apa itu Delta Lake di Azure Databricks?.
| Statement | Deskripsi |
|---|---|
| CACHE SELECT | Hasil kueri cache |
| CONVERT TO DELTA | Mengonversi Parquet ke Delta |
| DESCRIBE HISTORY | Perlihatkan riwayat tabel |
| FSCK REPAIR TABLE | Perbaiki metadata tabel |
| GENERATE | Membuat manifes tabel |
| OPTIMIZE | File tabel ringkas |
| REORG TABLE | Mengatur ulang data tabel |
| RESTORE | Pulihkan tabel ke versi sebelumnya |
| VACUUM | Menghapus file tabel lama |
Pernyataan pembuatan skrip SQL
Jalankan logika prosedural di SQL. Lihat Pembuatan skrip SQL untuk gambaran umum.
| Statement | Deskripsi |
|---|---|
| BEGIN END pernyataan gabungan | Mengelompokkan pernyataan ke dalam blok |
| Pernyataan CASE | Percabangan bersyarat |
| Pernyataan FOR | Mengulang rentang atau kursor |
| GET pernyataan diagnostik | Mengambil informasi eksekusi |
| pernyataan IF THEN ELSE | Eksekusi bersyarah |
| Pernyataan ITERATE | Lanjutkan ke perulangan perulangan berikutnya |
| Pernyataan LEAVE | Keluar dari perulangan atau blok |
| Pernyataan LOOP | Perulangan tanpa syarat |
| Pernyataan REPEAT | Perulangan hingga kondisi benar |
| Pernyataan RESIGNAL | Menaikkan kembali pengecualian |
| Statement SIGNAL | Menaikkan pengecualian |
| Pernyataan WHILE | Perulangan sementara kondisi benar |
Pernyataan tambahan
Kumpulkan statistik, kelola penembolokan, jelajahi metadata, atur konfigurasi, dan kelola sumber daya.
Pernyataan ANALYZE
| Statement | Deskripsi |
|---|---|
| ANALYZE TABLE ... STATISTIK KOMPUTASI | Statistik kolom tabel komputasi |
| ANALYZE TABLE ... METRIK PENYIMPANAN KOMPUTASI | Menghitung metrik penyimpanan tabel |
Pernyataan cache
Berlaku untuk: Databricks Runtime
| Statement | Deskripsi |
|---|---|
| CACHE TABLE | Tabel cache dalam memori |
| CLEAR CACHE | Menghapus semua data yang di-cache |
| REFRESH CACHE | Merefresh data yang di-cache |
| REFRESH FUNCTION | Refresh metadata fungsi |
| REFRESH TABLE | Refresh metadata tabel |
| UNCACHE TABLE | Menghapus tabel dari cache |
Pernyataan DESCRIBE
| Statement | Deskripsi |
|---|---|
| DESCRIBE CATALOG | Tampilkan detail katalog |
| DESCRIBE CONNECTION | Perlihatkan detail koneksi |
| DESCRIBE CREDENTIAL | Perlihatkan detail kredensial |
| DESCRIBE DATABASE | Perlihatkan detail database |
| DESCRIBE FUNCTION | Perlihatkan detail fungsi |
| DESCRIBE EXTERNAL LOCATION | Perlihatkan detail lokasi |
| MENJELASKAN PROSEDUR | Perlihatkan detail prosedur |
| DESCRIBE PROVIDER | Perlihatkan detail penyedia |
| DESCRIBE QUERY | Perlihatkan skema output kueri |
| DESCRIBE RECIPIENT | Perlihatkan detail penerima |
| DESCRIBE SCHEMA | Perlihatkan detail skema |
| DESCRIBE SHARE | Perlihatkan detail berbagi |
| DESCRIBE TABLE | Perlihatkan detail tabel |
| DESCRIBE VOLUME | Perlihatkan detail volume |
Pernyataan SHOW
| Statement | Deskripsi |
|---|---|
| LIST | Mencantumkan file dalam jalur |
| SHOW ALL IN SHARE | Perlihatkan semua objek yang dibagikan |
| SHOW CATALOGS | Mencantumkan katalog |
| SHOW COLUMNS | Mencantumkan kolom tabel |
| SHOW CONNECTIONS | Daftar koneksi |
| SHOW CREATE TABLE | Perlihatkan tabel DDL |
| SHOW CREDENTIALS | Mencantumkan kredensial |
| SHOW DATABASES | Mencantumkan database |
| SHOW FUNCTIONS | Daftar fungsi |
| SHOW GROUPS | Mencantumkan grup |
| SHOW EXTERNAL LOCATIONS | Mencantumkan lokasi eksternal |
| SHOW PARTITIONS | Mencantumkan partisi tabel |
| TAMPILKAN PROSEDUR | Prosedur daftar |
| SHOW PROVIDERS | Penyedia daftar |
| SHOW RECIPIENTS | Daftar penerima |
| SHOW SCHEMAS | Mencantumkan skema |
| SHOW SHARES | Mencantumkan berbagi |
| SHOW SHARES IN PROVIDER | Mencantumkan berbagi dari penyedia |
| SHOW TABLE EXTENDED | Perlihatkan informasi tabel |
| SHOW TABLES | Daftar tabel |
| SHOW TABLES DROPPED | Daftar tabel yang dihilangkan |
| SHOW TBLPROPERTIES | Perlihatkan properti tabel |
| SHOW USERS | Mencantumkan pengguna |
| SHOW VIEWS | Tampilan daftar |
| SHOW VOLUMES | Mencantumkan volume |
Manajemen konfigurasi dan variabel
| Statement | Deskripsi |
|---|---|
| CALL | Memanggil prosedur tersimpan |
| EXECUTE IMMEDIATE | Jalankan SQL dinamis |
| RESET | Reset konfigurasi ke default |
| SET | Mengatur parameter konfigurasi |
| SET RECIPIENT | Mengatur konteks penerima berbagi |
| SET TIME ZONE | Mengatur zona waktu sesi |
| SET variabel | Atur nilai variabel |
| USE CATALOG | Atur katalog saat ini |
| USE DATABASE | Mengatur database saat ini |
| USE SCHEMA | Atur skema saat ini |
Manajemen sumber daya
Berlaku untuk: Databricks Runtime
| Statement | Deskripsi |
|---|---|
| ADD ARCHIVE | Menambahkan arsip ke sesi |
| ADD FILE | Menambahkan file ke sesi |
| ADD JAR | Menambahkan JAR ke sesi |
| LIST ARCHIVE | Mencantumkan arsip sesi |
| LIST FILE | Mencantumkan file sesi |
| LIST JAR | Daftar JAR sesi |
Berlaku untuk: Konektor SQL Databricks
| Statement | Deskripsi |
|---|---|
| GET | Mengunduh file dari volume |
| PUT INTO | Unggah file ke volume |
| REMOVE | Menghapus file dari volume |
Pernyataan keamanan
Mengelola akses ke data. Untuk detailnya, lihat Hak istimewa metastore Apache Hive dan objek yang dapat diamankan (warisan).
| Statement | Deskripsi |
|---|---|
| ALTER GROUP | Mengubah keanggotaan grup |
| CREATE GROUP | Membuat grup baru |
| DENY | Menolak hak istimewa |
| DROP GROUP | Menghapus grup |
| GRANT | Memberikan hak istimewa |
| GRANT ON SHARE | Memberikan akses berbagi |
| MSCK REPAIR PRIVILEGES | Perbaiki metadata hak istimewa |
| REVOKE | Mencabut hak istimewa |
| REVOKE ON SHARE | Mencabut akses berbagi |
| SHOW GRANTS | Tampilkan hak istimewa yang diberikan |
| SHOW GRANTS ON SHARE | Perlihatkan hak istimewa berbagi |
| SHOW GRANTS TO RECIPIENT | Perlihatkan hak istimewa penerima |