SQL 語言參考

這是 Databricks SQL 和 Databricks Runtime 的 SQL 命令參考。

關於如何理解及使用本參考中的語法符號與符號,請參閱 「如何使用 SQL 參考」。

關於使用 SQL 搭配 Lakeflow 管線的資訊,請參閱管線 SQL 語言參考。

Note

Databricks SQL Serverless 在中國 Azure 上無法使用。 Databricks SQL 在 Azure Government 區域中無法使用。

一般參考

此一般參考描述資料型別、函式、識別碼、文字及語意。

語言基礎

Reference Description
為 SQL 陳述式新增註解 在你的 SQL 程式碼中加入註解
保留字與架構 關鍵字由 SQL 解析器保留
識別碼 資料庫物件命名規則
名稱 物件命名慣例
IDENTIFIER 子句 動態識別碼解析
SQL 表達式 SQL 表達式語法與評估
NULL 語意 NULL 值的處理方式
參數標記 參數化查詢佔位符
變數 會話與暫存變數
名稱解析 物件名稱的解析方式
JSON 路徑表達式 導航 JSON 資料結構
排序 字串比較與排序規則
分割區 資料表分割概念

數據類型

Reference Description
資料類型 所有支援資料型態概述
SQL 資料型別規則 型別強制與轉換規則
日期時間模式 日期與時間的格式模式

設定參數

Reference Description
設定參數 SQL 設定概述
ANSI_MODE ANSI SQL 合規模式
LEGACY_TIME_PARSER_POLICY 時間解析行為
MAX_FILE_PARTITION_BYTES 檔案分割區大小限制
READ_ONLY_EXTERNAL_METASTORE 外部中繼儲存存取模式
STATEMENT_TIMEOUT 查詢逾時設定
TIMEZONE 會話時區
USE_CACHED_RESULT 查詢結果快取

Functions

Reference Description
功能 SQL 函式概述
內建功能 所有內建功能
內建函數的字母順序列表 完整的 A-Z 函數參考
視窗功能 分析與排名函數
Lambda 函數 匿名函數表達式
H3 地理空間函數 六角形階層空間索引
ST 地理空間功能 標準地理空間函數
IP 功能 IP 功能
使用者自訂聚合函數(UDAF) 自訂聚合函數
外部使用者定義標量函數(UDF) 自訂純量函數
與 Hive UDF、UDAF 及 UDTF 的整合 蜂巢功能相容性
功能調用 如何呼叫函式

Unity 目錄概念

Reference Description
校長 使用者、群組與服務主體
Unity 目錄中的權限與可保護物件 Unity 目錄中的訪問控制
Hive 中繼儲存庫中的權限與可保護物件 舊有的元儲存存取控制
外部地點 雲端儲存地點
外部資料表 以外部資料為後盾的表格
認證 儲存存取憑證
磁碟區 管理與外部檔案儲存

專題

Reference Description
Databricks 執行時中的 ANSI 合規 ANSI SQL 標準相容性
Apache Hive 相容性 Hive SQL 相容性
SQL 腳本 程序式 SQL 邏輯
授權使用者與會話使用者 跨視圖、UDF 與程序的授權
OpenSharing 跨組織資料共享
聯合查詢(Lakehouse 聯盟) 查詢外部資料庫
資訊結構 元資料系統表格

DDL 陳述式

資料定義語句用來建立或修改資料庫物件的結構。

ALTER 陳述式

Statement Description
ALTER CATALOG 修改目錄屬性
ALTER CONNECTION 修改連線設定
ALTER CREDENTIAL 修改憑證屬性
ALTER DATABASE 修改資料庫屬性
ALTER EXTERNAL LOCATION 修改外部位置
ALTER MATERIALIZED VIEW 修改具體化視圖
ALTER PROVIDER 修改資料提供者
ALTER RECIPIENT 修改分享收件人
ALTER SCHEMA 修改結構屬性
ALTER SHARE 修改分享設定
ALTER STREAMING TABLE 修改串流表
ALTER TABLE 修改數據表結構
ALTER VIEW 修改視圖定義
ALTER VOLUME 修改體積屬性

CREATE 陳述式

Statement Description
CREATE BLOOM FILTER INDEX (已廢止) 建立布隆過濾索引(已棄用)
CREATE CATALOG 建立新目錄
CREATE CONNECTION 建立外部連結
CREATE DATABASE 建立新資料庫
CREATE FUNCTION(SQL、Python、Scala 與 Java) 建立 SQL 函式
CREATE FUNCTION (外部) 建立外部功能
CREATE EXTERNAL LOCATION 建立外部位置
CREATE MATERIALIZED VIEW 建立具體化檢視
建立政策 建立列過濾器或欄位遮罩政策
建立程序 建立儲存程序
CREATE RECIPIENT 建立分享收件人
CREATE SCHEMA 建立新的結構
CREATE SERVER 建立外部伺服器
CREATE SHARE 建立資料分享
CREATE STREAMING TABLE 建立串流表
CREATE TABLE 建立新表格
CREATE TABLE ...流程 建立由流程撰寫的受管理資料表
CREATE VIEW 建立視圖
CREATE VOLUME 建立磁碟區

