組態參數

適用於:核取記號為「是」 Databricks SQL

組態參數是一種設定,會影響指定 SQL 語法以外的 Databricks SQL 行為。

組態參數的有效值衍生自設定的不同層級。

組態參數範圍

  • 系統

    如果沒有任何覆寫,則系統值是 Databricks SQL 所使用的預設值。

  • 全球

    系統管理員可以使用設定 SQL 參數或SQL 倉儲 API來覆寫參數的系統預設值。 此值接著是任何新建立會話向前移動所看到的初始值。

  • 會話

    使用者可以在會話期間內用該SET語句覆蓋設定參數。 有些參數有專用的陳述句,例如 SET PATH 或 SET TIME ZONE。 該設定會持續生效,直到使用者再次覆寫或使用 RESET。

支援的組態參數

以下是您可以在 Databricks SQL 中設定的支援組態參數清單、其系統預設值,以及可設定的層級。 Databricks SQL 不支援設定未列出的 Spark 組態。

參數名稱 描述 系統預設 全域可設定 可設定的會話
ANSI_MODE 可讓您針對特定函式和轉換規則停用嚴格的 ANSI SQL 行為。 是真的 是的 是的
LEGACY_TIME_PARSER_POLICY 控制日期和時間戳記的剖析與格式化方式。 例外 是的 是的
MAX_FILE_PARTITION_BYTES 從檔案型來源讀取時,單一分割區所能打包的最大位元組數目。 128m 否 是的
PATH 設定用於解析未限定名稱的結構搜尋路徑。 system.session, system.builtin, system.ai, CURRENT_SCHEMA 是的 是的
READ_ONLY_EXTERNAL_METASTORE 控制外部中繼存放區是否設定為唯讀狀態。 錯誤 是的 否
STATEMENT_TIMEOUT 設定 SQL 語句的逾時秒數 172800 秒 是的 是的
TIMEZONE 設定當地時區。 UTC 是的 是的
USE_CACHED_RESULT 控制 Databricks SQL 快取並盡可能重複使用結果。 是真的 否 是的

系統 ANSI_MODE 預設值適用於 FALSE Databricks SQL 2022.35 之前新增的帳戶。