Skip to content

Commit 55e1c19

Browse files
committed
PS-10214 - Document changed ranges of variables in MyRocks 8.0
On branch ps-10214-8.0 modified: docs/variables.md
1 parent 241e3bf commit 55e1c19

File tree

1 file changed

+29
-6
lines changed

1 file changed

+29
-6
lines changed

docs/variables.md

Lines changed: 29 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -490,9 +490,16 @@ Allowed range is from `1` to `2147483647`.
490490
| Data type | Numeric |
491491
| Default | 16 KB |
492492

493-
Specifies the size of the data block for reading RocksDB data files.
493+
Specifies the size of the data blocks used for storing and reading RocksDB data files. Larger block sizes can improve compression efficiency and reduce metadata overhead, but may increase memory usage and read amplification.
494+
494495
The default value is `16 KB`.
495-
The allowed range is from `1024` to `18446744073709551615` bytes.
496+
The allowed range is from `1024` to `4294967296` bytes (4GiB).
497+
498+
#### Version change
499+
500+
As of Percona Server for MySQL 8.0.44-35, the maximum value has been reduced from `18446744073709551615` bytes to `4294967296` bytes (4GiB).
501+
502+
For versions before 8.0.44-35, the allowed range is from `1024` to `18446744073709551615` bytes.
496503

497504
### `rocksdb_block_size_deviation`
498505

@@ -2006,9 +2013,16 @@ When enabled, this option allows index key prefixes longer than 767 bytes (up to
20062013
| Data type | Numeric |
20072014
| Default | 1000 |
20082015

2009-
Specifies the maximum number of info log files to keep.
2010-
Default value is `1000`.
2011-
Allowed range is from `1` to `18446744073709551615`.
2016+
Specifies the maximum number of info log files to keep. RocksDB automatically deletes older log files when this limit is exceeded, helping to manage disk space usage.
2017+
2018+
The default value is `1000`.
2019+
The allowed range is from `1` to `18446744073709551615`.
2020+
2021+
#### Version change
2022+
2023+
As of Percona Server for MySQL 8.0.44-35, the minimum value has been set to `1`.
2024+
2025+
For versions before 8.0.44-35, the minimum value was `0` (which would disable log file retention).
20122026

20132027
### `rocksdb_lock_scanned_rows`
20142028

@@ -2227,7 +2241,16 @@ Tracks the history for at most `rockdb_mx_compaction_history` completed compacti
22272241

22282242
This variable has been implemented in [Percona Server for MySQL 8.0.36-28](.//release-notes/8.0.36-28.md).
22292243

2230-
This variable sets `DBOptions::max_file_opening_threads` for RocksDB. The default value is `16`. The minimum value is `1` and the maximum value is 2147483647 (`INT_MAX`).
2244+
This variable sets `DBOptions::max_file_opening_threads` for RocksDB, controlling the maximum number of threads that can be used to open files concurrently. This helps improve performance when opening multiple files simultaneously.
2245+
2246+
The default value is `16`.
2247+
The minimum value is `1` and the maximum value is `262144`.
2248+
2249+
#### Version change
2250+
2251+
As of Percona Server for MySQL 8.0.44-35, the maximum value has been reduced from `2147483647` (`INT_MAX`) to `262144`.
2252+
2253+
For versions before 8.0.44-35, the maximum value was `2147483647` (`INT_MAX`).
22312254

22322255
### `rocksdb_max_latest_deadlocks`
22332256

0 commit comments

Comments
 (0)