DROP 語句

Statement Description
DROP BLOOM FILTER INDEX 滴落式蓬鬆濾波器指數(已淘汰)
DROP CATALOG 發佈目錄
DROP CONNECTION 斷開外部連線
DROP CREDENTIAL 丟棄儲存憑證
DROP DATABASE 卸除資料庫
DROP FUNCTION 捨棄一個函數
DROP EXTERNAL LOCATION 丟棄外部位置
退選政策 移除列過濾器或欄位遮罩策略
DROP 程序 丟棄儲存程序
DROP PROVIDER Drop Share 供應商
DROP RECIPIENT 掉落分享接收者
DROP SCHEMA 放棄一個架構
DROP SHARE 丟棄資料分享
DROP TABLE 刪除表格
DROP VARIABLE Drop session 變數
DROP VIEW 卸除檢視
DROP VOLUME 卸除磁碟區

分析陳述

其他 DDL 陳述式

Statement Description
COMMENT ON 在物件上新增註解
DECLARE VARIABLE 宣告 session 變數
REPAIR TABLE 恢復資料表分割區
REFRESH FOREIGN(,CATALOGSCHEMA , , 和TABLE) 刷新外部元資料
REFRESH (MATERIALIZED VIEW 或 STREAMING TABLE) 刷新物質化資料
SET 標籤 為物件新增標籤
SYNC 同步元資料
TRUNCATE TABLE 移除所有資料表資料
UNDROP 還原遺失的表格
聯合國DROP VOLUME 還原掉落的音量
UNSET 標籤 移除物件上的標籤

DML 聲明

資料操作語句用於新增、變更或刪除 Delta Lake 資料表中的資料。

Statement Description
COPY INTO 將檔案資料載入資料表
DELETE FROM 從表格中刪除資料列
INSERT 在表格中插入列
INSERT OVERWRITE DIRECTORY 將查詢結果寫入目錄
INSERT OVERWRITE DIRECTORY 採用 Hive 格式 以 Hive 格式寫入結果
LOAD DATA 從檔案載入資料
MERGE INTO Upsert 資料匯入表格
UPDATE 更新資料表中的資料列

數據檢索敘述

根據指定子句從資料表中擷取資料列。 Azure Databricks 支援標準的 SELECT 語法與 SQL 管線語法。

查詢語句

Statement Description
查詢 完整查詢語法參考
SELECT (子選) 從表格中選取資料
VALUES 子句 構造內列表格
SQL 管線語法 基於管道的查詢組合
EXPLAIN 顯示查詢執行計畫

查詢子句

條款 Description
SELECT 子句 欄選取
*(星號)子句 選取所有欄位
表格參考 表格與子查詢來源
JOIN 從表格中合併資料列
WHERE 子句 篩選行
GROUP BY 子句 聚合用的群組列
HAVING 子句 濾波器分組列
QUALIFY 子句 濾波器視窗函數結果
ORDER BY 子句 排序結果列
SORT BY 子句 分割區內排序
CLUSTER BY 條款 (SELECT) 分發與排序資料
DISTRIBUTE BY 子句 資料分散到不同分割區
LIMIT 子句 結果列限制
OFFSET 子句 跳過結果列
MATCH_RECOGNIZE 條款 尋找並篩選行模式
PIVOT 子句 將列旋轉成欄
UNPIVOT 子句 將欄位旋轉為列
LATERAL VIEW 子句 套用表格生成函數
TABLESAMPLE 子句 範例表格列
表值函數(TVF)調用 函式回傳資料表
共用資料表表達式(CTE) 具名子查詢
集合運算子 聯合、交錯,除了
WINDOW 子句 命名視窗定義
提示 查詢優化器提示

三角湖聲明

管理以 Delta Lake 格式儲存的資料表。 詳情請參見三角洲湖在Azure Databricks?。

Statement Description
CACHE SELECT 快取查詢結果
CONVERT TO DELTA 將Parquet改為Delta
DESCRIBE HISTORY 展台歷史
FSCK REPAIR TABLE 修復表元資料
GENERATE 產生資料表清單
OPTIMIZE 精簡表格檔案
REORG TABLE 重新組織資料表資料
RESTORE 還原到先前版本
VACUUM 移除舊的表格檔案

SQL 腳本語句

用 SQL 執行程序邏輯。 請參見 SQL 腳本 以獲得概述。

