Sourced from org.rocksdb:rocksdbjni's releases.
RocksDB 9.8.4
9.8.4 (2024-11-18)
Behavior Changes
- When Remote Compaction is enabled, do not purge OPTIONS file immediately by DeleteObsoleteOptionsFiles() after SetOptions(). Rely on PurgeObsoleteFiles() to clean up obsolete OPTIONS file after each compaction.
9.8.3 (2024-11-12)
Bug Fixes
- Fix missing cases of corruption retry during DB open and read API processing.
9.8.2 (2024-11-06)
Public API Changes
- Added a new API
Transaction::GetAttributeGroupIterator
that can be used to create a multi-column-family attribute group iterator over the specified column families, including the data from both the transaction and the underlying database. This API is currently supported for optimistic and write-committed pessimistic transactions.Behavior Changes
BaseDeltaIterator
now honors the read optionallow_unprepared_value
.Bug Fixes
BaseDeltaIterator
now callsPrepareValue
on the base iterator in case it has been created with theallow_unprepared_value
read option set. Earlier, such base iterators could lead to incorrect values being exposed fromBaseDeltaIterator
.- Fix a bug for replaying WALs for WriteCommitted transaction DB when its user-defined timestamps setting is toggled on/off between DB sessions.
9.8.1 (2024-10-31)
Bug Fixes
- Fix a leak of obsolete blob files left open until DB::Close(). This bug was introduced in version 9.4.0.
9.8.0 (2024-10-25)
New Features
- All non-
block_cache
options inBlockBasedTableOptions
are now mutable withDB::SetOptions()
. See also Bug Fixes below.- When using iterators with BlobDB, it is now possible to load large values on an on-demand basis, i .e. only if they are actually needed by the application. This can save I/O in use cases where the va lues associated with certain keys are not needed. For more details, see the new read option
allow_u nprepared_value
and the iterator APIPrepareValue
.- Add a new file ingestion option
IngestExternalFileOptions::fill_cache
to support not adding bloc ks from ingested files into block cache during file ingestion.- The option
allow_unprepared_value
is now also supported for multi-column-family iterators (i.e.CoalescingIterator
andAttributeGroupIterator
).- When a file with just one range deletion (standalone range deletion file) is ingested via bulk loa ding, it will be marked for compaction. During compaction, this type of files can be used to directl y filter out some input files that are not protected by any snapshots and completely deleted by the standalone range deletion file.
Behavior Changes
- During file ingestion, overlapping files level assignment are done in multiple batches, so that th ey can potentially be assigned to lower levels other than always land on L0.
- OPTIONS file to be loaded by remote worker is now preserved so that it does not get purged by the primary host. A similar technique as how we are preserving new SST files from getting purged is used for this. min_options_file_numbers_ is tracked like pending_outputs_ is tracked.
- Trim readahead_size during scans so data blocks containing keys that are not in the same prefix as the seek key in
Seek()
are not prefetched whenReadOptions::auto_readahead_size=true
(default v alue) andReadOptions::prefix_same_as_start = true
... (truncated)
Sourced from org.rocksdb:rocksdbjni's changelog.
9.8.4 (11/18/2024)
Behavior Changes
- When Remote Compaction is enabled, do not purge OPTIONS file immediately by DeleteObsoleteOptionsFiles() after SetOptions(). Rely on PurgeObsoleteFiles() to clean up obsolete OPTIONS file after each compaction.
9.8.3 (11/12/2024)
Bug Fixes
- Fix missing cases of corruption retry during DB open and read API processing.
9.8.2 (11/06/2024)
Public API Changes
- Added a new API
Transaction::GetAttributeGroupIterator
that can be used to create a multi-column-family attribute group iterator over the specified column families, including the data from both the transaction and the underlying database. This API is currently supported for optimistic and write-committed pessimistic transactions.Behavior Changes
BaseDeltaIterator
now honors the read optionallow_unprepared_value
.Bug Fixes
BaseDeltaIterator
now callsPrepareValue
on the base iterator in case it has been created with theallow_unprepared_value
read option set. Earlier, such base iterators could lead to incorrect values being exposed fromBaseDeltaIterator
.- Fix a bug for replaying WALs for WriteCommitted transaction DB when its user-defined timestamps setting is toggled on/off between DB sessions.
9.8.1 (10/31/2024)
Bug Fixes
- Fix a leak of obsolete blob files left open until DB::Close(). This bug was introduced in version 9.4.0.
9.8.0 (10/25/2024)
New Features
- All non-
block_cache
options inBlockBasedTableOptions
are now mutable withDB::SetOptions()
. See also Bug Fixes below.- When using iterators with BlobDB, it is now possible to load large values on an on-demand basis, i.e. only if they are actually needed by the application. This can save I/O in use cases where the values associated with certain keys are not needed. For more details, see the new read option
allow_unprepared_value
and the iterator APIPrepareValue
.- Add a new file ingestion option
IngestExternalFileOptions::fill_cache
to support not adding blocks from ingested files into block cache during file ingestion.- The option
allow_unprepared_value
is now also supported for multi-column-family iterators (i.e.CoalescingIterator
andAttributeGroupIterator
).- When a file with just one range deletion (standalone range deletion file) is ingested via bulk loading, it will be marked for compaction. During compaction, this type of files can be used to directly filter out some input files that are not protected by any snapshots and completely deleted by the standalone range deletion file.
Behavior Changes
- During file ingestion, overlapping files level assignment are done in multiple batches, so that they can potentially be assigned to lower levels other than always land on L0.
- OPTIONS file to be loaded by remote worker is now preserved so that it does not get purged by the primary host. A similar technique as how we are preserving new SST files from getting purged is used for this. min_options_file_numbers_ is tracked like pending_outputs_ is tracked.
- Trim readahead_size during scans so data blocks containing keys that are not in the same prefix as the seek key in
Seek()
are not prefetched whenReadOptions::auto_readahead_size=true
(default value) andReadOptions::prefix_same_as_start = true
- Assigning levels for external files are done in the same way for universal compaction and leveled compaction. The old behavior tends to assign files to L0 while the new behavior will assign the files to the lowest level possible.
Bug Fixes
- Fix a longstanding race condition in SetOptions for
block_based_table_factory
options. The fix has some subtle behavior changes because of copying and replacing the TableFactory on a change with SetOptions, including requiring an Iterator::Refresh() for an existing Iterator to use the latest options.- Fix under counting of allocated memory in the compressed secondary cache due to looking at the compressed block size rather than the actual memory allocated, which could be larger due to internal fragmentation.
GetApproximateMemTableStats()
could return disastrously bad estimates 5-25% of the time. The function has been re-engineered to return much better estimates with similar CPU cost.- Skip insertion of compressed blocks in the secondary cache if the lowest_used_cache_tier DB option is kVolatileTier.
- Fix an issue in level compaction where a small CF with small compaction debt can cause the DB to allow parallel compactions. (#13054)
- Several DB option settings could be lost through
GetOptionsFromString()
, possibly elsewhere as well. Affected options, now fixed:background_close_inactive_wals
,write_dbid_to_manifest
,write_identity_file
,prefix_seek_opt_in_only
9.7.0 (09/20/2024)
New Features
- Make Cache a customizable class that can be instantiated by the object registry.
- Add new option
prefix_seek_opt_in_only
that makes iterators generally safer when you might set aprefix_extractor
. Whenprefix_seek_opt_in_only=true
, which is expected to be the future default, prefix seek is only used whenprefix_same_as_start
orauto_prefix_mode
are set. Also,prefix_same_as_start
andauto_prefix_mode
now allow prefix filtering even withtotal_order_seek=true
.- Add a new table property "rocksdb.key.largest.seqno" which records the largest sequence number of all keys in file. It is verified to be zero during SST file ingestion.
... (truncated)
44e95d8
Update HISTORY and version to 9.8.4778f25f
Rely on PurgeObsoleteFiles Only for Options file clean up when remote
compact...1b497c9
Update HISTORY and version to 9.8.373be33c
Fix missing cases of corruption retries (#13122)139bfd0
Update patch version and HISTORY to 9.8.208ed842
Fix write committed transactions replay when UDT setting toggles (#13121)026659f
Add a new API Transaction::GetAttributeGroupIterator (#13119)7d2fe50
Some small improvements around allow_unprepared_value and multi-CF
iterators ...b569ba7
Make BaseDeltaIterator honor allow_unprepared_value (#13111)23f7cf1
Call PrepareValue on the base iterator in BaseDeltaIterator (#13105)