Skip to main content

Warehouse

Warehouse-related SQL commands for Databend Cloud.

General Rules

  • Warehouse naming: 3–63 characters, A-Z, a-z, 0-9, and - only.
  • Identifiers: Bare identifiers may omit quotes when they contain no spaces or special characters; otherwise enclose with single quotes.
  • Numeric parameters: Accept integers or NULL. Supplying NULL resets the value to default (e.g., AUTO_SUSPEND = NULL equals 0).
  • Boolean parameters: Only TRUE/FALSE are accepted.
  • WITH keyword: May appear before the entire option list or ahead of each option. Options are whitespace-separated.

Warehouse Management

CommandDescription
CREATE WAREHOUSECreates a new warehouse
USE WAREHOUSESets the current warehouse for the session
SHOW WAREHOUSESLists all warehouses with optional filtering
ALTER WAREHOUSESuspends, resumes, or modifies warehouse settings
DROP WAREHOUSERemoves a warehouse
REPLACE WAREHOUSERecreates a warehouse with new configuration
QUERY_HISTORYInspects query logs for a warehouse
note

A warehouse represents compute resources used to run queries in Databend Cloud.

Try Databend Cloud for FREE

Multimodal, object-storage-native warehouse for BI, vectors, search, and geo.

Snowflake-compatible SQL with automatic scaling.

Sign up and get $200 in credits.

Try it today