Setting the Blob Cache
On this page
The blob cache is a local cache of data from an unlimited storage database, also known as a "bottomless" database.
Blob Cache Size Engine Variables
The size of the blob cache is controlled by the following engine variables:
| Name | Description | 
|---|---|
| 
               | Specifies the maximum blob cache size per leaf node. | 
| 
               | Sets the maximum percent of disk space that can be used by the blob cache. | 
Updates to the maximum_ and maximum_ engine variable function as follows:
- 
        Changing maximum_changes the value ofblob_ cache_ size_ percent maximum_and changes the size of the blob cache.blob_ cache_ size_ mb 
- 
        Changing maximum_changes the value ofblob_ cache_ size_ mb maximum_and the size of the blob cache but does not updateblob_ cache_ size_ mb maximum_.blob_ cache_ size_ percent 
- 
        The maximum_engine variable can be "out of date" if you setblob_ cache_ size_ percent maximum_after settingblob_ cache_ size_ mb maximum_.blob_ cache_ size_ percent 
- 
        On a restart, maximum_takes precedence, and setsblob_ cache_ size_ percent maximum_to the corresponding value.blob_ cache_ size_ mb 
Note
SingleStore recommends using only one of the maximum_ and maximum_ engine variables at a time.
Automatic Resizing of Blob Cache
When the disk space on the disk it’s mounted on starts getting filled up and stored files/objects need more space, the blob cache starts shrinking itself.
Example:
//Assume you are using a 1 TB disk andmaximum_blob_cache_size_mb = 800GB // for examplemaximum_blob_cache_size_percent = 0maximum blob cache size = 800GBSET maximum_blob_cache_size_percent = 0.50;//Nowmaximum_blob_cache_size_mb = 500GBmaximum_blob_cache_size_percent = 0.50maximum blob cache size = 500GBSET maximum_blob_cache_size_mb = 800GB;maximum_blob_cache_size_mb = 800GBmaximum_blob_cache_size_percent = 0.50maximum blob cache size = 800GB// On restarting the nodemaximum_blob_cache_size_mb = 500GBmaximum_blob_cache_size_percent = 0.50maximum blob cache size = 500GB
Last modified: September 9, 2025