STATEMENT_TIMEOUT

適用対象: チェック マークあり 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 以外の値が適用されます。

  1. セッション
  2. Warehouse
  3. 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

注釈

倉庫レベルのタイムアウトの設定、削除、およびチェックについては、「 ステートメントタイムアウト」を参照してください。