Statement Description
開始 結束複合語句 將陳述集組成區塊
CASE 陳述式 條件分支
FOR 陳述 繞過一個範圍或游標
GET DIAGNOSTICS 陳述式 取得執行資訊
IF THEN ELSE 陳述式 條件式執行
重複陳述 繼續進入下一個迴圈迭代
LEAVE 陳述式 退出迴圈或區塊
LOOP 陳述式 無條件迴圈
REPEAT 陳述式 循環直到條件為真
RESIGNAL 陳述式 重新提出例外
SIGNAL 陳述式 提出例外
WHILE 陳述式 迴圈 while 條件為真

輔助陳述式

收集統計數據、管理快取、探索元資料、設定設定及管理資源。

ANALYZE 語句

Statement Description
ANALYZE TABLE … 計算統計 計算表格欄位統計量
ANALYZE TABLE … 運算儲存指標 計算資料表儲存的指標

快取陳述式

適用於: Databricks 執行環境

Statement Description
CACHE TABLE 記憶體中的快取表
CLEAR CACHE 移除所有快取資料
REFRESH CACHE 刷新快取資料
REFRESH FUNCTION 刷新函數元資料
REFRESH TABLE 刷新資料表元資料
UNCACHE TABLE 從快取中移除資料表

DESCRIBE 語句

Statement Description
DESCRIBE CATALOG 節目目錄詳情
DESCRIBE CONNECTION 顯示連接詳情
DESCRIBE CREDENTIAL 顯示證件詳情
DESCRIBE DATABASE 節目資料庫詳情
DESCRIBE FUNCTION 顯示功能細節
DESCRIBE EXTERNAL LOCATION 顯示地點詳情
說明政策 顯示原則詳細數據
說明程序 節目程序細節
DESCRIBE PROVIDER 顯示提供者詳情
DESCRIBE QUERY 顯示查詢輸出結構
DESCRIBE RECIPIENT 節目收件人資料
DESCRIBE SCHEMA 顯示結構細節
DESCRIBE SHARE 節目分享詳情
DESCRIBE TABLE 展示桌詳情
DESCRIBE VOLUME 節目卷數詳情

SHOW 語句

Statement Description
LIST 路徑中的檔案列表
SHOW ALL IN SHARE 顯示所有共享物件
SHOW CATALOGS 列表目錄
SHOW COLUMNS 列表表欄位
SHOW CONNECTIONS 列出連線
SHOW CREATE TABLE 展示台 DDL
SHOW CREDENTIALS 名單資歷
SHOW DATABASES 列表資料庫
SHOW FUNCTIONS 列出功能
SHOW GROUPS 列表群組
SHOW EXTERNAL LOCATIONS 外部地點列表
SHOW PARTITIONS 列表表劃分
顯示政策 列出擔保資產上的保單
顯示程序 列表程序
SHOW PROVIDERS 列表提供者
SHOW RECIPIENTS 得獎者名單
SHOW SCHEMAS 列出模式
SHOW SHARES 名單份額
SHOW SHARES IN PROVIDER 供應商提供的清單分享
SHOW TABLE EXTENDED 展覽桌資訊
SHOW TABLES 表格清單
SHOW TABLES DROPPED 列表遺失表格
SHOW TBLPROPERTIES 顯示表屬性
SHOW USERS 列出使用者
SHOW VIEWS 清單檢視
SHOW VOLUMES 列表卷冊
SHOW VOLUMES 已放棄 已刪除的清單卷數

設定與變數管理

Statement Description
CALL 呼叫一個儲存程序
EXECUTE IMMEDIATE 執行動態 SQL
RESET 將設定重設為預設值
SET 設定設定參數
SET 路徑 設定會話結構搜尋路徑
SET RECIPIENT 設定分享接收者上下文
SET TIME ZONE 設定會話時區
SET 變數 設定變數值
USE CATALOG 現行目錄
USE DATABASE 設定目前資料庫
USE SCHEMA 設定電流結構

資源管理

適用於: Databricks 執行環境

Statement Description
ADD ARCHIVE 將歸檔加入會話
ADD FILE 將檔案加入會話
ADD JAR 將 JAR 加入會話
LIST ARCHIVE 列表會議檔案
LIST FILE 清單會話檔案
LIST JAR 列表會話 JAR

適用於: Databricks SQL 連接器

Statement Description
GET 從卷中下載檔案
PUT INTO 上傳檔案到卷
REMOVE 從卷中刪除檔案

安全聲明

管理資料存取權限。 詳情請參見 Hive 元儲存權限與可保護物件(舊有)。

Statement Description
ALTER GROUP 修改群組成員資格
CREATE GROUP 建立新的群組
DENY 拒絕特權
DROP GROUP 刪除群組
GRANT 授予權限
GRANT ON SHARE 補助份額存取權
MSCK REPAIR PRIVILEGES 修復權限元資料
REVOKE 撤銷特權
REVOKE ON SHARE 撤銷分享存取權
SHOW GRANTS 展覽授予的特權
SHOW GRANTS ON SHARE 節目分享權限
SHOW GRANTS TO RECIPIENT 節目收禮者特權