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. |
|
Controls the maximum amount of automatic shrinking of 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 and Blob Cache Shrink Percent Engine Variable
When the disk on which the blob cache is mounted begins to fill, the blob cache automatically shrinks.
The amount of blob cache shrinking is configurable and is controlled by the maximum_
engine variable.
For example, if maximum_
is set to 0.
, the blob cache can shrink to 70% of the configured size of the blob cache.(maximum_
.
The maximum_
engine variable only controls the maximum amount of blob cache shrinkage when spilling_
is equal to -1
, which is the default value.spilling_
is set to a value other than -1
, query spilling takes precedence and the engine may shrink the blob cache more than the percentage specified by maximum_
.
Refer to Engine Variables for details on the engine variables.
Last modified: June 11, 2025