databricks Platform · Updated Jul 21, 2026

Warehouse-level statement timeouts

Set specific timeouts for individual SQL warehouses.

What it does

The Warehouse-level statement timeout feature allows users to specify a timeout duration for SQL statements executed on individual SQL warehouses, with the timeout duration set in seconds. This timeout applies only to the specific warehouse, enabling different warehouses to have tailored timeout settings based on their use cases. The timeout can be configured using the `statement_timeout` field in the Create or Update warehouse APIs, and it can be set to any value between 0 and 172800 seconds (2 days). If the execution time of a statement exceeds the specified timeout, the statement is halted.

Why it matters

This feature enhances resource management and query performance by allowing organizations to optimize SQL execution times based on the specific needs of different workloads, such as ETL versus BI. By applying tailored timeouts, businesses can reduce the risk of long-running queries consuming resources unnecessarily, leading to improved overall system performance and cost efficiency.

Key capabilities

Warehouse-specific timeouts

Set unique timeout durations for each SQL warehouse.

API Configuration

Timeouts are configured via the Create or Update warehouse APIs.

Flexible Timeout Values

Timeouts can be set between 0 and 172800 seconds.

Automatic Warehouse Restart

Updating the timeout value automatically restarts the warehouse.

Prerequisites

Workspace admin must enable the Warehouse Statement Timeout preview.

Access to the SQL warehouses API.

Recommended use cases

Set longer timeouts for ETL processes that require more execution time.Implement shorter timeouts for BI queries to ensure quick response times.

Limitations · remember

!Feature is currently in Beta and may have limited support.

!Existing timeout values remain until the warehouse is restarted.

Architecture

Databricks SQL → SQL Warehouses → API Configuration → Timeout Management

Get started

Enable Preview

Workspace admin enables the Warehouse Statement Timeout preview from the Previews page.

Set Timeout

Use the `statement_timeout` field in the Create or Update warehouse APIs to set the timeout.

Restart Warehouse

The warehouse will restart automatically to apply the new timeout setting.

Check Current Timeout

Run `SET STATEMENT_TIMEOUT;` to check the current timeout value.

Key takeaway

The new warehouse-level statement timeouts feature allows for optimized SQL query management by enabling customized timeout settings for individual SQL warehouses.

2026-07-21-warehouse-level-statement-timeouts-beta Generated by the Databricks Updates Agent · browse all updates