適用対象: 
Databricks SQL
構成パラメーターは、設定であり、指定した SQL 構文以外の Databricks SQL の動作に影響を与えます。
構成パラメーターの有効な値は、これが設定されているさまざまなレベルから派生します。
構成パラメーターのスコープ
システム
システム値は、オーバーライドがない場合に、Databricks SQL で使用される既定値です。
グローバル
管理者は、SQL パラメーターの構成または SQL Warehouse API を使用して、パラメーターのシステムの既定値をオーバーライドできます。 この値は、初期値として、新たに確立された進行中の任意のセッションで表示されます。
セッション
ユーザーは SET 文でセッション期間中の設定パラメータをオーバーライドできます。 一部のパラメータには専用の文があり、例えば SET PATH や SET TIME ZONE。 この設定は、ユーザーが再度上書きするか RESETを使うまで有効のままです。
サポートされている構成パラメーター
Databricks SQL で設定可能なサポート対象の構成パラメーター、システムの既定値、および可能な設定先のレベルの一覧を次に示します。 Databricks SQL では、一覧にない Spark 構成の設定はサポートされていません。
| パラメーター名 | 説明 | システムの既定 | グローバルに設定可能 | 設定可能なセッション |
|---|---|---|---|---|
| ANSI_MODE | 特定の関数とキャスト規則に対して、厳密な ANSI SQL 動作を無効にすることができます。 | 真実 | はい | はい |
| LEGACY_TIME_PARSER_POLICY | date と timestamp の解析方法と書式設定方法を制御します。 | 例外 | はい | はい |
| MAX_FILE_PARTITION_BYTES | ファイル ベースのソースからの読み取り時に 1 つのパーティションに取り込める最大バイト数です。 | 128 m | いいえ | はい |
| PATH | 未修格な名前を解決するためのスキーマ検索パスを設定します。 | system.session, system.builtin, system.ai, CURRENT_SCHEMA |
はい | はい |
| READ_ONLY_EXTERNAL_METASTORE | 外部メタストアを読み取り専用として扱うかどうかを制御します。 | 偽 | はい | いいえ |
| STATEMENT_TIMEOUT | SQL ステートメントのタイムアウトを秒単位で設定します。 | 172,800 秒 | はい | はい |
| TIMEZONE | ローカル タイム ゾーンを設定します。 | UTC | はい | はい |
| USE_CACHED_RESULT | 可能な限り、Dabricks SQL を使用して結果をキャッシュおよび再利用するかどうかを制御します。 | 真実 | いいえ | はい |
Databricks SQL 2022.35 より前に追加されたアカウントの場合、ANSI_MODE のシステム既定値は FALSE です。