設定參數

適用於:check marked yes 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
ENABLE_PHOTON 控制 Photon 向量化查詢引擎的使用方式。 TRUE No 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
時區 設定當地時區。 UTC Yes Yes
USE_CACHED_RESULT 控制 Databricks SQL 快取並盡可能重複使用結果。 TRUE No Yes

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