STATEMENT_TIMEOUT

Se aplica a: Databricks SQL

El STATEMENT_TIMEOUT parámetro de configuración especifica una duración de tiempo de espera en segundos. El recuento comienza al principio de la ejecución de la instrucción SQL. Se agota el tiempo de espera de cualquier instrucción SQL de Databricks con un tiempo de ejecución que supere el valor.

Puede establecer este parámetro en tres ámbitos:

• Sesión: se aplica a las instrucciones de la sesión actual. Use la SET instrucción .
• Warehouse (Beta): se aplica a todas las instrucciones que se ejecutan en un almacenamiento SQL específico. Use la API de almacenamiento de SQL.
• Área de trabajo: se aplica a todos los almacenes de SQL del área de trabajo. Use la configuración de administración del área de trabajo o la API de SQL Warehouses.

Configuración

Establezca un valor de tiempo de espera en segundos entre 0 y 172800 segundos (2 días). Se detiene cualquier instrucción SQL de Databricks que tenga un tiempo de ejecución que supere el valor establecido.

Valor predeterminado del sistema

El valor predeterminado del sistema es 172800 segundos (2 días).

Precedence

Cuando se establece el tiempo de espera en más de un ámbito, se aplica el primer valor distinto de NULL en el orden siguiente:

1. Sesión
2. Almacén (beta)
3. Workspace

Si el tiempo de espera no se establece en ningún ámbito, se aplica el valor predeterminado del sistema .

Ejemplos

En el ejemplo siguiente se establece un tiempo de espera de nivel de sesión y, a continuación, se restablece.

-- Set a session-level timeout
> SET STATEMENT_TIMEOUT = 86400;
> SELECT * FROM DIAMONDS;

-- Reset the timeout duration
> RESET STATEMENT_TIMEOUT;
> SELECT * FROM DIAMONDS;

Para establecer un tiempo de espera de nivel de área de trabajo, vaya a la configuración del administrador del área de trabajo, haga clic en Proceso y, a continuación, haga clic en Administrar, junto a Almacenes de SQL. En la configuración Parámetros de configuración de SQL, agregue un parámetro de configuración donde el valor del tiempo de espera sea en segundos.

-- Set a workspace-level timeout
> STATEMENT_TIMEOUT 86400

Tiempo de espera de nivel de almacenamiento

Puede establecer un tiempo de espera de instrucción en un único almacén de SQL para que distintos almacenes puedan aplicar tiempos de espera diferentes a sus consultas. Por ejemplo, establezca un tiempo de espera más largo en un almacén de ETL y un tiempo de espera más corto en un almacén de BI.

Establezca un tiempo de espera de nivel de almacenamiento con el statement_timeout campo en las API de creación o actualización del almacenamiento. El valor está en segundos. Para quitar un tiempo de espera de nivel de almacenamiento, establezca el campo 0en .

Al cambiar statement_timeout con la API de almacenamiento de actualizaciones, el almacenamiento se reinicia automáticamente para que el nuevo valor surta efecto.

Para comprobar el tiempo de espera que está actualmente en vigor en el almacén al que está conectado, ejecute lo siguiente:

SET STATEMENT_TIMEOUT;

Temas relacionados

• RESET
• Instrucción SET
• Configuración de parámetros de SQL
• API de almacenamiento de SQL