組態參數
適用於：
Databricks SQL
組態參數是一種設定，會影響指定 SQL 語法以外的 Databricks SQL 行為。
組態參數的有效值衍生自設定的不同層級。
組態參數範圍
系統
如果沒有任何覆寫，則系統值是 Databricks SQL 所使用的預設值。
全球
系統管理員可以使用設定 SQL 參數或SQL 倉儲 API來覆寫參數的系統預設值。 此值接著是任何新建立會話向前移動所看到的初始值。
會話
使用者可以使用 SET 指令，在會話範圍內暫時覆寫組態參數。 除非使用者再次以 SET 語句 或 RESET覆寫，否則此設定在會話期間會持續有效。
支援的組態參數
以下是您可以在 Databricks SQL 中設定的支援組態參數清單、其系統預設值，以及可設定的層級。 Databricks SQL 不支援設定未列出的 Spark 組態。
| 參數名稱 | 描述 | 系統預設 | 全域可設定 | 可設定的會話 |
|---|---|---|---|---|
| ANSI_MODE | 可讓您針對特定函式和轉換規則停用嚴格的 ANSI SQL 行為。 | TRUE | Yes | Yes |
| LEGACY_TIME_PARSER_POLICY | 控制日期和時間戳記的剖析與格式化方式。 | 例外 | Yes | Yes |
| MAX_FILE_PARTITION_BYTES | 從檔案型來源讀取時，單一分割區所能打包的最大位元組數目。 | 128m | 否 | Yes |
| READ_ONLY_EXTERNAL_METASTORE | 控制外部中繼存放區是否設定為唯讀狀態。 | 錯誤 | Yes | 否 |
| STATEMENT_TIMEOUT | 設定 SQL 語句的逾時秒數 | 172800 秒 | Yes | Yes |
| TIMEZONE | 設定當地時區。 | UTC | Yes | Yes |
| USE_CACHED_RESULT | 控制 Databricks SQL 快取並盡可能重複使用結果。 | TRUE | 否 | Yes |
系統 ANSI_MODE 預設值適用於 FALSE Databricks SQL 2022.35 之前新增的帳戶。