設定參數
適用於: 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 | 控制如何剖析和格式化日期和時間。 | EXCEPTION | Yes | Yes |
MAX_FILE_PARTITION_BYTES | 讀取以檔案為基礎的來源時,要封裝成單一分割區的位元組數目上限。 | 128m | No | Yes |
READ_ONLY_EXTERNAL_METASTORE | 控制外部中繼存放區是否被視為唯讀屬性。 | FALSE | 是 | No |
STATEMENT_TIMEOUT | 設定以秒為單位的 SQL 語句逾時 | 172800 秒 | Yes | Yes |
TIMEZONE | 設定當地時區。 | UTC | Yes | Yes |
USE_CACHED_RESULT | 控制 Databricks SQL 快取並盡可能重複使用結果。 | TRUE | No | Yes |
系統 ANSI_MODE
預設值適用於 FALSE
Databricks SQL 2022.35 之前新增的帳戶。