You need to enable JavaScript to run this app.
ByteHouse Cloud Data Warehouse Version

ByteHouse Cloud Data Warehouse Version

Copy page
Download PDF
Virtual warehouse local disk
FAQ
Copy page
Download PDF
FAQ

What is the purpose of the virtual warehouse local disk?

The primary purpose of the virtual warehouse local disk is to accelerate remote data read performance under the architecture of storage and compute separation. In ByteHouse Cloud Data Warehouse, the default write behaviour is to write through to remote persistent distributed storage. Subsequent SQL reads trigger a return to the local disk.
To proactively trigger extraction and loading of cached content in the local disk, refer to Cache preload.

How is the space of the virtual warehouse local disk allocated?

The files stored on the virtual warehouse local disk are mainly divided into data blocks, metadata, unique index files, BSP temporary landing files, temporary files for insert foreground writes and background data merges, and others. Data blocks occupy approximately 70–80% of the space, while index and temporary files occupy around 10%.
For more specific information about the proportions or to make targeted adjustments, submit a ticket or contact the ByteHouse team.

How should the error "Cannot reserve 1 MB, not enough space" be handled?

When an SQL error displays Cannot reserve xx MB, not enough space, it is generally due to insufficient reserved space for temporary files on the local disk. The reason for this problem may be increased or more frequent foreground insert operations, larger batch row counts, more frequent background data merges, or excessively large merged files.
Additionally, ByteHouse Cloud Data Warehouse virtual warehouse supports separate settings for read and write virtual warehouses. If the read and write virtual warehouse are set as the same virtual warehouse, this problem is more likely to occur.
You can resolve this issue using the following methods:

  • If you have not yet purchased a virtual warehouse local disk: The default general 1:4 virtual warehouse comes with 200GB of space. You can buy a virtual warehouse local disk to expand the local disk space. The above methods can increase the space for temporary files and avoid the aforementioned error. For purchase and operation details, refer to Use the virtual warehouse local disk.
  • If you have already purchased a virtual warehouse local disk: You can appropriately expand the virtual warehouse local disk. You can log in to the ByteHouse Console, click virtual warehouse at the top, find the virtual warehouse you use, click edit, and adjust the local disk size of the virtual warehouse.
Last updated: 2026.03.31 16:21:57