適用対象:
Databricks SQL
STATEMENT_TIMEOUT構成パラメーターは、タイムアウト時間を秒単位で指定します。 カウントは、SQL ステートメントの実行の開始時に開始されます。 実行時間がこの値を超える Databricks SQL ステートメントはタイムアウトになります。
このパラメーターは、次の 3 つのスコープで設定できます。
- セッション:現在のセッション内のステートメントに適用されます。 SET ステートメントを使用します。
- ウェアハウス:特定のSQLウェアハウス上で実行されるすべてのステートメントに適用されます。 SQL Warehouses API を使用します。
- ワークスペース:ワークスペース内のすべてのSQL倉庫に適用されます。 ワークスペース管理設定かSet SQL設定パラメータAPIを使ってください。
設定
タイムアウト値は、0 から 172,800 秒 (2 日) の間で秒単位で設定します。 実行時間が設定値を超える Databricks SQL ステートメントは停止されます。
システムの既定値
システムの既定値は 172,800 秒 (2 日) です。
優先順位
タイムアウトが複数のスコープで設定されている場合、次の順序で最初の null 以外の値が適用されます。
- セッション
- Warehouse
- Workspace
タイムアウトが任意のスコープで設定されていない場合、 システムの既定値 が適用されます。
例
次の例では、セッション レベルのタイムアウトを設定し、リセットします。
-- Set a session-level timeout
> SET STATEMENT_TIMEOUT = 86400;
> SELECT * FROM DIAMONDS;
-- Reset the timeout duration
> RESET STATEMENT_TIMEOUT;
> SELECT * FROM DIAMONDS;
ワークスペース レベルのタイムアウトを設定するには、ワークスペース管理者の設定に移動し、[Compute] (コンピューティング) をクリックしてから、[SQL warehouses] (SQL ウェアハウス) の横にある [管理] をクリックします。 [SQL Configuration Parameters] (SQL 構成パラメーター) の設定で、タイムアウト値を秒単位で指定する構成パラメーターを追加します。
-- Set a workspace-level timeout
> STATEMENT_TIMEOUT 86400
注釈
倉庫レベルのタイムアウトの設定、削除、およびチェックについては、「 ステートメントタイムアウト」を参照してください。