Skip to content

Commit 536fcf5

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 536fcf5

File tree

1 file changed

+35
-7
lines changed

1 file changed

+35
-7
lines changed

docs/variables.md

Lines changed: 35 additions & 7 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

@@ -1186,7 +1193,13 @@ through before assuming deadlock.
11861193
| Data type | UINT |
11871194
| Default | 2 |
11881195

1189-
The cardinality multiplier used in tests. The minimum value is 0. The maxium value is 2147483647 (INT_MAX).
1196+
The cardinality multiplier used in tests. The minimum value is 1. The maxium value is 2147483647 (INT_MAX).
1197+
1198+
#### Version change
1199+
1200+
As of Percona Server for MySQL 8.0.44-35, the minimum value has been changed from 0 to 1.
1201+
1202+
For versions before 8.0.44-35, the minimum value is 0.
11901203

11911204
### `rocksdb_debug_manual_compaction_delay`
11921205

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

15651578
#### Version changes
15661579

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

15691582
#### Improving Write Throughput with Pipelined Writes
15701583

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

20092022
Specifies the maximum number of info log files to keep.
2010-
Default value is `1000`.
2011-
Allowed range is from `1` to `18446744073709551615`.
2023+
The default number is `1000`.
2024+
The allowed range is from `1` to `18446744073709551615`.
2025+
2026+
#### Version change
2027+
2028+
As of Percona Server for MySQL 8.0.44-35, Percona Server sets the minimum value to `1`.
2029+
2030+
For versions before 8.0.44-35, the minimum value was `0`.
20122031

20132032
### `rocksdb_lock_scanned_rows`
20142033

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

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

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`).
2249+
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.
2250+
2251+
The default value is `16`.
2252+
The minimum value is `1` and the maximum value is `262144`.
2253+
2254+
#### Version change
2255+
2256+
As of Percona Server for MySQL 8.0.44-35, the maximum value has been reduced from `2147483647` (`INT_MAX`) to `262144`.
2257+
2258+
For versions before 8.0.44-35, the maximum value was `2147483647` (`INT_MAX`).
22312259

22322260
### `rocksdb_max_latest_deadlocks`
22332261

0 commit comments

Comments
 (0)