Skip to content

Commit cba0f6c

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 cba0f6c

File tree

1 file changed

+28
-6
lines changed

1 file changed

+28
-6
lines changed

docs/variables.md

Lines changed: 28 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

@@ -1564,7 +1571,7 @@ The variable was implemented in [Percona Server for MySQL 8.0.20-11](release-not
15641571

15651572
#### Version changes
15661573

1567-
The variable was implemented in [Percona Server for MySQL 8.0.25-15](release-notes/Percona-Server-8.0.25-15.md#id1).
1574+
The variable was implemented in [Percona Server for MySQL 8.0.25-15](./release-notes/Percona-Server-8.0.25-15.md).
15681575

15691576
#### Improving Write Throughput with Pipelined Writes
15701577

@@ -2007,8 +2014,14 @@ When enabled, this option allows index key prefixes longer than 767 bytes (up to
20072014
| Default | 1000 |
20082015

20092016
Specifies the maximum number of info log files to keep.
2010-
Default value is `1000`.
2011-
Allowed range is from `1` to `18446744073709551615`.
2017+
The default number is `1000`.
2018+
The allowed range is from `1` to `18446744073709551615`.
2019+
2020+
#### Version change
2021+
2022+
As of Percona Server for MySQL 8.0.44-35, Percona Server sets the minimum value to `1`.
2023+
2024+
For versions before 8.0.44-35, the minimum value was `0`.
20122025

20132026
### `rocksdb_lock_scanned_rows`
20142027

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

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

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`).
2243+
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.
2244+
2245+
The default value is `16`.
2246+
The minimum value is `1` and the maximum value is `262144`.
2247+
2248+
#### Version change
2249+
2250+
As of Percona Server for MySQL 8.0.44-35, the maximum value has been reduced from `2147483647` (`INT_MAX`) to `262144`.
2251+
2252+
For versions before 8.0.44-35, the maximum value was `2147483647` (`INT_MAX`).
22312253

22322254
### `rocksdb_max_latest_deadlocks`
22332255

0 commit comments

Comments
 (0)