📣
TiDB Cloud Premium is now in public preview. Unlimited growth, instant elasticity, advanced security for enterprise workloads. Try it out →

SHOW WAREHOUSES



Lists all warehouses visible to the current tenant.

Syntax

SHOW WAREHOUSES [ LIKE '<pattern>' ] [ <pattern_without_like> ]
ParameterDescription
LIKE '<pattern>'Optional. Filters warehouse names using SQL LIKE semantics (% matches any sequence, _ matches any single character).
<pattern_without_like>Optional. When LIKE is omitted but a literal follows, it is treated as LIKE '<literal>'.

Output Columns

ColumnDescription
nameWarehouse name
stateCurrent state (e.g., Running, Suspended)
sizeWarehouse size
auto_suspendAuto-suspend timeout in seconds
auto_resumeWhether auto-resume is enabled
min_cluster_countMinimum cluster count for auto-scaling
max_cluster_countMaximum cluster count for auto-scaling
roleWarehouse role
commentUser-defined comment
tagsWarehouse tags as a JSON-formatted string
created_byCreator
created_onCreation timestamp

Examples

List all warehouses:

SHOW WAREHOUSES;

List warehouses matching a pattern:

SHOW WAREHOUSES LIKE '%prod%';

Use a literal without LIKE:

SHOW WAREHOUSES 'nightly-etl';

Was this page helpful?