Zurab Kiknavelidze
07/29/2026, 7:11 AMRocky
07/29/2026, 7:11 AMCREATE WAREHOUSE <warehouse_name>;
* Switch Warehouse: To specify which warehouse the current session should use:
sql
SET warehouse = 'warehouse_name';
* View Warehouses: SHOW WAREHOUSES;
* Drop a Warehouse: DROP WAREHOUSE <warehouse_name>;
2. Benefits for Workload Management
* Isolated Ingestion: Use a dedicated warehouse for data loading to prevent "write" workloads from competing for CPU/memory with "read" queries.
* Multi-tenancy: Assign different departments or business units to their own warehouses to simplify resource accounting and ensure SLAs.
* Data Sharing: Since all warehouses access the same data in object storage, there is no need to copy or move data between clusters.
Requirements & Availability
* Version: Explicit multi-warehouse management is generally available for shared-data clusters starting from StarRocks 3.3.
* Architecture: It requires the shared-data (cloud-native) architecture where FEs manage metadata and CNs provide compute resources. It is not available in the classic shared-nothing (BE-based) architecture.
For specific implementation details in your environment, you may also refer to cloud-managed versions (like Alibaba Cloud EMR Serverless or CelerData), which provide UI-based management for these warehouses.
References
• data_source/catalog/hive_catalog.md
• sql-reference/sql-statements/Resource/CREATE_RESOURCE.md
• sql-reference/sql-statements/Catalog/SET_CATALOG.md
• data_source/catalog/unified_catalog.md
• sql-reference/sql-statements/backup_restore/CREATE_REPOSITORY.mdZurab Kiknavelidze
07/29/2026, 7:12 AMRocky
07/29/2026, 7:13 AMCREATE WAREHOUSE, etc.) were introduced as GA in StarRocks 3.3. If you are on an earlier 3.x version, you may still achieve resource isolation via Resource Groups, but the physical isolation provided by independent compute nodes (CNs) is the hallmark of the Multi-warehouse feature.
References
• administration/management/BE_configuration.md
• administration/management/FE_configuration.mdZurab Kiknavelidze
07/29/2026, 7:18 AMRocky
07/29/2026, 7:18 AMCREATE WAREHOUSE only work if your cluster is deployed in Shared-data mode. In a standard Shared-nothing deployment, SHOW COMPUTE NODES will simply show default_warehouse for all nodes, and you cannot create more.
* Terminology Shift: In newer docs, StarRocks often uses the term Compute Groups to describe the physical isolation of Compute Nodes (CNs).
* Resource Groups vs. Warehouses: For software-level isolation (CPU/Memory limits within a node), StarRocks uses Resource Groups. For physical isolation (separate clusters sharing data), it uses Warehouses.
3. Key SQL Commands (Shared-data Only)
If you are on a Shared-data cluster (v3.3+), you can use the following commands:
sql
-- Create a new warehouse (group of CN nodes)
CREATE WAREHOUSE <warehouse_name>;
-- Switch your session to a specific warehouse
SET warehouse = '<warehouse_name>';
-- Check which warehouse you are currently using
SELECT current_warehouse();
-- List all warehouses in the cluster
SHOW WAREHOUSES;
If you are trying to navigate the website and the links are broken, it is likely due to the documentation restructuring for the v3.3 and v3.4 releases. Always ensure you have selected the correct version in the documentation sidebar (e.g., Stable-3.3 or Latest-4.1).
References
• sql-reference/sql-statements/cluster-management/resource_group/CREATE_RESOURCE_GROUP.md
• sql-reference/sql-statements/Resource/CREATE_RESOURCE.md
• sql-reference/sql-statements/backup_restore/CREATE_REPOSITORY.md