Bagikan melalui


Referensi bahasa SQL

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