docs: update warehouse ops (#3060)

everpcpc · web-flow · commit b52407b5214c · 2026-01-22T10:42:59.000+08:00
diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,6 @@
 # Dependencies
 /node_modules
+/worktrees
 
 # Production
 /build
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/alter-warehouse.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/alter-warehouse.md
@@ -17,12 +17,12 @@ ALTER WAREHOUSE <warehouse_name> { SUSPEND | RESUME }
 
 -- Modify warehouse settings
 ALTER WAREHOUSE <warehouse_name>
-    SET [ WITH ] warehouse_size = <size>
-    [ WITH ] auto_suspend = <nullable_unsigned_number>
-    [ WITH ] auto_resume = <bool>
-    [ WITH ] max_cluster_count = <nullable_unsigned_number>
-    [ WITH ] min_cluster_count = <nullable_unsigned_number>
-    [ WITH ] comment = '<string_literal>'
+    SET [ warehouse_size = <size> ]
+    [ auto_suspend = <nullable_unsigned_number> ]
+    [ auto_resume = <bool> ]
+    [ max_cluster_count = <nullable_unsigned_number> ]
+    [ min_cluster_count = <nullable_unsigned_number> ]
+    [ comment = '<string_literal>' ]
 
 ALTER WAREHOUSE <warehouse_name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
 
@@ -31,24 +31,24 @@ ALTER WAREHOUSE <warehouse_name> UNSET TAG <tag_name> [ , <tag_name> ... ]
 ALTER WAREHOUSE <warehouse_name> RENAME TO <new_name>
 ```
 
-| Parameter | Description |
-|-----------|-------------|
-| `SUSPEND` | Immediately suspends the warehouse. |
-| `RESUME` | Immediately resumes the warehouse. |
-| `SET` | Modifies one or more warehouse options. Unspecified fields remain unchanged. |
+| Parameter | Description                                                                  |
+| --------- | ---------------------------------------------------------------------------- |
+| `SUSPEND` | Immediately suspends the warehouse.                                          |
+| `RESUME`  | Immediately resumes the warehouse.                                           |
+| `SET`     | Modifies one or more warehouse options. Unspecified fields remain unchanged. |
 
 ## Options
 
 The `SET` clause accepts the same options as [CREATE WAREHOUSE](create-warehouse.md):
 
-| Option | Type / Values | Description |
-|--------|---------------|-------------|
-| `WAREHOUSE_SIZE` | `XSmall`, `Small`, `Medium`, `Large`, `XLarge`, `2XLarge`–`6XLarge` | Changes compute size. |
-| `AUTO_SUSPEND` | `NULL`, `0`, or ≥300 seconds | Idle timeout before automatic suspend. `NULL` disables auto-suspend. |
-| `AUTO_RESUME` | Boolean | Controls whether incoming queries wake the warehouse automatically. |
-| `MAX_CLUSTER_COUNT` | `NULL` or non-negative integer | Upper bound for auto-scaling clusters. |
-| `MIN_CLUSTER_COUNT` | `NULL` or non-negative integer | Lower bound for auto-scaling clusters. |
-| `COMMENT` | String | Free-form text description. |
+| Option              | Type / Values                                                       | Description                                                          |
+| ------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `WAREHOUSE_SIZE`    | `XSmall`, `Small`, `Medium`, `Large`, `XLarge`, `2XLarge`–`6XLarge` | Changes compute size.                                                |
+| `AUTO_SUSPEND`      | `NULL`, `0`, or ≥300 seconds                                        | Idle timeout before automatic suspend. `NULL` disables auto-suspend. |
+| `AUTO_RESUME`       | Boolean                                                             | Controls whether incoming queries wake the warehouse automatically.  |
+| `MAX_CLUSTER_COUNT` | `NULL` or non-negative integer                                      | Upper bound for auto-scaling clusters.                               |
+| `MIN_CLUSTER_COUNT` | `NULL` or non-negative integer                                      | Lower bound for auto-scaling clusters.                               |
+| `COMMENT`           | String                                                              | Free-form text description.                                          |
 
 - `NULL` is valid for numeric options to reset them to `0`.
 - Supplying `SET` with no options raises an error.
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/create-warehouse.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/create-warehouse.md
@@ -23,23 +23,23 @@ CREATE WAREHOUSE [ IF NOT EXISTS ] <warehouse_name>
     [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] )
 ```
 
-| Parameter | Description |
-|-----------|-------------|
+| Parameter       | Description                                                                                   |
+| --------------- | --------------------------------------------------------------------------------------------- |
 | `IF NOT EXISTS` | Optional. If specified, the command succeeds without changes if the warehouse already exists. |
-| warehouse_name | 3–63 characters, containing only `A-Z`, `a-z`, `0-9`, and `-`. |
+| warehouse_name  | 3–63 characters, containing only `A-Z`, `a-z`, `0-9`, and `-`.                                |
 
 ## Options
 
-| Option | Type / Values | Default | Description |
-|--------|---------------|---------|-------------|
-| `WAREHOUSE_SIZE` | `XSmall`, `Small`, `Medium`, `Large`, `XLarge`, `2XLarge`–`6XLarge` (case-insensitive) | `Small` | Controls compute size. |
-| `AUTO_SUSPEND` | `NULL`, `0`, or ≥300 seconds | `600` seconds | Idle timeout before automatic suspend. `0`/`NULL` means never suspend; values below 300 are rejected. |
-| `INITIALLY_SUSPENDED` | Boolean | `FALSE` | If `TRUE`, the warehouse remains suspended after creation until explicitly resumed. |
-| `AUTO_RESUME` | Boolean | `TRUE` | Controls whether incoming queries wake the warehouse automatically. |
-| `MAX_CLUSTER_COUNT` | `NULL` or non-negative integer | `0` | Upper bound for auto-scaling clusters. `0` disables auto-scale. |
-| `MIN_CLUSTER_COUNT` | `NULL` or non-negative integer | `0` | Lower bound for auto-scaling clusters; should be ≤ `MAX_CLUSTER_COUNT`. |
-| `COMMENT` | String | Empty | Free-form text surfaced by `SHOW WAREHOUSES`. |
-| `TAG` | Key-value pairs: `TAG ( key1 = 'value1', key2 = 'value2' )` | None | Resource tags for categorization and organization (similar to AWS tags). Used for cost allocation, environment identification, or team ownership. |
+| Option                | Type / Values                                                                          | Default       | Description                                                                                                                                       |
+| --------------------- | -------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `WAREHOUSE_SIZE`      | `XSmall`, `Small`, `Medium`, `Large`, `XLarge`, `2XLarge`–`6XLarge` (case-insensitive) | `Small`       | Controls compute size.                                                                                                                            |
+| `AUTO_SUSPEND`        | `NULL`, `0`, or ≥300 seconds                                                           | `600` seconds | Idle timeout before automatic suspend. `0`/`NULL` means never suspend; values below 300 are rejected.                                             |
+| `INITIALLY_SUSPENDED` | Boolean                                                                                | `FALSE`       | If `TRUE`, the warehouse remains suspended after creation until explicitly resumed.                                                               |
+| `AUTO_RESUME`         | Boolean                                                                                | `TRUE`        | Controls whether incoming queries wake the warehouse automatically.                                                                               |
+| `MAX_CLUSTER_COUNT`   | `NULL` or non-negative integer                                                         | `0`           | Upper bound for auto-scaling clusters. `0` disables auto-scale.                                                                                   |
+| `MIN_CLUSTER_COUNT`   | `NULL` or non-negative integer                                                         | `0`           | Lower bound for auto-scaling clusters; should be ≤ `MAX_CLUSTER_COUNT`.                                                                           |
+| `COMMENT`             | String                                                                                 | Empty         | Free-form text surfaced by `SHOW WAREHOUSES`.                                                                                                     |
+| `TAG`                 | Key-value pairs: `TAG ( key1 = 'value1', key2 = 'value2' )`                            | None          | Resource tags for categorization and organization (similar to AWS tags). Used for cost allocation, environment identification, or team ownership. |
 
 - Options may appear in any order and may repeat (the later value wins).
 - `AUTO_SUSPEND`, `MAX_CLUSTER_COUNT`, and `MIN_CLUSTER_COUNT` accept `= NULL` to reset to `0`.
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/drop-warehouse.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/drop-warehouse.md
@@ -15,10 +15,10 @@ Removes a warehouse and frees up the resources associated with it.
 DROP WAREHOUSE [ IF EXISTS ] <warehouse_name>
 ```
 
-| Parameter | Description |
-|-----------|-------------|
-| `IF EXISTS` | Optional. If specified, the command succeeds silently when the warehouse does not exist. Without it, the command fails if the warehouse is absent. |
-| warehouse_name | The name of the warehouse to remove. |
+| Parameter      | Description                                                                                                                                        |
+| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IF EXISTS`    | Optional. If specified, the command succeeds silently when the warehouse does not exist. Without it, the command fails if the warehouse is absent. |
+| warehouse_name | The name of the warehouse to remove.                                                                                                               |
 
 ## Examples
 
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/index.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/index.md
@@ -24,40 +24,40 @@ Tags are key-value pairs that help categorize and organize warehouses, similar t
 - **Custom metadata**: Add any arbitrary metadata for organizational purposes
 
 Tag keys and values are arbitrary strings (enclosed in quotes if they contain spaces or special characters). Tags can be:
+
 - Added at warehouse creation time using `WITH TAG (key = 'value', ...)`
 - Updated or added later using `ALTER WAREHOUSE ... SET TAG key = 'value'`
 - Removed using `ALTER WAREHOUSE ... UNSET TAG key`
 
 Tags are returned in API responses and visible through `SHOW WAREHOUSES`.
 
 **Tag Limits:**
+
 - Maximum 10 tags per warehouse
 - Tag name (key) maximum length: 128 characters
 - Tag value maximum length: 256 characters
 
 ## Supported Statements
 
-| Statement           | Purpose                      | Notes                                                               |
-| ------------------- | ---------------------------- | ------------------------------------------------------------------- |
-| `CREATE WAREHOUSE`  | Create a warehouse           | Supports `IF NOT EXISTS` and option list                            |
-| `REPLACE WAREHOUSE` | Recreate a warehouse         | Same semantics as `CREATE WAREHOUSE`, handy for overwriting configs |
-| `ALTER WAREHOUSE`   | Suspend/resume/mutate/rename | `SUSPEND`/`RESUME`, `SET <options>`, or `RENAME TO <name>`          |
-| `DROP WAREHOUSE`    | Delete a warehouse           | Optional `IF EXISTS`                                                |
-| `USE WAREHOUSE`     | Bind the current session     | Validates existence only                                            |
-| `SHOW WAREHOUSES`   | List warehouses              | Optional `LIKE` filter                                              |
-| `QUERY_HISTORY`     | Inspect query logs           | Filter by warehouse, time range, limit                              |
+| Statement          | Purpose                      | Notes                                                      |
+| ------------------ | ---------------------------- | ---------------------------------------------------------- |
+| `CREATE WAREHOUSE` | Create a warehouse           | Supports `IF NOT EXISTS` and option list                   |
+| `ALTER WAREHOUSE`  | Suspend/resume/mutate/rename | `SUSPEND`/`RESUME`, `SET <options>`, or `RENAME TO <name>` |
+| `DROP WAREHOUSE`   | Delete a warehouse           | Optional `IF EXISTS`                                       |
+| `USE WAREHOUSE`    | Bind the current session     | Validates existence only                                   |
+| `SHOW WAREHOUSES`  | List warehouses              | Optional `LIKE` filter                                     |
+| `QUERY_HISTORY`    | Inspect query logs           | Filter by warehouse, time range, limit                     |
 
 ## Warehouse Management
 
-| Command | Description |
-|---------|-------------|
-| [CREATE WAREHOUSE](create-warehouse.md) | Creates a new warehouse |
-| [USE WAREHOUSE](use-warehouse.md) | Sets the current warehouse for the session |
-| [SHOW WAREHOUSES](show-warehouses.md) | Lists all warehouses with optional filtering |
-| [ALTER WAREHOUSE](alter-warehouse.md) | Suspends, resumes, or modifies warehouse settings |
-| [DROP WAREHOUSE](drop-warehouse.md) | Removes a warehouse |
-| [REPLACE WAREHOUSE](replace-warehouse.md) | Recreates a warehouse with new configuration |
-| [QUERY_HISTORY](query-history.md) | Inspects query logs for a warehouse |
+| Command                                 | Description                                       |
+| --------------------------------------- | ------------------------------------------------- |
+| [CREATE WAREHOUSE](create-warehouse.md) | Creates a new warehouse                           |
+| [USE WAREHOUSE](use-warehouse.md)       | Sets the current warehouse for the session        |
+| [SHOW WAREHOUSES](show-warehouses.md)   | Lists all warehouses with optional filtering      |
+| [ALTER WAREHOUSE](alter-warehouse.md)   | Suspends, resumes, or modifies warehouse settings |
+| [DROP WAREHOUSE](drop-warehouse.md)     | Removes a warehouse                               |
+| [QUERY_HISTORY](query-history.md)       | Inspects query logs for a warehouse               |
 
 :::note
 A warehouse represents compute resources used to run queries in Databend Cloud.
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/query-history.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/query-history.md
@@ -19,23 +19,23 @@ QUERY_HISTORY
     [ LIMIT <unsigned_integer> ]
 ```
 
-| Parameter | Description |
-|-----------|-------------|
-| `BY WAREHOUSE` | Optional. Filters logs to a specific warehouse. Empty names raise an error. |
-| `FROM` | Optional. Start timestamp for the query range. Format: `YYYY-MM-DD HH:MM:SS` (UTC or explicit timezone). Defaults to 1 hour before `TO`. |
-| `TO` | Optional. End timestamp for the query range. Format: `YYYY-MM-DD HH:MM:SS` (UTC or explicit timezone). Defaults to current time. |
-| `LIMIT` | Optional. Maximum number of records to return. Defaults to `10`. Must be a positive integer. |
+| Parameter      | Description                                                                                                                              |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `BY WAREHOUSE` | Optional. Filters logs to a specific warehouse. Empty names raise an error.                                                              |
+| `FROM`         | Optional. Start timestamp for the query range. Format: `YYYY-MM-DD HH:MM:SS` (UTC or explicit timezone). Defaults to 1 hour before `TO`. |
+| `TO`           | Optional. End timestamp for the query range. Format: `YYYY-MM-DD HH:MM:SS` (UTC or explicit timezone). Defaults to current time.         |
+| `LIMIT`        | Optional. Maximum number of records to return. Defaults to `10`. Must be a positive integer.                                             |
 
 ## Output Columns
 
 The result includes columns such as:
 
-| Column | Description |
-|--------|-------------|
-| `query_id` | Unique identifier for the query |
-| `query_text` | The SQL statement executed |
-| `scan_bytes` | Amount of data scanned |
-| ... | Additional query metrics and metadata |
+| Column       | Description                           |
+| ------------ | ------------------------------------- |
+| `query_id`   | Unique identifier for the query       |
+| `query_text` | The SQL statement executed            |
+| `scan_bytes` | Amount of data scanned                |
+| ...          | Additional query metrics and metadata |
 
 ## Examples
 
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/replace-warehouse.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/replace-warehouse.md
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/show-warehouses.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/show-warehouses.md
diff --git a/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/use-warehouse.md b/docs/en/sql-reference/10-sql-commands/00-ddl/19-warehouse/use-warehouse.md
