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.
Details related to the blobs cached in the blob cache and events on those blobs are found in the information schema views MV_
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: June 11, 2025