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