2016-02-09 23:12:00 +00:00
|
|
|
// Copyright (c) 2011-present, Facebook, Inc. All rights reserved.
|
2017-07-15 23:03:42 +00:00
|
|
|
// This source code is licensed under both the GPLv2 (found in the
|
|
|
|
// COPYING file in the root directory) and Apache 2.0 License
|
|
|
|
// (found in the LICENSE.Apache file in the root directory).
|
2013-10-16 21:59:46 +00:00
|
|
|
//
|
2011-03-18 22:37:00 +00:00
|
|
|
// Copyright (c) 2011 The LevelDB Authors. All rights reserved.
|
|
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
|
|
// found in the LICENSE file. See the AUTHORS file for names of contributors.
|
|
|
|
|
2016-02-16 20:16:47 +00:00
|
|
|
#ifdef GFLAGS
|
2014-07-07 17:53:31 +00:00
|
|
|
#ifdef NUMA
|
|
|
|
#include <numa.h>
|
|
|
|
#endif
|
2015-07-01 23:13:49 +00:00
|
|
|
#ifndef OS_WIN
|
2015-04-07 00:16:40 +00:00
|
|
|
#include <unistd.h>
|
2015-07-01 23:13:49 +00:00
|
|
|
#endif
|
2015-04-03 01:14:49 +00:00
|
|
|
#include <fcntl.h>
|
2011-03-18 22:37:00 +00:00
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
2016-10-18 23:30:57 +00:00
|
|
|
#include <sys/types.h>
|
2021-02-10 20:55:24 +00:00
|
|
|
#ifdef __APPLE__
|
|
|
|
#include <mach/host_info.h>
|
|
|
|
#include <mach/mach_host.h>
|
|
|
|
#include <sys/sysctl.h>
|
|
|
|
#endif
|
2021-04-09 17:34:01 +00:00
|
|
|
#ifdef __FreeBSD__
|
|
|
|
#include <sys/sysctl.h>
|
|
|
|
#endif
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
#include <atomic>
|
2019-09-20 19:00:55 +00:00
|
|
|
#include <cinttypes>
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
#include <condition_variable>
|
2016-10-18 23:30:57 +00:00
|
|
|
#include <cstddef>
|
2022-01-25 03:56:37 +00:00
|
|
|
#include <iostream>
|
2017-07-28 23:23:50 +00:00
|
|
|
#include <memory>
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
#include <mutex>
|
2021-07-29 21:57:03 +00:00
|
|
|
#include <queue>
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
#include <thread>
|
2015-12-08 01:33:18 +00:00
|
|
|
#include <unordered_map>
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
|
2022-07-13 15:45:44 +00:00
|
|
|
#include "cache/clock_cache.h"
|
2022-06-03 18:16:49 +00:00
|
|
|
#include "cache/fast_lru_cache.h"
|
2019-05-31 18:52:59 +00:00
|
|
|
#include "db/db_impl/db_impl.h"
|
2018-10-24 18:36:19 +00:00
|
|
|
#include "db/malloc_stats.h"
|
2011-03-18 22:37:00 +00:00
|
|
|
#include "db/version_set.h"
|
2017-04-06 02:02:00 +00:00
|
|
|
#include "monitoring/histogram.h"
|
|
|
|
#include "monitoring/statistics.h"
|
2018-10-24 18:36:19 +00:00
|
|
|
#include "options/cf_options.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "port/port.h"
|
|
|
|
#include "port/stack_trace.h"
|
2013-08-23 15:38:13 +00:00
|
|
|
#include "rocksdb/cache.h"
|
2021-06-15 10:42:52 +00:00
|
|
|
#include "rocksdb/convenience.h"
|
2013-08-23 15:38:13 +00:00
|
|
|
#include "rocksdb/db.h"
|
|
|
|
#include "rocksdb/env.h"
|
2014-09-08 17:37:05 +00:00
|
|
|
#include "rocksdb/filter_policy.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "rocksdb/memtablerep.h"
|
|
|
|
#include "rocksdb/options.h"
|
|
|
|
#include "rocksdb/perf_context.h"
|
2017-02-27 20:59:34 +00:00
|
|
|
#include "rocksdb/persistent_cache.h"
|
2015-05-13 00:40:27 +00:00
|
|
|
#include "rocksdb/rate_limiter.h"
|
2021-05-19 22:24:37 +00:00
|
|
|
#include "rocksdb/secondary_cache.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "rocksdb/slice.h"
|
2014-01-25 00:15:05 +00:00
|
|
|
#include "rocksdb/slice_transform.h"
|
2019-07-04 02:03:29 +00:00
|
|
|
#include "rocksdb/stats_history.h"
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
#include "rocksdb/table.h"
|
2022-05-24 17:28:57 +00:00
|
|
|
#include "rocksdb/utilities/backup_engine.h"
|
2017-01-25 23:54:09 +00:00
|
|
|
#include "rocksdb/utilities/object_registry.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "rocksdb/utilities/optimistic_transaction_db.h"
|
2021-05-19 22:24:37 +00:00
|
|
|
#include "rocksdb/utilities/options_type.h"
|
2016-06-02 23:24:14 +00:00
|
|
|
#include "rocksdb/utilities/options_util.h"
|
2021-08-12 02:31:44 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
#include "rocksdb/utilities/replayer.h"
|
|
|
|
#endif // ROCKSDB_LITE
|
2016-05-24 06:35:23 +00:00
|
|
|
#include "rocksdb/utilities/sim_cache.h"
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
#include "rocksdb/utilities/transaction.h"
|
|
|
|
#include "rocksdb/utilities/transaction_db.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "rocksdb/write_batch.h"
|
2019-05-31 00:39:43 +00:00
|
|
|
#include "test_util/testutil.h"
|
|
|
|
#include "test_util/transaction_test_util.h"
|
2021-05-03 20:30:00 +00:00
|
|
|
#include "tools/simulated_hybrid_file_system.h"
|
2017-07-28 23:23:50 +00:00
|
|
|
#include "util/cast_util.h"
|
2015-01-09 21:04:06 +00:00
|
|
|
#include "util/compression.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "util/crc32c.h"
|
2022-02-17 07:17:03 +00:00
|
|
|
#include "util/file_checksum_helper.h"
|
2017-12-01 18:40:45 +00:00
|
|
|
#include "util/gflags_compat.h"
|
2011-08-22 21:08:51 +00:00
|
|
|
#include "util/mutexlock.h"
|
2011-03-18 22:37:00 +00:00
|
|
|
#include "util/random.h"
|
2016-12-10 00:36:43 +00:00
|
|
|
#include "util/stderr_logger.h"
|
2016-03-03 19:20:25 +00:00
|
|
|
#include "util/string_util.h"
|
2014-05-01 18:09:32 +00:00
|
|
|
#include "util/xxhash.h"
|
2016-08-09 17:16:32 +00:00
|
|
|
#include "utilities/blob_db/blob_db.h"
|
2022-02-03 23:00:03 +00:00
|
|
|
#include "utilities/counted_fs.h"
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
#include "utilities/merge_operators.h"
|
2018-03-06 18:20:52 +00:00
|
|
|
#include "utilities/merge_operators/bytesxor.h"
|
New API to get all merge operands for a Key (#5604)
Summary:
This is a new API added to db.h to allow for fetching all merge operands associated with a Key. The main motivation for this API is to support use cases where doing a full online merge is not necessary as it is performance sensitive. Example use-cases:
1. Update subset of columns and read subset of columns -
Imagine a SQL Table, a row is encoded as a K/V pair (as it is done in MyRocks). If there are many columns and users only updated one of them, we can use merge operator to reduce write amplification. While users only read one or two columns in the read query, this feature can avoid a full merging of the whole row, and save some CPU.
2. Updating very few attributes in a value which is a JSON-like document -
Updating one attribute can be done efficiently using merge operator, while reading back one attribute can be done more efficiently if we don't need to do a full merge.
----------------------------------------------------------------------------------------------------
API :
Status GetMergeOperands(
const ReadOptions& options, ColumnFamilyHandle* column_family,
const Slice& key, PinnableSlice* merge_operands,
GetMergeOperandsOptions* get_merge_operands_options,
int* number_of_operands)
Example usage :
int size = 100;
int number_of_operands = 0;
std::vector<PinnableSlice> values(size);
GetMergeOperandsOptions merge_operands_info;
db_->GetMergeOperands(ReadOptions(), db_->DefaultColumnFamily(), "k1", values.data(), merge_operands_info, &number_of_operands);
Description :
Returns all the merge operands corresponding to the key. If the number of merge operands in DB is greater than merge_operands_options.expected_max_number_of_operands no merge operands are returned and status is Incomplete. Merge operands returned are in the order of insertion.
merge_operands-> Points to an array of at-least merge_operands_options.expected_max_number_of_operands and the caller is responsible for allocating it. If the status returned is Incomplete then number_of_operands will contain the total number of merge operands found in DB for key.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5604
Test Plan:
Added unit test and perf test in db_bench that can be run using the command:
./db_bench -benchmarks=getmergeoperands --merge_operator=sortlist
Differential Revision: D16657366
Pulled By: vjnadimpalli
fbshipit-source-id: 0faadd752351745224ee12d4ae9ef3cb529951bf
2019-08-06 21:22:34 +00:00
|
|
|
#include "utilities/merge_operators/sortlist.h"
|
2017-02-27 20:59:34 +00:00
|
|
|
#include "utilities/persistent_cache/block_cache_tier.h"
|
2011-03-18 22:37:00 +00:00
|
|
|
|
Provide an allocator for new memory type to be used with RocksDB block cache (#6214)
Summary:
New memory technologies are being developed by various hardware vendors (Intel DCPMM is one such technology currently available). These new memory types require different libraries for allocation and management (such as PMDK and memkind). The high capacities available make it possible to provision large caches (up to several TBs in size), beyond what is achievable with DRAM.
The new allocator provided in this PR uses the memkind library to allocate memory on different media.
**Performance**
We tested the new allocator using db_bench.
- For each test, we vary the size of the block cache (relative to the size of the uncompressed data in the database).
- The database is filled sequentially. Throughput is then measured with a readrandom benchmark.
- We use a uniform distribution as a worst-case scenario.
The plot shows throughput (ops/s) relative to a configuration with no block cache and default allocator.
For all tests, p99 latency is below 500 us.
![image](https://user-images.githubusercontent.com/26400080/71108594-42479100-2178-11ea-8231-8a775bbc92db.png)
**Changes**
- Add MemkindKmemAllocator
- Add --use_cache_memkind_kmem_allocator db_bench option (to create an LRU block cache with the new allocator)
- Add detection of memkind library with KMEM DAX support
- Add test for MemkindKmemAllocator
**Minimum Requirements**
- kernel 5.3.12
- ndctl v67 - https://github.com/pmem/ndctl
- memkind v1.10.0 - https://github.com/memkind/memkind
**Memory Configuration**
The allocator uses the MEMKIND_DAX_KMEM memory kind. Follow the instructions on[ memkind’s GitHub page](https://github.com/memkind/memkind) to set up NVDIMM memory accordingly.
Note on memory allocation with NVDIMM memory exposed as system memory.
- The MemkindKmemAllocator will only allocate from NVDIMM memory (using memkind_malloc with MEMKIND_DAX_KMEM kind).
- The default allocator is not restricted to RAM by default. Based on NUMA node latency, the kernel should allocate from local RAM preferentially, but it’s a kernel decision. numactl --preferred/--membind can be used to allocate preferentially/exclusively from the local RAM node.
**Usage**
When creating an LRU cache, pass a MemkindKmemAllocator object as argument.
For example (replace capacity with the desired value in bytes):
```
#include "rocksdb/cache.h"
#include "memory/memkind_kmem_allocator.h"
NewLRUCache(
capacity /*size_t*/,
6 /*cache_numshardbits*/,
false /*strict_capacity_limit*/,
false /*cache_high_pri_pool_ratio*/,
std::make_shared<MemkindKmemAllocator>());
```
Refer to [RocksDB’s block cache documentation](https://github.com/facebook/rocksdb/wiki/Block-Cache) to assign the LRU cache as block cache for a database.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6214
Reviewed By: cheng-chang
Differential Revision: D19292435
fbshipit-source-id: 7202f47b769e7722b539c86c2ffd669f64d7b4e1
2020-04-10 03:45:17 +00:00
|
|
|
#ifdef MEMKIND
|
|
|
|
#include "memory/memkind_kmem_allocator.h"
|
|
|
|
#endif
|
|
|
|
|
2015-07-01 23:13:49 +00:00
|
|
|
#ifdef OS_WIN
|
2015-07-13 19:11:05 +00:00
|
|
|
#include <io.h> // open/close
|
2015-07-01 23:13:49 +00:00
|
|
|
#endif
|
|
|
|
|
2017-12-01 18:40:45 +00:00
|
|
|
using GFLAGS_NAMESPACE::ParseCommandLineFlags;
|
|
|
|
using GFLAGS_NAMESPACE::RegisterFlagValidator;
|
|
|
|
using GFLAGS_NAMESPACE::SetUsageMessage;
|
2022-07-06 16:58:45 +00:00
|
|
|
using GFLAGS_NAMESPACE::SetVersionString;
|
2013-08-23 21:49:57 +00:00
|
|
|
|
2021-07-23 21:30:41 +00:00
|
|
|
#ifdef ROCKSDB_LITE
|
|
|
|
#define IF_ROCKSDB_LITE(Then, Else) Then
|
|
|
|
#else
|
|
|
|
#define IF_ROCKSDB_LITE(Then, Else) Else
|
|
|
|
#endif
|
|
|
|
|
2016-10-18 23:30:57 +00:00
|
|
|
DEFINE_string(
|
|
|
|
benchmarks,
|
|
|
|
"fillseq,"
|
|
|
|
"fillseqdeterministic,"
|
|
|
|
"fillsync,"
|
|
|
|
"fillrandom,"
|
|
|
|
"filluniquerandomdeterministic,"
|
|
|
|
"overwrite,"
|
|
|
|
"readrandom,"
|
|
|
|
"newiterator,"
|
|
|
|
"newiteratorwhilewriting,"
|
|
|
|
"seekrandom,"
|
|
|
|
"seekrandomwhilewriting,"
|
|
|
|
"seekrandomwhilemerging,"
|
|
|
|
"readseq,"
|
|
|
|
"readreverse,"
|
|
|
|
"compact,"
|
2017-05-30 23:33:26 +00:00
|
|
|
"compactall,"
|
2021-03-17 16:10:24 +00:00
|
|
|
"flush,"
|
2021-07-23 21:30:41 +00:00
|
|
|
IF_ROCKSDB_LITE("",
|
2021-03-17 16:10:24 +00:00
|
|
|
"compact0,"
|
|
|
|
"compact1,"
|
|
|
|
"waitforcompaction,"
|
2021-07-23 21:30:41 +00:00
|
|
|
)
|
2016-10-18 23:30:57 +00:00
|
|
|
"multireadrandom,"
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
"mixgraph,"
|
2016-10-18 23:30:57 +00:00
|
|
|
"readseq,"
|
2019-09-10 18:03:31 +00:00
|
|
|
"readtorowcache,"
|
2016-10-18 23:30:57 +00:00
|
|
|
"readtocache,"
|
|
|
|
"readreverse,"
|
|
|
|
"readwhilewriting,"
|
|
|
|
"readwhilemerging,"
|
2018-05-24 22:45:49 +00:00
|
|
|
"readwhilescanning,"
|
2016-10-18 23:30:57 +00:00
|
|
|
"readrandomwriterandom,"
|
|
|
|
"updaterandom,"
|
2018-03-06 18:20:52 +00:00
|
|
|
"xorupdaterandom,"
|
For ApproximateSizes, pro-rate table metadata size over data blocks (#6784)
Summary:
The implementation of GetApproximateSizes was inconsistent in
its treatment of the size of non-data blocks of SST files, sometimes
including and sometimes now. This was at its worst with large portion
of table file used by filters and querying a small range that crossed
a table boundary: the size estimate would include large filter size.
It's conceivable that someone might want only to know the size in terms
of data blocks, but I believe that's unlikely enough to ignore for now.
Similarly, there's no evidence the internal function AppoximateOffsetOf
is used for anything other than a one-sided ApproximateSize, so I intend
to refactor to remove redundancy in a follow-up commit.
So to fix this, GetApproximateSizes (and implementation details
ApproximateSize and ApproximateOffsetOf) now consistently include in
their returned sizes a portion of table file metadata (incl filters
and indexes) based on the size portion of the data blocks in range. In
other words, if a key range covers data blocks that are X% by size of all
the table's data blocks, returned approximate size is X% of the total
file size. It would technically be more accurate to attribute metadata
based on number of keys, but that's not computationally efficient with
data available and rarely a meaningful difference.
Also includes miscellaneous comment improvements / clarifications.
Also included is a new approximatesizerandom benchmark for db_bench.
No significant performance difference seen with this change, whether ~700 ops/sec with cache_index_and_filter_blocks and small cache or ~150k ops/sec without cache_index_and_filter_blocks.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6784
Test Plan:
Test added to DBTest.ApproximateSizesFilesWithErrorMargin.
Old code running new test...
[ RUN ] DBTest.ApproximateSizesFilesWithErrorMargin
db/db_test.cc:1562: Failure
Expected: (size) <= (11 * 100), actual: 9478 vs 1100
Other tests updated to reflect consistent accounting of metadata.
Reviewed By: siying
Differential Revision: D21334706
Pulled By: pdillinger
fbshipit-source-id: 6f86870e45213334fedbe9c73b4ebb1d8d611185
2020-06-02 19:27:59 +00:00
|
|
|
"approximatesizerandom,"
|
2016-10-18 23:30:57 +00:00
|
|
|
"randomwithverify,"
|
|
|
|
"fill100K,"
|
|
|
|
"crc32c,"
|
|
|
|
"xxhash,"
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
"xxhash64,"
|
|
|
|
"xxh3,"
|
2016-10-18 23:30:57 +00:00
|
|
|
"compress,"
|
|
|
|
"uncompress,"
|
|
|
|
"acquireload,"
|
|
|
|
"fillseekseq,"
|
|
|
|
"randomtransaction,"
|
|
|
|
"randomreplacekeys,"
|
New API to get all merge operands for a Key (#5604)
Summary:
This is a new API added to db.h to allow for fetching all merge operands associated with a Key. The main motivation for this API is to support use cases where doing a full online merge is not necessary as it is performance sensitive. Example use-cases:
1. Update subset of columns and read subset of columns -
Imagine a SQL Table, a row is encoded as a K/V pair (as it is done in MyRocks). If there are many columns and users only updated one of them, we can use merge operator to reduce write amplification. While users only read one or two columns in the read query, this feature can avoid a full merging of the whole row, and save some CPU.
2. Updating very few attributes in a value which is a JSON-like document -
Updating one attribute can be done efficiently using merge operator, while reading back one attribute can be done more efficiently if we don't need to do a full merge.
----------------------------------------------------------------------------------------------------
API :
Status GetMergeOperands(
const ReadOptions& options, ColumnFamilyHandle* column_family,
const Slice& key, PinnableSlice* merge_operands,
GetMergeOperandsOptions* get_merge_operands_options,
int* number_of_operands)
Example usage :
int size = 100;
int number_of_operands = 0;
std::vector<PinnableSlice> values(size);
GetMergeOperandsOptions merge_operands_info;
db_->GetMergeOperands(ReadOptions(), db_->DefaultColumnFamily(), "k1", values.data(), merge_operands_info, &number_of_operands);
Description :
Returns all the merge operands corresponding to the key. If the number of merge operands in DB is greater than merge_operands_options.expected_max_number_of_operands no merge operands are returned and status is Incomplete. Merge operands returned are in the order of insertion.
merge_operands-> Points to an array of at-least merge_operands_options.expected_max_number_of_operands and the caller is responsible for allocating it. If the status returned is Incomplete then number_of_operands will contain the total number of merge operands found in DB for key.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5604
Test Plan:
Added unit test and perf test in db_bench that can be run using the command:
./db_bench -benchmarks=getmergeoperands --merge_operator=sortlist
Differential Revision: D16657366
Pulled By: vjnadimpalli
fbshipit-source-id: 0faadd752351745224ee12d4ae9ef3cb529951bf
2019-08-06 21:22:34 +00:00
|
|
|
"timeseries,"
|
2022-05-24 17:28:57 +00:00
|
|
|
"getmergeoperands,",
|
2022-04-01 04:23:58 +00:00
|
|
|
"readrandomoperands,"
|
2022-05-24 17:28:57 +00:00
|
|
|
"backup,"
|
|
|
|
"restore"
|
2016-10-18 23:30:57 +00:00
|
|
|
|
|
|
|
"Comma-separated list of operations to run in the specified"
|
|
|
|
" order. Available benchmarks:\n"
|
|
|
|
"\tfillseq -- write N values in sequential key"
|
|
|
|
" order in async mode\n"
|
|
|
|
"\tfillseqdeterministic -- write N values in the specified"
|
|
|
|
" key order and keep the shape of the LSM tree\n"
|
|
|
|
"\tfillrandom -- write N values in random key order in async"
|
|
|
|
" mode\n"
|
|
|
|
"\tfilluniquerandomdeterministic -- write N values in a random"
|
|
|
|
" key order and keep the shape of the LSM tree\n"
|
|
|
|
"\toverwrite -- overwrite N values in random key order in"
|
|
|
|
" async mode\n"
|
2020-02-12 22:44:46 +00:00
|
|
|
"\tfillsync -- write N/1000 values in random key order in "
|
2016-10-18 23:30:57 +00:00
|
|
|
"sync mode\n"
|
|
|
|
"\tfill100K -- write N/1000 100K values in random order in"
|
|
|
|
" async mode\n"
|
|
|
|
"\tdeleteseq -- delete N keys in sequential order\n"
|
|
|
|
"\tdeleterandom -- delete N keys in random order\n"
|
|
|
|
"\treadseq -- read N times sequentially\n"
|
|
|
|
"\treadtocache -- 1 thread reading database sequentially\n"
|
|
|
|
"\treadreverse -- read N times in reverse order\n"
|
|
|
|
"\treadrandom -- read N times in random order\n"
|
|
|
|
"\treadmissing -- read N missing keys in random order\n"
|
|
|
|
"\treadwhilewriting -- 1 writer, N threads doing random "
|
|
|
|
"reads\n"
|
|
|
|
"\treadwhilemerging -- 1 merger, N threads doing random "
|
|
|
|
"reads\n"
|
2018-05-24 22:45:49 +00:00
|
|
|
"\treadwhilescanning -- 1 thread doing full table scan, "
|
|
|
|
"N threads doing random reads\n"
|
2016-10-18 23:30:57 +00:00
|
|
|
"\treadrandomwriterandom -- N threads doing random-read, "
|
|
|
|
"random-write\n"
|
|
|
|
"\tupdaterandom -- N threads doing read-modify-write for random "
|
|
|
|
"keys\n"
|
2018-03-06 18:20:52 +00:00
|
|
|
"\txorupdaterandom -- N threads doing read-XOR-write for "
|
|
|
|
"random keys\n"
|
2016-10-18 23:30:57 +00:00
|
|
|
"\tappendrandom -- N threads doing read-modify-write with "
|
|
|
|
"growing values\n"
|
|
|
|
"\tmergerandom -- same as updaterandom/appendrandom using merge"
|
|
|
|
" operator. "
|
|
|
|
"Must be used with merge_operator\n"
|
|
|
|
"\treadrandommergerandom -- perform N random read-or-merge "
|
|
|
|
"operations. Must be used with merge_operator\n"
|
|
|
|
"\tnewiterator -- repeated iterator creation\n"
|
|
|
|
"\tseekrandom -- N random seeks, call Next seek_nexts times "
|
|
|
|
"per seek\n"
|
|
|
|
"\tseekrandomwhilewriting -- seekrandom and 1 thread doing "
|
|
|
|
"overwrite\n"
|
|
|
|
"\tseekrandomwhilemerging -- seekrandom and 1 thread doing "
|
|
|
|
"merge\n"
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
"\tcrc32c -- repeated crc32c of <block size> data\n"
|
|
|
|
"\txxhash -- repeated xxHash of <block size> data\n"
|
|
|
|
"\txxhash64 -- repeated xxHash64 of <block size> data\n"
|
|
|
|
"\txxh3 -- repeated XXH3 of <block size> data\n"
|
2016-10-18 23:30:57 +00:00
|
|
|
"\tacquireload -- load N*1000 times\n"
|
|
|
|
"\tfillseekseq -- write N values in sequential key, then read "
|
|
|
|
"them by seeking to each key\n"
|
|
|
|
"\trandomtransaction -- execute N random transactions and "
|
|
|
|
"verify correctness\n"
|
|
|
|
"\trandomreplacekeys -- randomly replaces N keys by deleting "
|
|
|
|
"the old version and putting the new version\n\n"
|
|
|
|
"\ttimeseries -- 1 writer generates time series data "
|
|
|
|
"and multiple readers doing random reads on id\n\n"
|
|
|
|
"Meta operations:\n"
|
2017-05-31 22:33:02 +00:00
|
|
|
"\tcompact -- Compact the entire DB; If multiple, randomly choose one\n"
|
|
|
|
"\tcompactall -- Compact the entire DB\n"
|
2021-07-23 21:30:41 +00:00
|
|
|
IF_ROCKSDB_LITE("",
|
2021-03-17 16:10:24 +00:00
|
|
|
"\tcompact0 -- compact L0 into L1\n"
|
|
|
|
"\tcompact1 -- compact L1 into L2\n"
|
|
|
|
"\twaitforcompaction - pause until compaction is (probably) done\n"
|
2021-07-23 21:30:41 +00:00
|
|
|
)
|
2021-03-17 16:10:24 +00:00
|
|
|
"\tflush - flush the memtable\n"
|
2016-10-18 23:30:57 +00:00
|
|
|
"\tstats -- Print DB stats\n"
|
2017-04-18 23:30:51 +00:00
|
|
|
"\tresetstats -- Reset DB stats\n"
|
2016-10-18 23:30:57 +00:00
|
|
|
"\tlevelstats -- Print the number of files and bytes per level\n"
|
2021-03-17 16:10:24 +00:00
|
|
|
"\tmemstats -- Print memtable stats\n"
|
2016-10-18 23:30:57 +00:00
|
|
|
"\tsstables -- Print sstable info\n"
|
2018-08-01 07:14:43 +00:00
|
|
|
"\theapprofile -- Dump a heap profile (if supported by this port)\n"
|
2021-11-29 22:26:54 +00:00
|
|
|
IF_ROCKSDB_LITE("",
|
New API to get all merge operands for a Key (#5604)
Summary:
This is a new API added to db.h to allow for fetching all merge operands associated with a Key. The main motivation for this API is to support use cases where doing a full online merge is not necessary as it is performance sensitive. Example use-cases:
1. Update subset of columns and read subset of columns -
Imagine a SQL Table, a row is encoded as a K/V pair (as it is done in MyRocks). If there are many columns and users only updated one of them, we can use merge operator to reduce write amplification. While users only read one or two columns in the read query, this feature can avoid a full merging of the whole row, and save some CPU.
2. Updating very few attributes in a value which is a JSON-like document -
Updating one attribute can be done efficiently using merge operator, while reading back one attribute can be done more efficiently if we don't need to do a full merge.
----------------------------------------------------------------------------------------------------
API :
Status GetMergeOperands(
const ReadOptions& options, ColumnFamilyHandle* column_family,
const Slice& key, PinnableSlice* merge_operands,
GetMergeOperandsOptions* get_merge_operands_options,
int* number_of_operands)
Example usage :
int size = 100;
int number_of_operands = 0;
std::vector<PinnableSlice> values(size);
GetMergeOperandsOptions merge_operands_info;
db_->GetMergeOperands(ReadOptions(), db_->DefaultColumnFamily(), "k1", values.data(), merge_operands_info, &number_of_operands);
Description :
Returns all the merge operands corresponding to the key. If the number of merge operands in DB is greater than merge_operands_options.expected_max_number_of_operands no merge operands are returned and status is Incomplete. Merge operands returned are in the order of insertion.
merge_operands-> Points to an array of at-least merge_operands_options.expected_max_number_of_operands and the caller is responsible for allocating it. If the status returned is Incomplete then number_of_operands will contain the total number of merge operands found in DB for key.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5604
Test Plan:
Added unit test and perf test in db_bench that can be run using the command:
./db_bench -benchmarks=getmergeoperands --merge_operator=sortlist
Differential Revision: D16657366
Pulled By: vjnadimpalli
fbshipit-source-id: 0faadd752351745224ee12d4ae9ef3cb529951bf
2019-08-06 21:22:34 +00:00
|
|
|
"\treplay -- replay the trace file specified with trace_file\n"
|
2021-11-29 22:26:54 +00:00
|
|
|
)
|
New API to get all merge operands for a Key (#5604)
Summary:
This is a new API added to db.h to allow for fetching all merge operands associated with a Key. The main motivation for this API is to support use cases where doing a full online merge is not necessary as it is performance sensitive. Example use-cases:
1. Update subset of columns and read subset of columns -
Imagine a SQL Table, a row is encoded as a K/V pair (as it is done in MyRocks). If there are many columns and users only updated one of them, we can use merge operator to reduce write amplification. While users only read one or two columns in the read query, this feature can avoid a full merging of the whole row, and save some CPU.
2. Updating very few attributes in a value which is a JSON-like document -
Updating one attribute can be done efficiently using merge operator, while reading back one attribute can be done more efficiently if we don't need to do a full merge.
----------------------------------------------------------------------------------------------------
API :
Status GetMergeOperands(
const ReadOptions& options, ColumnFamilyHandle* column_family,
const Slice& key, PinnableSlice* merge_operands,
GetMergeOperandsOptions* get_merge_operands_options,
int* number_of_operands)
Example usage :
int size = 100;
int number_of_operands = 0;
std::vector<PinnableSlice> values(size);
GetMergeOperandsOptions merge_operands_info;
db_->GetMergeOperands(ReadOptions(), db_->DefaultColumnFamily(), "k1", values.data(), merge_operands_info, &number_of_operands);
Description :
Returns all the merge operands corresponding to the key. If the number of merge operands in DB is greater than merge_operands_options.expected_max_number_of_operands no merge operands are returned and status is Incomplete. Merge operands returned are in the order of insertion.
merge_operands-> Points to an array of at-least merge_operands_options.expected_max_number_of_operands and the caller is responsible for allocating it. If the status returned is Incomplete then number_of_operands will contain the total number of merge operands found in DB for key.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5604
Test Plan:
Added unit test and perf test in db_bench that can be run using the command:
./db_bench -benchmarks=getmergeoperands --merge_operator=sortlist
Differential Revision: D16657366
Pulled By: vjnadimpalli
fbshipit-source-id: 0faadd752351745224ee12d4ae9ef3cb529951bf
2019-08-06 21:22:34 +00:00
|
|
|
"\tgetmergeoperands -- Insert lots of merge records which are a list of "
|
|
|
|
"sorted ints for a key and then compare performance of lookup for another "
|
2022-04-01 23:06:14 +00:00
|
|
|
"key by doing a Get followed by binary searching in the large sorted list "
|
|
|
|
"vs doing a GetMergeOperands and binary searching in the operands which "
|
|
|
|
"are sorted sub-lists. The MergeOperator used is sortlist.h\n"
|
2022-04-01 04:23:58 +00:00
|
|
|
"\treadrandomoperands -- read random keys using `GetMergeOperands()`. An "
|
|
|
|
"operation includes a rare but possible retry in case it got "
|
|
|
|
"`Status::Incomplete()`. This happens upon encountering more keys than "
|
2022-05-24 17:28:57 +00:00
|
|
|
"have ever been seen by the thread (or eight initially)\n"
|
|
|
|
"\tbackup -- Create a backup of the current DB and verify that a new backup is corrected. "
|
|
|
|
"Rate limit can be specified through --backup_rate_limit\n"
|
|
|
|
"\trestore -- Restore the DB from the latest backup available, rate limit can be specified through --restore_rate_limit\n");
|
2013-10-24 14:43:14 +00:00
|
|
|
|
|
|
|
DEFINE_int64(num, 1000000, "Number of key/values to place in database");
|
|
|
|
|
|
|
|
DEFINE_int64(numdistinct, 1000,
|
|
|
|
"Number of distinct keys to use. Used in RandomWithVerify to "
|
|
|
|
"read/write on fewer keys so that gets are more likely to find the"
|
|
|
|
" key and puts are more likely to update the same key");
|
|
|
|
|
2014-01-11 01:33:56 +00:00
|
|
|
DEFINE_int64(merge_keys, -1,
|
|
|
|
"Number of distinct keys to use for MergeRandom and "
|
|
|
|
"ReadRandomMergeRandom. "
|
|
|
|
"If negative, there will be FLAGS_num keys.");
|
2014-08-19 01:15:01 +00:00
|
|
|
DEFINE_int32(num_column_families, 1, "Number of Column Families to use.");
|
2014-01-11 01:33:56 +00:00
|
|
|
|
2014-12-23 02:39:28 +00:00
|
|
|
DEFINE_int32(
|
2014-12-24 16:54:28 +00:00
|
|
|
num_hot_column_families, 0,
|
2014-12-23 02:39:28 +00:00
|
|
|
"Number of Hot Column Families. If more than 0, only write to this "
|
|
|
|
"number of column families. After finishing all the writes to them, "
|
|
|
|
"create new set of column families and insert to them. Only used "
|
|
|
|
"when num_column_families > 1.");
|
|
|
|
|
2017-08-11 20:46:41 +00:00
|
|
|
DEFINE_string(column_family_distribution, "",
|
|
|
|
"Comma-separated list of percentages, where the ith element "
|
|
|
|
"indicates the probability of an op using the ith column family. "
|
|
|
|
"The number of elements must be `num_hot_column_families` if "
|
|
|
|
"specified; otherwise, it must be `num_column_families`. The "
|
|
|
|
"sum of elements must be 100. E.g., if `num_column_families=4`, "
|
|
|
|
"and `num_hot_column_families=0`, a valid list could be "
|
|
|
|
"\"10,20,30,40\".");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int64(reads, -1, "Number of read operations to do. "
|
|
|
|
"If negative, do FLAGS_num reads.");
|
|
|
|
|
2016-06-28 21:10:24 +00:00
|
|
|
DEFINE_int64(deletes, -1, "Number of delete operations to do. "
|
|
|
|
"If negative, do FLAGS_num deletions.");
|
|
|
|
|
2014-03-28 16:21:20 +00:00
|
|
|
DEFINE_int32(bloom_locality, 0, "Control bloom filter probes locality");
|
|
|
|
|
2022-03-25 17:12:27 +00:00
|
|
|
DEFINE_int64(seed, 0,
|
|
|
|
"Seed base for random number generators. "
|
|
|
|
"When 0 it is derived from the current time.");
|
|
|
|
static int64_t seed_base;
|
2013-10-24 14:43:14 +00:00
|
|
|
|
|
|
|
DEFINE_int32(threads, 1, "Number of concurrent threads to run.");
|
|
|
|
|
|
|
|
DEFINE_int32(duration, 0, "Time in seconds for the random-ops tests to run."
|
|
|
|
" When 0 then num & reads determine the test duration");
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
DEFINE_string(value_size_distribution_type, "fixed",
|
|
|
|
"Value size distribution type: fixed, uniform, normal");
|
|
|
|
|
|
|
|
DEFINE_int32(value_size, 100, "Size of each value in fixed distribution");
|
|
|
|
static unsigned int value_size = 100;
|
|
|
|
|
|
|
|
DEFINE_int32(value_size_min, 100, "Min size of random value");
|
|
|
|
|
|
|
|
DEFINE_int32(value_size_max, 102400, "Max size of random value");
|
2013-08-23 21:49:57 +00:00
|
|
|
|
2014-10-17 17:20:25 +00:00
|
|
|
DEFINE_int32(seek_nexts, 0,
|
|
|
|
"How many times to call Next() after Seek() in "
|
2015-03-30 18:28:25 +00:00
|
|
|
"fillseekseq, seekrandom, seekrandomwhilewriting and "
|
|
|
|
"seekrandomwhilemerging");
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
|
2015-03-18 20:50:52 +00:00
|
|
|
DEFINE_bool(reverse_iterator, false,
|
|
|
|
"When true use Prev rather than Next for iterators that do "
|
|
|
|
"Seek and then Next");
|
|
|
|
|
2022-05-19 20:09:03 +00:00
|
|
|
DEFINE_bool(auto_prefix_mode, false, "Set auto_prefix_mode for seek benchmark");
|
|
|
|
|
2018-11-14 18:39:54 +00:00
|
|
|
DEFINE_int64(max_scan_distance, 0,
|
|
|
|
"Used to define iterate_upper_bound (or iterate_lower_bound "
|
|
|
|
"if FLAGS_reverse_iterator is set to true) when value is nonzero");
|
|
|
|
|
2014-08-27 17:39:31 +00:00
|
|
|
DEFINE_bool(use_uint64_comparator, false, "use Uint64 user comparator");
|
2013-01-03 20:11:50 +00:00
|
|
|
|
2014-09-25 20:34:51 +00:00
|
|
|
DEFINE_int64(batch_size, 1, "Batch size");
|
|
|
|
|
2018-03-05 21:08:17 +00:00
|
|
|
static bool ValidateKeySize(const char* /*flagname*/, int32_t /*value*/) {
|
2013-10-24 14:43:14 +00:00
|
|
|
return true;
|
|
|
|
}
|
2014-04-09 18:25:21 +00:00
|
|
|
|
2015-08-21 21:25:34 +00:00
|
|
|
static bool ValidateUint32Range(const char* flagname, uint64_t value) {
|
|
|
|
if (value > std::numeric_limits<uint32_t>::max()) {
|
Fixing race condition in DBTest.DynamicMemtableOptions
Summary:
This patch fixes a race condition in DBTEst.DynamicMemtableOptions. In rare cases,
it was possible that the main thread would fill up both memtables before the flush
job acquired its work. Then, the flush job was flushing both memtables together,
producing only one L0 file while the test expected two. Now, the test waits for
flushes to finish earlier, to make sure that the memtables are flushed in separate
flush jobs.
Test Plan:
Insert "usleep(10000);" after "IOSTATS_SET_THREAD_POOL_ID(Env::Priority::HIGH);" in BGWorkFlush()
to make the issue more likely. Then test with:
make db_test && time while ./db_test --gtest_filter=*DynamicMemtableOptions; do true; done
Reviewers: rven, sdong, yhchiang, anthony, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45429
2015-08-25 00:04:18 +00:00
|
|
|
fprintf(stderr, "Invalid value for --%s: %lu, overflow\n", flagname,
|
2015-08-21 21:25:34 +00:00
|
|
|
(unsigned long)value);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(key_size, 16, "size of each key");
|
2013-03-01 22:10:09 +00:00
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
DEFINE_int32(user_timestamp_size, 0,
|
|
|
|
"number of bytes in a user-defined timestamp");
|
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
DEFINE_int32(num_multi_db, 0,
|
|
|
|
"Number of DBs used in the benchmark. 0 means single DB.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_double(compression_ratio, 0.5, "Arrange to generate values that shrink"
|
|
|
|
" to this fraction of their original size after compression");
|
2011-03-18 22:37:00 +00:00
|
|
|
|
2021-07-21 18:32:36 +00:00
|
|
|
DEFINE_double(
|
|
|
|
overwrite_probability, 0.0,
|
|
|
|
"Used in 'filluniquerandom' benchmark: for each write operation, "
|
|
|
|
"we give a probability to perform an overwrite instead. The key used for "
|
|
|
|
"the overwrite is randomly chosen from the last 'overwrite_window_size' "
|
2022-04-01 23:06:14 +00:00
|
|
|
"keys previously inserted into the DB. "
|
2021-07-21 18:32:36 +00:00
|
|
|
"Valid overwrite_probability values: [0.0, 1.0].");
|
|
|
|
|
|
|
|
DEFINE_uint32(overwrite_window_size, 1,
|
2022-04-01 23:06:14 +00:00
|
|
|
"Used in 'filluniquerandom' benchmark. For each write operation,"
|
|
|
|
" when the overwrite_probability flag is set by the user, the "
|
|
|
|
"key used to perform an overwrite is randomly chosen from the "
|
|
|
|
"last 'overwrite_window_size' keys previously inserted into DB. "
|
2021-07-21 18:32:36 +00:00
|
|
|
"Warning: large values can affect throughput. "
|
|
|
|
"Valid overwrite_window_size values: [1, kMaxUint32].");
|
|
|
|
|
2021-07-29 21:57:03 +00:00
|
|
|
DEFINE_uint64(
|
|
|
|
disposable_entries_delete_delay, 0,
|
|
|
|
"Minimum delay in microseconds for the series of Deletes "
|
|
|
|
"to be issued. When 0 the insertion of the last disposable entry is "
|
|
|
|
"immediately followed by the issuance of the Deletes. "
|
|
|
|
"(only compatible with fillanddeleteuniquerandom benchmark).");
|
|
|
|
|
|
|
|
DEFINE_uint64(disposable_entries_batch_size, 0,
|
|
|
|
"Number of consecutively inserted disposable KV entries "
|
|
|
|
"that will be deleted after 'delete_delay' microseconds. "
|
|
|
|
"A series of Deletes is always issued once all the "
|
|
|
|
"disposable KV entries it targets have been inserted "
|
|
|
|
"into the DB. When 0 no deletes are issued and a "
|
|
|
|
"regular 'filluniquerandom' benchmark occurs. "
|
|
|
|
"(only compatible with fillanddeleteuniquerandom benchmark)");
|
|
|
|
|
|
|
|
DEFINE_int32(disposable_entries_value_size, 64,
|
|
|
|
"Size of the values (in bytes) of the entries targeted by "
|
|
|
|
"selective deletes. "
|
|
|
|
"(only compatible with fillanddeleteuniquerandom benchmark)");
|
|
|
|
|
|
|
|
DEFINE_uint64(
|
|
|
|
persistent_entries_batch_size, 0,
|
|
|
|
"Number of KV entries being inserted right before the deletes "
|
|
|
|
"targeting the disposable KV entries are issued. These "
|
|
|
|
"persistent keys are not targeted by the deletes, and will always "
|
|
|
|
"remain valid in the DB. (only compatible with "
|
|
|
|
"--benchmarks='fillanddeleteuniquerandom' "
|
|
|
|
"and used when--disposable_entries_batch_size is > 0).");
|
|
|
|
|
|
|
|
DEFINE_int32(persistent_entries_value_size, 64,
|
|
|
|
"Size of the values (in bytes) of the entries not targeted by "
|
|
|
|
"deletes. (only compatible with "
|
|
|
|
"--benchmarks='fillanddeleteuniquerandom' "
|
|
|
|
"and used when--disposable_entries_batch_size is > 0).");
|
|
|
|
|
2015-03-07 00:38:50 +00:00
|
|
|
DEFINE_double(read_random_exp_range, 0.0,
|
|
|
|
"Read random's key will be generated using distribution of "
|
2015-07-15 17:21:09 +00:00
|
|
|
"num * exp(-r) where r is uniform number from 0 to this value. "
|
2015-03-07 00:38:50 +00:00
|
|
|
"The larger the number is, the more skewed the reads are. "
|
|
|
|
"Only used in readrandom and multireadrandom benchmarks.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(histogram, false, "Print histogram of operation timings");
|
2011-03-18 22:37:00 +00:00
|
|
|
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
DEFINE_bool(confidence_interval_only, false,
|
|
|
|
"Print 95% confidence interval upper and lower bounds only for "
|
|
|
|
"aggregate stats.");
|
|
|
|
|
2014-07-07 17:53:31 +00:00
|
|
|
DEFINE_bool(enable_numa, false,
|
|
|
|
"Make operations aware of NUMA architecture and bind memory "
|
|
|
|
"and cpus corresponding to nodes together. In NUMA, memory "
|
|
|
|
"in same node as CPUs are closer when compared to memory in "
|
|
|
|
"other nodes. Reads can be faster when the process is bound to "
|
|
|
|
"CPU and memory of same node. Use \"$numactl --hardware\" command "
|
|
|
|
"to see NUMA memory architecture.");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int64(db_write_buffer_size,
|
|
|
|
ROCKSDB_NAMESPACE::Options().db_write_buffer_size,
|
2014-12-02 20:09:20 +00:00
|
|
|
"Number of bytes to buffer in all memtables before compacting");
|
|
|
|
|
2017-06-02 21:13:59 +00:00
|
|
|
DEFINE_bool(cost_write_buffer_to_cache, false,
|
|
|
|
"The usage of memtable is costed to the block cache");
|
|
|
|
|
2020-11-16 21:05:21 +00:00
|
|
|
DEFINE_int64(arena_block_size, ROCKSDB_NAMESPACE::Options().arena_block_size,
|
|
|
|
"The size, in bytes, of one block in arena memory allocation.");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int64(write_buffer_size, ROCKSDB_NAMESPACE::Options().write_buffer_size,
|
2013-10-24 14:43:14 +00:00
|
|
|
"Number of bytes to buffer in memtable before compacting");
|
2011-04-12 19:38:58 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(max_write_buffer_number,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_write_buffer_number,
|
2013-10-24 14:43:14 +00:00
|
|
|
"The number of in-memory memtables. Each memtable is of size"
|
2018-04-17 16:41:57 +00:00
|
|
|
" write_buffer_size bytes.");
|
2012-10-19 21:00:53 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(min_write_buffer_number_to_merge,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().min_write_buffer_number_to_merge,
|
2013-10-24 14:43:14 +00:00
|
|
|
"The minimum number of write buffers that will be merged together"
|
|
|
|
"before writing to storage. This is cheap because it is an"
|
|
|
|
"in-memory merge. If this feature is not enabled, then all these"
|
|
|
|
"write buffers are flushed to L0 as separate files and this "
|
|
|
|
"increases read amplification because a get request has to check"
|
|
|
|
" in all of these files. Also, an in-memory merge may result in"
|
|
|
|
" writing less data to storage if there are duplicate records "
|
|
|
|
" in each of these individual write buffers.");
|
2013-06-11 21:23:58 +00:00
|
|
|
|
Support saving history in memtable_list
Summary:
For transactions, we are using the memtables to validate that there are no write conflicts. But after flushing, we don't have any memtables, and transactions could fail to commit. So we want to someone keep around some extra history to use for conflict checking. In addition, we want to provide a way to increase the size of this history if too many transactions fail to commit.
After chatting with people, it seems like everyone prefers just using Memtables to store this history (instead of a separate history structure). It seems like the best place for this is abstracted inside the memtable_list. I decide to create a separate list in MemtableListVersion as using the same list complicated the flush/installalflushresults logic too much.
This diff adds a new parameter to control how much memtable history to keep around after flushing. However, it sounds like people aren't too fond of adding new parameters. So I am making the default size of flushed+not-flushed memtables be set to max_write_buffers. This should not change the maximum amount of memory used, but make it more likely we're using closer the the limit. (We are now postponing deleting flushed memtables until the max_write_buffer limit is reached). So while we might use more memory on average, we are still obeying the limit set (and you could argue it's better to go ahead and use up memory now instead of waiting for a write stall to happen to test this limit).
However, if people are opposed to this default behavior, we can easily set it to 0 and require this parameter be set in order to use transactions.
Test Plan: Added a xfunc test to play around with setting different values of this parameter in all tests. Added testing in memtablelist_test and planning on adding more testing here.
Reviewers: sdong, rven, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D37443
2015-05-28 23:34:24 +00:00
|
|
|
DEFINE_int32(max_write_buffer_number_to_maintain,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_write_buffer_number_to_maintain,
|
Support saving history in memtable_list
Summary:
For transactions, we are using the memtables to validate that there are no write conflicts. But after flushing, we don't have any memtables, and transactions could fail to commit. So we want to someone keep around some extra history to use for conflict checking. In addition, we want to provide a way to increase the size of this history if too many transactions fail to commit.
After chatting with people, it seems like everyone prefers just using Memtables to store this history (instead of a separate history structure). It seems like the best place for this is abstracted inside the memtable_list. I decide to create a separate list in MemtableListVersion as using the same list complicated the flush/installalflushresults logic too much.
This diff adds a new parameter to control how much memtable history to keep around after flushing. However, it sounds like people aren't too fond of adding new parameters. So I am making the default size of flushed+not-flushed memtables be set to max_write_buffers. This should not change the maximum amount of memory used, but make it more likely we're using closer the the limit. (We are now postponing deleting flushed memtables until the max_write_buffer limit is reached). So while we might use more memory on average, we are still obeying the limit set (and you could argue it's better to go ahead and use up memory now instead of waiting for a write stall to happen to test this limit).
However, if people are opposed to this default behavior, we can easily set it to 0 and require this parameter be set in order to use transactions.
Test Plan: Added a xfunc test to play around with setting different values of this parameter in all tests. Added testing in memtablelist_test and planning on adding more testing here.
Reviewers: sdong, rven, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D37443
2015-05-28 23:34:24 +00:00
|
|
|
"The total maximum number of write buffers to maintain in memory "
|
|
|
|
"including copies of buffers that have already been flushed. "
|
|
|
|
"Unlike max_write_buffer_number, this parameter does not affect "
|
|
|
|
"flushing. This controls the minimum amount of write history "
|
|
|
|
"that will be available in memory for conflict checking when "
|
|
|
|
"Transactions are used. If this value is too low, some "
|
|
|
|
"transactions may fail at commit time due to not being able to "
|
|
|
|
"determine whether there were any write conflicts. Setting this "
|
|
|
|
"value to 0 will cause write buffers to be freed immediately "
|
|
|
|
"after they are flushed. If this value is set to -1, "
|
|
|
|
"'max_write_buffer_number' will be used.");
|
|
|
|
|
Refactor trimming logic for immutable memtables (#5022)
Summary:
MyRocks currently sets `max_write_buffer_number_to_maintain` in order to maintain enough history for transaction conflict checking. The effectiveness of this approach depends on the size of memtables. When memtables are small, it may not keep enough history; when memtables are large, this may consume too much memory.
We are proposing a new way to configure memtable list history: by limiting the memory usage of immutable memtables. The new option is `max_write_buffer_size_to_maintain` and it will take precedence over the old `max_write_buffer_number_to_maintain` if they are both set to non-zero values. The new option accounts for the total memory usage of flushed immutable memtables and mutable memtable. When the total usage exceeds the limit, RocksDB may start dropping immutable memtables (which is also called trimming history), starting from the oldest one.
The semantics of the old option actually works both as an upper bound and lower bound. History trimming will start if number of immutable memtables exceeds the limit, but it will never go below (limit-1) due to history trimming.
In order the mimic the behavior with the new option, history trimming will stop if dropping the next immutable memtable causes the total memory usage go below the size limit. For example, assuming the size limit is set to 64MB, and there are 3 immutable memtables with sizes of 20, 30, 30. Although the total memory usage is 80MB > 64MB, dropping the oldest memtable will reduce the memory usage to 60MB < 64MB, so in this case no memtable will be dropped.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5022
Differential Revision: D14394062
Pulled By: miasantreble
fbshipit-source-id: 60457a509c6af89d0993f988c9b5c2aa9e45f5c5
2019-08-23 20:54:09 +00:00
|
|
|
DEFINE_int64(max_write_buffer_size_to_maintain,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_write_buffer_size_to_maintain,
|
Refactor trimming logic for immutable memtables (#5022)
Summary:
MyRocks currently sets `max_write_buffer_number_to_maintain` in order to maintain enough history for transaction conflict checking. The effectiveness of this approach depends on the size of memtables. When memtables are small, it may not keep enough history; when memtables are large, this may consume too much memory.
We are proposing a new way to configure memtable list history: by limiting the memory usage of immutable memtables. The new option is `max_write_buffer_size_to_maintain` and it will take precedence over the old `max_write_buffer_number_to_maintain` if they are both set to non-zero values. The new option accounts for the total memory usage of flushed immutable memtables and mutable memtable. When the total usage exceeds the limit, RocksDB may start dropping immutable memtables (which is also called trimming history), starting from the oldest one.
The semantics of the old option actually works both as an upper bound and lower bound. History trimming will start if number of immutable memtables exceeds the limit, but it will never go below (limit-1) due to history trimming.
In order the mimic the behavior with the new option, history trimming will stop if dropping the next immutable memtable causes the total memory usage go below the size limit. For example, assuming the size limit is set to 64MB, and there are 3 immutable memtables with sizes of 20, 30, 30. Although the total memory usage is 80MB > 64MB, dropping the oldest memtable will reduce the memory usage to 60MB < 64MB, so in this case no memtable will be dropped.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5022
Differential Revision: D14394062
Pulled By: miasantreble
fbshipit-source-id: 60457a509c6af89d0993f988c9b5c2aa9e45f5c5
2019-08-23 20:54:09 +00:00
|
|
|
"The total maximum size of write buffers to maintain in memory "
|
|
|
|
"including copies of buffers that have already been flushed. "
|
|
|
|
"Unlike max_write_buffer_number, this parameter does not affect "
|
|
|
|
"flushing. This controls the minimum amount of write history "
|
|
|
|
"that will be available in memory for conflict checking when "
|
|
|
|
"Transactions are used. If this value is too low, some "
|
|
|
|
"transactions may fail at commit time due to not being able to "
|
|
|
|
"determine whether there were any write conflicts. Setting this "
|
|
|
|
"value to 0 will cause write buffers to be freed immediately "
|
|
|
|
"after they are flushed. If this value is set to -1, "
|
|
|
|
"'max_write_buffer_number' will be used.");
|
|
|
|
|
2017-07-08 01:11:53 +00:00
|
|
|
DEFINE_int32(max_background_jobs,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_background_jobs,
|
2017-07-08 01:11:53 +00:00
|
|
|
"The maximum number of concurrent background jobs that can occur "
|
|
|
|
"in parallel.");
|
|
|
|
|
2017-08-03 22:36:28 +00:00
|
|
|
DEFINE_int32(num_bottom_pri_threads, 0,
|
|
|
|
"The number of threads in the bottom-priority thread pool (used "
|
|
|
|
"by universal compaction only).");
|
|
|
|
|
2017-08-04 04:30:37 +00:00
|
|
|
DEFINE_int32(num_high_pri_threads, 0,
|
|
|
|
"The maximum number of concurrent background compactions"
|
|
|
|
" that can occur in parallel.");
|
|
|
|
|
|
|
|
DEFINE_int32(num_low_pri_threads, 0,
|
|
|
|
"The maximum number of concurrent background compactions"
|
|
|
|
" that can occur in parallel.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(max_background_compactions,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_background_compactions,
|
2013-10-24 14:43:14 +00:00
|
|
|
"The maximum number of concurrent background compactions"
|
|
|
|
" that can occur in parallel.");
|
2012-10-19 21:00:53 +00:00
|
|
|
|
2015-08-21 21:25:34 +00:00
|
|
|
DEFINE_uint64(subcompactions, 1,
|
Fixing race condition in DBTest.DynamicMemtableOptions
Summary:
This patch fixes a race condition in DBTEst.DynamicMemtableOptions. In rare cases,
it was possible that the main thread would fill up both memtables before the flush
job acquired its work. Then, the flush job was flushing both memtables together,
producing only one L0 file while the test expected two. Now, the test waits for
flushes to finish earlier, to make sure that the memtables are flushed in separate
flush jobs.
Test Plan:
Insert "usleep(10000);" after "IOSTATS_SET_THREAD_POOL_ID(Env::Priority::HIGH);" in BGWorkFlush()
to make the issue more likely. Then test with:
make db_test && time while ./db_test --gtest_filter=*DynamicMemtableOptions; do true; done
Reviewers: rven, sdong, yhchiang, anthony, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45429
2015-08-25 00:04:18 +00:00
|
|
|
"Maximum number of subcompactions to divide L0-L1 compactions "
|
|
|
|
"into.");
|
|
|
|
static const bool FLAGS_subcompactions_dummy
|
2018-02-02 20:14:42 +00:00
|
|
|
__attribute__((__unused__)) = RegisterFlagValidator(&FLAGS_subcompactions,
|
Fixing race condition in DBTest.DynamicMemtableOptions
Summary:
This patch fixes a race condition in DBTEst.DynamicMemtableOptions. In rare cases,
it was possible that the main thread would fill up both memtables before the flush
job acquired its work. Then, the flush job was flushing both memtables together,
producing only one L0 file while the test expected two. Now, the test waits for
flushes to finish earlier, to make sure that the memtables are flushed in separate
flush jobs.
Test Plan:
Insert "usleep(10000);" after "IOSTATS_SET_THREAD_POOL_ID(Env::Priority::HIGH);" in BGWorkFlush()
to make the issue more likely. Then test with:
make db_test && time while ./db_test --gtest_filter=*DynamicMemtableOptions; do true; done
Reviewers: rven, sdong, yhchiang, anthony, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45429
2015-08-25 00:04:18 +00:00
|
|
|
&ValidateUint32Range);
|
2015-08-21 21:25:34 +00:00
|
|
|
|
2014-03-05 18:27:17 +00:00
|
|
|
DEFINE_int32(max_background_flushes,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_background_flushes,
|
2014-03-05 18:27:17 +00:00
|
|
|
"The maximum number of concurrent background flushes"
|
|
|
|
" that can occur in parallel.");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
static ROCKSDB_NAMESPACE::CompactionStyle FLAGS_compaction_style_e;
|
|
|
|
DEFINE_int32(compaction_style,
|
|
|
|
(int32_t)ROCKSDB_NAMESPACE::Options().compaction_style,
|
2017-03-24 23:58:51 +00:00
|
|
|
"style of compaction: level-based, universal and fifo");
|
2013-06-14 05:09:08 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
static ROCKSDB_NAMESPACE::CompactionPri FLAGS_compaction_pri_e;
|
|
|
|
DEFINE_int32(compaction_pri,
|
|
|
|
(int32_t)ROCKSDB_NAMESPACE::Options().compaction_pri,
|
2015-09-22 00:16:31 +00:00
|
|
|
"priority of files to compaction: by size or by data age");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(universal_size_ratio, 0,
|
|
|
|
"Percentage flexibility while comparing file size"
|
|
|
|
" (for universal compaction only).");
|
2013-06-14 05:09:08 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(universal_min_merge_width, 0, "The minimum number of files in a"
|
|
|
|
" single compaction run (for universal compaction only).");
|
2013-09-09 23:06:10 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(universal_max_merge_width, 0, "The max number of files to compact"
|
|
|
|
" in universal style compaction");
|
2013-09-09 23:06:10 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(universal_max_size_amplification_percent, 0,
|
|
|
|
"The max size amplification for universal style compaction");
|
2013-06-14 05:09:08 +00:00
|
|
|
|
2013-12-03 20:32:07 +00:00
|
|
|
DEFINE_int32(universal_compression_size_percent, -1,
|
|
|
|
"The percentage of the database to compress for universal "
|
|
|
|
"compaction. -1 means compress everything.");
|
|
|
|
|
2015-07-20 18:52:39 +00:00
|
|
|
DEFINE_bool(universal_allow_trivial_move, false,
|
2015-08-11 18:46:15 +00:00
|
|
|
"Allow trivial move in universal compaction.");
|
2015-07-20 18:52:39 +00:00
|
|
|
|
Incremental Space Amp Compactions in Universal Style (#8655)
Summary:
This commit introduces incremental compaction in univeral style for space amplification. This follows the first improvement mentioned in https://rocksdb.org/blog/2021/04/12/universal-improvements.html . The implemention simply picks up files about size of max_compaction_bytes to compact and execute if the penalty is not too big. More optimizations can be done in the future, e.g. prioritizing between this compaction and other types. But for now, the feature is supposed to be functional and can often reduce frequency of full compactions, although it can introduce penalty.
In order to add cut files more efficiently so that more files from upper levels can be included, SST file cutting threshold (for current file + overlapping parent level files) is set to 1.5X of target file size. A 2MB target file size will generate files like this: https://gist.github.com/siying/29d2676fba417404f3c95e6c013c7de8 Number of files indeed increases but it is not out of control.
Two set of write benchmarks are run:
1. For ingestion rate limited scenario, we can see full compaction is mostly eliminated: https://gist.github.com/siying/959bc1186066906831cf4c808d6e0a19 . The write amp increased from 7.7 to 9.4, as expected. After applying file cutting, the number is improved to 8.9. In another benchmark, the write amp is even better with the incremental approach: https://gist.github.com/siying/d1c16c286d7c59c4d7bba718ca198163
2. For ingestion rate unlimited scenario, incremental compaction turns out to be too expensive most of the time and is not executed, as expected.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8655
Test Plan: Add unit tests to the functionality.
Reviewed By: ajkr
Differential Revision: D31787034
fbshipit-source-id: ce813e63b15a61d5a56e97bf8902a1b28e011beb
2021-10-20 17:03:03 +00:00
|
|
|
DEFINE_bool(universal_incremental, false,
|
|
|
|
"Enable incremental compactions in universal compaction.");
|
|
|
|
|
2016-08-19 19:28:19 +00:00
|
|
|
DEFINE_int64(cache_size, 8 << 20, // 8MB
|
|
|
|
"Number of bytes to use as a cache of uncompressed data");
|
|
|
|
|
|
|
|
DEFINE_int32(cache_numshardbits, 6,
|
|
|
|
"Number of shards for the block cache"
|
|
|
|
" is 2 ** cache_numshardbits. Negative means use default settings."
|
|
|
|
" This is applied only if FLAGS_cache_size is non-negative.");
|
|
|
|
|
2017-01-04 02:24:15 +00:00
|
|
|
DEFINE_double(cache_high_pri_pool_ratio, 0.0,
|
|
|
|
"Ratio of block cache reserve for high pri blocks. "
|
|
|
|
"If > 0.0, we also enable "
|
|
|
|
"cache_index_and_filter_blocks_with_high_priority.");
|
|
|
|
|
2022-08-13 00:59:06 +00:00
|
|
|
DEFINE_double(cache_low_pri_pool_ratio, 0.0,
|
|
|
|
"Ratio of block cache reserve for low pri blocks.");
|
|
|
|
|
2022-06-03 18:16:49 +00:00
|
|
|
DEFINE_string(cache_type, "lru_cache", "Type of block cache.");
|
2016-05-24 06:35:23 +00:00
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
DEFINE_bool(use_compressed_secondary_cache, false,
|
|
|
|
"Use the CompressedSecondaryCache as the secondary cache.");
|
2022-02-24 00:06:27 +00:00
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
DEFINE_int64(compressed_secondary_cache_size, 8 << 20, // 8MB
|
|
|
|
"Number of bytes to use as a cache of data");
|
2022-02-24 00:06:27 +00:00
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
DEFINE_int32(compressed_secondary_cache_numshardbits, 6,
|
2022-02-24 00:06:27 +00:00
|
|
|
"Number of shards for the block cache"
|
2022-04-11 20:28:33 +00:00
|
|
|
" is 2 ** compressed_secondary_cache_numshardbits."
|
2022-02-24 00:06:27 +00:00
|
|
|
" Negative means use default settings."
|
|
|
|
" This is applied only if FLAGS_cache_size is non-negative.");
|
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
DEFINE_double(compressed_secondary_cache_high_pri_pool_ratio, 0.0,
|
2022-02-24 00:06:27 +00:00
|
|
|
"Ratio of block cache reserve for high pri blocks. "
|
|
|
|
"If > 0.0, we also enable "
|
|
|
|
"cache_index_and_filter_blocks_with_high_priority.");
|
|
|
|
|
2022-08-13 00:59:06 +00:00
|
|
|
DEFINE_double(compressed_secondary_cache_low_pri_pool_ratio, 0.0,
|
|
|
|
"Ratio of block cache reserve for low pri blocks.");
|
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
DEFINE_string(compressed_secondary_cache_compression_type, "lz4",
|
2022-02-24 00:06:27 +00:00
|
|
|
"The compression algorithm to use for large "
|
2022-04-11 20:28:33 +00:00
|
|
|
"values stored in CompressedSecondaryCache.");
|
2022-02-24 00:06:27 +00:00
|
|
|
static enum ROCKSDB_NAMESPACE::CompressionType
|
2022-04-11 20:28:33 +00:00
|
|
|
FLAGS_compressed_secondary_cache_compression_type_e =
|
2022-02-24 00:06:27 +00:00
|
|
|
ROCKSDB_NAMESPACE::kLZ4Compression;
|
|
|
|
|
|
|
|
DEFINE_uint32(
|
2022-04-11 20:28:33 +00:00
|
|
|
compressed_secondary_cache_compress_format_version, 2,
|
2022-02-24 00:06:27 +00:00
|
|
|
"compress_format_version can have two values: "
|
|
|
|
"compress_format_version == 1 -- decompressed size is not included"
|
|
|
|
" in the block header."
|
|
|
|
"compress_format_version == 2 -- decompressed size is included"
|
|
|
|
" in the block header in varint32 format.");
|
|
|
|
|
2016-05-24 06:35:23 +00:00
|
|
|
DEFINE_int64(simcache_size, -1,
|
|
|
|
"Number of bytes to use as a simcache of "
|
2016-08-19 19:28:19 +00:00
|
|
|
"uncompressed data. Nagative value disables simcache.");
|
2011-03-18 22:37:00 +00:00
|
|
|
|
2015-07-09 20:36:16 +00:00
|
|
|
DEFINE_bool(cache_index_and_filter_blocks, false,
|
|
|
|
"Cache index/filter blocks in block cache.");
|
|
|
|
|
Provide an allocator for new memory type to be used with RocksDB block cache (#6214)
Summary:
New memory technologies are being developed by various hardware vendors (Intel DCPMM is one such technology currently available). These new memory types require different libraries for allocation and management (such as PMDK and memkind). The high capacities available make it possible to provision large caches (up to several TBs in size), beyond what is achievable with DRAM.
The new allocator provided in this PR uses the memkind library to allocate memory on different media.
**Performance**
We tested the new allocator using db_bench.
- For each test, we vary the size of the block cache (relative to the size of the uncompressed data in the database).
- The database is filled sequentially. Throughput is then measured with a readrandom benchmark.
- We use a uniform distribution as a worst-case scenario.
The plot shows throughput (ops/s) relative to a configuration with no block cache and default allocator.
For all tests, p99 latency is below 500 us.
![image](https://user-images.githubusercontent.com/26400080/71108594-42479100-2178-11ea-8231-8a775bbc92db.png)
**Changes**
- Add MemkindKmemAllocator
- Add --use_cache_memkind_kmem_allocator db_bench option (to create an LRU block cache with the new allocator)
- Add detection of memkind library with KMEM DAX support
- Add test for MemkindKmemAllocator
**Minimum Requirements**
- kernel 5.3.12
- ndctl v67 - https://github.com/pmem/ndctl
- memkind v1.10.0 - https://github.com/memkind/memkind
**Memory Configuration**
The allocator uses the MEMKIND_DAX_KMEM memory kind. Follow the instructions on[ memkind’s GitHub page](https://github.com/memkind/memkind) to set up NVDIMM memory accordingly.
Note on memory allocation with NVDIMM memory exposed as system memory.
- The MemkindKmemAllocator will only allocate from NVDIMM memory (using memkind_malloc with MEMKIND_DAX_KMEM kind).
- The default allocator is not restricted to RAM by default. Based on NUMA node latency, the kernel should allocate from local RAM preferentially, but it’s a kernel decision. numactl --preferred/--membind can be used to allocate preferentially/exclusively from the local RAM node.
**Usage**
When creating an LRU cache, pass a MemkindKmemAllocator object as argument.
For example (replace capacity with the desired value in bytes):
```
#include "rocksdb/cache.h"
#include "memory/memkind_kmem_allocator.h"
NewLRUCache(
capacity /*size_t*/,
6 /*cache_numshardbits*/,
false /*strict_capacity_limit*/,
false /*cache_high_pri_pool_ratio*/,
std::make_shared<MemkindKmemAllocator>());
```
Refer to [RocksDB’s block cache documentation](https://github.com/facebook/rocksdb/wiki/Block-Cache) to assign the LRU cache as block cache for a database.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6214
Reviewed By: cheng-chang
Differential Revision: D19292435
fbshipit-source-id: 7202f47b769e7722b539c86c2ffd669f64d7b4e1
2020-04-10 03:45:17 +00:00
|
|
|
DEFINE_bool(use_cache_memkind_kmem_allocator, false,
|
|
|
|
"Use memkind kmem allocator for block cache.");
|
|
|
|
|
2017-06-15 23:06:22 +00:00
|
|
|
DEFINE_bool(partition_index_and_filters, false,
|
|
|
|
"Partition index and filter blocks.");
|
|
|
|
|
2018-02-12 22:54:50 +00:00
|
|
|
DEFINE_bool(partition_index, false, "Partition index blocks");
|
|
|
|
|
2020-03-02 19:52:36 +00:00
|
|
|
DEFINE_bool(index_with_first_key, false, "Include first key in the index");
|
|
|
|
|
Minimize memory internal fragmentation for Bloom filters (#6427)
Summary:
New experimental option BBTO::optimize_filters_for_memory builds
filters that maximize their use of "usable size" from malloc_usable_size,
which is also used to compute block cache charges.
Rather than always "rounding up," we track state in the
BloomFilterPolicy object to mix essentially "rounding down" and
"rounding up" so that the average FP rate of all generated filters is
the same as without the option. (YMMV as heavily accessed filters might
be unluckily lower accuracy.)
Thus, the option near-minimizes what the block cache considers as
"memory used" for a given target Bloom filter false positive rate and
Bloom filter implementation. There are no forward or backward
compatibility issues with this change, though it only works on the
format_version=5 Bloom filter.
With Jemalloc, we see about 10% reduction in memory footprint (and block
cache charge) for Bloom filters, but 1-2% increase in storage footprint,
due to encoding efficiency losses (FP rate is non-linear with bits/key).
Why not weighted random round up/down rather than state tracking? By
only requiring malloc_usable_size, we don't actually know what the next
larger and next smaller usable sizes for the allocator are. We pick a
requested size, accept and use whatever usable size it has, and use the
difference to inform our next choice. This allows us to narrow in on the
right balance without tracking/predicting usable sizes.
Why not weight history of generated filter false positive rates by
number of keys? This could lead to excess skew in small filters after
generating a large filter.
Results from filter_bench with jemalloc (irrelevant details omitted):
(normal keys/filter, but high variance)
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=30000 -vary_key_count_ratio=0.9
Build avg ns/key: 29.6278
Number of filters: 5516
Total size (MB): 200.046
Reported total allocated memory (MB): 220.597
Reported internal fragmentation: 10.2732%
Bits/key stored: 10.0097
Average FP rate %: 0.965228
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=30000 -vary_key_count_ratio=0.9 -optimize_filters_for_memory
Build avg ns/key: 30.5104
Number of filters: 5464
Total size (MB): 200.015
Reported total allocated memory (MB): 200.322
Reported internal fragmentation: 0.153709%
Bits/key stored: 10.1011
Average FP rate %: 0.966313
(very few keys / filter, optimization not as effective due to ~59 byte
internal fragmentation in blocked Bloom filter representation)
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000 -vary_key_count_ratio=0.9
Build avg ns/key: 29.5649
Number of filters: 162950
Total size (MB): 200.001
Reported total allocated memory (MB): 224.624
Reported internal fragmentation: 12.3117%
Bits/key stored: 10.2951
Average FP rate %: 0.821534
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000 -vary_key_count_ratio=0.9 -optimize_filters_for_memory
Build avg ns/key: 31.8057
Number of filters: 159849
Total size (MB): 200
Reported total allocated memory (MB): 208.846
Reported internal fragmentation: 4.42297%
Bits/key stored: 10.4948
Average FP rate %: 0.811006
(high keys/filter)
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000000 -vary_key_count_ratio=0.9
Build avg ns/key: 29.7017
Number of filters: 164
Total size (MB): 200.352
Reported total allocated memory (MB): 221.5
Reported internal fragmentation: 10.5552%
Bits/key stored: 10.0003
Average FP rate %: 0.969358
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000000 -vary_key_count_ratio=0.9 -optimize_filters_for_memory
Build avg ns/key: 30.7131
Number of filters: 160
Total size (MB): 200.928
Reported total allocated memory (MB): 200.938
Reported internal fragmentation: 0.00448054%
Bits/key stored: 10.1852
Average FP rate %: 0.963387
And from db_bench (block cache) with jemalloc:
$ ./db_bench -db=/dev/shm/dbbench.no_optimize -benchmarks=fillrandom -format_version=5 -value_size=90 -bloom_bits=10 -num=2000000 -threads=8 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false
$ ./db_bench -db=/dev/shm/dbbench -benchmarks=fillrandom -format_version=5 -value_size=90 -bloom_bits=10 -num=2000000 -threads=8 -optimize_filters_for_memory -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false
$ (for FILE in /dev/shm/dbbench.no_optimize/*.sst; do ./sst_dump --file=$FILE --show_properties | grep 'filter block' ; done) | awk '{ t += $4; } END { print t; }'
17063835
$ (for FILE in /dev/shm/dbbench/*.sst; do ./sst_dump --file=$FILE --show_properties | grep 'filter block' ; done) | awk '{ t += $4; } END { print t; }'
17430747
$ #^ 2.1% additional filter storage
$ ./db_bench -db=/dev/shm/dbbench.no_optimize -use_existing_db -benchmarks=readrandom,stats -statistics -bloom_bits=10 -num=2000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false -duration=10 -cache_index_and_filter_blocks -cache_size=1000000000
rocksdb.block.cache.index.add COUNT : 33
rocksdb.block.cache.index.bytes.insert COUNT : 8440400
rocksdb.block.cache.filter.add COUNT : 33
rocksdb.block.cache.filter.bytes.insert COUNT : 21087528
rocksdb.bloom.filter.useful COUNT : 4963889
rocksdb.bloom.filter.full.positive COUNT : 1214081
rocksdb.bloom.filter.full.true.positive COUNT : 1161999
$ #^ 1.04 % observed FP rate
$ ./db_bench -db=/dev/shm/dbbench -use_existing_db -benchmarks=readrandom,stats -statistics -bloom_bits=10 -num=2000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false -optimize_filters_for_memory -duration=10 -cache_index_and_filter_blocks -cache_size=1000000000
rocksdb.block.cache.index.add COUNT : 33
rocksdb.block.cache.index.bytes.insert COUNT : 8448592
rocksdb.block.cache.filter.add COUNT : 33
rocksdb.block.cache.filter.bytes.insert COUNT : 18220328
rocksdb.bloom.filter.useful COUNT : 5360933
rocksdb.bloom.filter.full.positive COUNT : 1321315
rocksdb.bloom.filter.full.true.positive COUNT : 1262999
$ #^ 1.08 % observed FP rate, 13.6% less memory usage for filters
(Due to specific key density, this example tends to generate filters that are "worse than average" for internal fragmentation. "Better than average" cases can show little or no improvement.)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6427
Test Plan: unit test added, 'make check' with gcc, clang and valgrind
Reviewed By: siying
Differential Revision: D22124374
Pulled By: pdillinger
fbshipit-source-id: f3e3aa152f9043ddf4fae25799e76341d0d8714e
2020-06-22 20:30:57 +00:00
|
|
|
DEFINE_bool(
|
|
|
|
optimize_filters_for_memory,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().optimize_filters_for_memory,
|
|
|
|
"Minimize memory footprint of filters");
|
|
|
|
|
2020-03-02 19:52:36 +00:00
|
|
|
DEFINE_int64(
|
|
|
|
index_shortening_mode, 2,
|
|
|
|
"mode to shorten index: 0 for no shortening; 1 for only shortening "
|
|
|
|
"separaters; 2 for shortening shortening and successor");
|
|
|
|
|
2017-06-15 23:06:22 +00:00
|
|
|
DEFINE_int64(metadata_block_size,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().metadata_block_size,
|
2017-06-15 23:06:22 +00:00
|
|
|
"Max partition size when partitioning index/filters");
|
|
|
|
|
|
|
|
// The default reduces the overhead of reading time with flash. With HDD, which
|
|
|
|
// offers much less throughput, however, this number better to be set to 1.
|
|
|
|
DEFINE_int32(ops_between_duration_checks, 1000,
|
|
|
|
"Check duration limit every x ops");
|
|
|
|
|
Adding pin_l0_filter_and_index_blocks_in_cache feature and related fixes.
Summary:
When a block based table file is opened, if prefetch_index_and_filter is true, it will prefetch the index and filter blocks, putting them into the block cache.
What this feature adds: when a L0 block based table file is opened, if pin_l0_filter_and_index_blocks_in_cache is true in the options (and prefetch_index_and_filter is true), then the filter and index blocks aren't released back to the block cache at the end of BlockBasedTableReader::Open(). Instead the table reader takes ownership of them, hence pinning them, ie. the LRU cache will never push them out. Meanwhile in the table reader, further accesses will not hit the block cache, thus avoiding lock contention.
Test Plan:
'export TEST_TMPDIR=/dev/shm/ && DISABLE_JEMALLOC=1 OPT=-g make all valgrind_check -j32' is OK.
I didn't run the Java tests, I don't have Java set up on my devserver.
Reviewers: sdong
Reviewed By: sdong
Subscribers: andrewkr, dhruba
Differential Revision: https://reviews.facebook.net/D56133
2016-04-01 17:42:39 +00:00
|
|
|
DEFINE_bool(pin_l0_filter_and_index_blocks_in_cache, false,
|
|
|
|
"Pin index/filter blocks of L0 files in block cache.");
|
|
|
|
|
2018-06-22 22:14:05 +00:00
|
|
|
DEFINE_bool(
|
|
|
|
pin_top_level_index_and_filter, false,
|
|
|
|
"Pin top-level index of partitioned index/filter blocks in block cache.");
|
|
|
|
|
2014-11-11 21:47:22 +00:00
|
|
|
DEFINE_int32(block_size,
|
2020-02-20 20:07:53 +00:00
|
|
|
static_cast<int32_t>(
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().block_size),
|
2013-10-24 14:43:14 +00:00
|
|
|
"Number of bytes in a block.");
|
2012-09-13 16:23:18 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(format_version,
|
|
|
|
static_cast<int32_t>(
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().format_version),
|
|
|
|
"Format version of SST files.");
|
2018-06-05 02:59:44 +00:00
|
|
|
|
2014-08-25 21:22:05 +00:00
|
|
|
DEFINE_int32(block_restart_interval,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().block_restart_interval,
|
2014-07-21 19:01:40 +00:00
|
|
|
"Number of keys between restart points "
|
2016-05-09 19:09:05 +00:00
|
|
|
"for delta encoding of keys in data block.");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(
|
|
|
|
index_block_restart_interval,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().index_block_restart_interval,
|
|
|
|
"Number of keys between restart points "
|
|
|
|
"for delta encoding of keys in index block.");
|
2014-07-21 19:01:40 +00:00
|
|
|
|
2016-08-27 01:55:58 +00:00
|
|
|
DEFINE_int32(read_amp_bytes_per_bit,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().read_amp_bytes_per_bit,
|
2016-08-27 01:55:58 +00:00
|
|
|
"Number of bytes per bit to be used in block read-amp bitmap");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(
|
|
|
|
enable_index_compression,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().enable_index_compression,
|
|
|
|
"Compress the index block");
|
2018-01-10 23:06:29 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(block_align,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().block_align,
|
2018-03-27 03:14:24 +00:00
|
|
|
"Align data blocks on page size");
|
|
|
|
|
2021-06-18 04:55:42 +00:00
|
|
|
DEFINE_int64(prepopulate_block_cache, 0,
|
|
|
|
"Pre-populate hot/warm blocks in block cache. 0 to disable and 1 "
|
|
|
|
"to insert during flush");
|
|
|
|
|
2018-08-17 01:29:13 +00:00
|
|
|
DEFINE_bool(use_data_block_hash_index, false,
|
|
|
|
"if use kDataBlockBinaryAndHash "
|
|
|
|
"instead of kDataBlockBinarySearch. "
|
|
|
|
"This is valid if only we use BlockTable");
|
|
|
|
|
|
|
|
DEFINE_double(data_block_hash_table_util_ratio, 0.75,
|
|
|
|
"util ratio for data block hash index table. "
|
|
|
|
"This is only valid if use_data_block_hash_index is "
|
|
|
|
"set to true");
|
|
|
|
|
2013-09-02 06:23:40 +00:00
|
|
|
DEFINE_int64(compressed_cache_size, -1,
|
|
|
|
"Number of bytes to use as a cache of compressed data.");
|
|
|
|
|
2015-06-23 17:25:45 +00:00
|
|
|
DEFINE_int64(row_cache_size, 0,
|
|
|
|
"Number of bytes to use as a cache of individual rows"
|
|
|
|
" (0 = disabled).");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(open_files, ROCKSDB_NAMESPACE::Options().max_open_files,
|
2013-10-24 14:43:14 +00:00
|
|
|
"Maximum number of files to keep open at the same time"
|
|
|
|
" (use default if == 0)");
|
2011-05-21 02:17:43 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(file_opening_threads,
|
|
|
|
ROCKSDB_NAMESPACE::Options().max_file_opening_threads,
|
2015-09-30 16:51:31 +00:00
|
|
|
"If open_files is set to -1, this option set the number of "
|
|
|
|
"threads that will be used to open files during DB::Open()");
|
|
|
|
|
2015-08-26 22:25:59 +00:00
|
|
|
DEFINE_int32(compaction_readahead_size, 0, "Compaction readahead size");
|
|
|
|
|
2020-02-07 23:16:29 +00:00
|
|
|
DEFINE_int32(log_readahead_size, 0, "WAL and manifest readahead size");
|
|
|
|
|
2015-10-29 18:34:34 +00:00
|
|
|
DEFINE_int32(random_access_max_buffer_size, 1024 * 1024,
|
|
|
|
"Maximum windows randomaccess buffer size");
|
2015-10-27 21:44:16 +00:00
|
|
|
|
2015-11-16 20:56:21 +00:00
|
|
|
DEFINE_int32(writable_file_max_buffer_size, 1024 * 1024,
|
|
|
|
"Maximum write buffer for Writable File");
|
2015-10-30 05:10:25 +00:00
|
|
|
|
2021-06-17 19:28:00 +00:00
|
|
|
DEFINE_int32(bloom_bits, -1,
|
|
|
|
"Bloom filter bits per key. Negative means use default."
|
|
|
|
"Zero disables.");
|
Support optimize_filters_for_memory for Ribbon filter (#7774)
Summary:
Primarily this change refactors the optimize_filters_for_memory
code for Bloom filters, based on malloc_usable_size, to also work for
Ribbon filters.
This change also replaces the somewhat slow but general
BuiltinFilterBitsBuilder::ApproximateNumEntries with
implementation-specific versions for Ribbon (new) and Legacy Bloom
(based on a recently deleted version). The reason is to emphasize
speed in ApproximateNumEntries rather than 100% accuracy.
Justification: ApproximateNumEntries (formerly CalculateNumEntry) is
only used by RocksDB for range-partitioned filters, called each time we
start to construct one. (In theory, it should be possible to reuse the
estimate, but the abstractions provided by FilterPolicy don't really
make that workable.) But this is only used as a heuristic estimate for
hitting a desired partitioned filter size because of alignment to data
blocks, which have various numbers of unique keys or prefixes. The two
factors lead us to prioritize reasonable speed over 100% accuracy.
optimize_filters_for_memory adds extra complication, because precisely
calculating num_entries for some allowed number of bytes depends on state
with optimize_filters_for_memory enabled. And the allocator-agnostic
implementation of optimize_filters_for_memory, using malloc_usable_size,
means we would have to actually allocate memory, many times, just to
precisely determine how many entries (keys) could be added and stay below
some size budget, for the current state. (In a draft, I got this
working, and then realized the balance of speed vs. accuracy was all
wrong.)
So related to that, I have made CalculateSpace, an internal-only API
only used for testing, non-authoritative also if
optimize_filters_for_memory is enabled. This simplifies some code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/7774
Test Plan:
unit test updated, and for FilterSize test, range of tested
values is greatly expanded (still super fast)
Also tested `db_bench -benchmarks=fillrandom,stats -bloom_bits=10 -num=1000000 -partition_index_and_filters -format_version=5 [-optimize_filters_for_memory] [-use_ribbon_filter]` with temporary debug output of generated filter sizes.
Bloom+optimize_filters_for_memory:
1 Filter size: 197 (224 in memory)
134 Filter size: 3525 (3584 in memory)
107 Filter size: 4037 (4096 in memory)
Total on disk: 904,506
Total in memory: 918,752
Ribbon+optimize_filters_for_memory:
1 Filter size: 3061 (3072 in memory)
110 Filter size: 3573 (3584 in memory)
58 Filter size: 4085 (4096 in memory)
Total on disk: 633,021 (-30.0%)
Total in memory: 634,880 (-30.9%)
Bloom (no offm):
1 Filter size: 261 (320 in memory)
1 Filter size: 3333 (3584 in memory)
240 Filter size: 3717 (4096 in memory)
Total on disk: 895,674 (-1% on disk vs. +offm; known tolerable overhead of offm)
Total in memory: 986,944 (+7.4% vs. +offm)
Ribbon (no offm):
1 Filter size: 2949 (3072 in memory)
1 Filter size: 3381 (3584 in memory)
167 Filter size: 3701 (4096 in memory)
Total on disk: 624,397 (-30.3% vs. Bloom)
Total in memory: 690,688 (-30.0% vs. Bloom)
Note that optimize_filters_for_memory is even more effective for Ribbon filter than for cache-local Bloom, because it can close the unused memory gap even tighter than Bloom filter, because of 16 byte increments for Ribbon vs. 64 byte increments for Bloom.
Reviewed By: jay-zhuang
Differential Revision: D25592970
Pulled By: pdillinger
fbshipit-source-id: 606fdaa025bb790d7e9c21601e8ea86e10541912
2020-12-18 22:29:48 +00:00
|
|
|
|
|
|
|
DEFINE_bool(use_ribbon_filter, false, "Use Ribbon instead of Bloom filter");
|
|
|
|
|
2016-06-04 00:02:10 +00:00
|
|
|
DEFINE_double(memtable_bloom_size_ratio, 0,
|
|
|
|
"Ratio of memtable size used for bloom filter. 0 means no bloom "
|
|
|
|
"filter.");
|
2019-02-19 20:12:25 +00:00
|
|
|
DEFINE_bool(memtable_whole_key_filtering, false,
|
|
|
|
"Try to use whole key bloom filter in memtables.");
|
2016-07-27 01:05:30 +00:00
|
|
|
DEFINE_bool(memtable_use_huge_page, false,
|
|
|
|
"Try to use huge page in memtables.");
|
2012-04-17 15:36:46 +00:00
|
|
|
|
2022-02-01 03:45:17 +00:00
|
|
|
DEFINE_bool(whole_key_filtering,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().whole_key_filtering,
|
|
|
|
"Use whole keys (in addition to prefixes) in SST bloom filter.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(use_existing_db, false, "If true, do not destroy the existing"
|
|
|
|
" database. If you set this flag and also specify a benchmark that"
|
|
|
|
" wants a fresh database, that benchmark will fail.");
|
2011-05-21 02:17:43 +00:00
|
|
|
|
2019-03-01 19:14:28 +00:00
|
|
|
DEFINE_bool(use_existing_keys, false,
|
|
|
|
"If true, uses existing keys in the DB, "
|
|
|
|
"rather than generating new ones. This involves some startup "
|
|
|
|
"latency to load all keys into memory. It is supported for the "
|
|
|
|
"same read/overwrite benchmarks as `-use_existing_db=true`, which "
|
|
|
|
"must also be set for this flag to be enabled. When this flag is "
|
|
|
|
"set, the value for `-num` will be ignored.");
|
|
|
|
|
Add argument --show_table_properties to db_bench
Summary:
Add argument --show_table_properties to db_bench
-show_table_properties (If true, then per-level table properties will be
printed on every stats-interval when stats_interval is set and
stats_per_interval is on.) type: bool default: false
Test Plan:
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1 --num_column_families=2
Sample Output:
Compaction Stats [column_family_name_000001]
Level Files Size(MB) Score Read(GB) Rn(GB) Rnp1(GB) Write(GB) Wnew(GB) Moved(GB) W-Amp Rd(MB/s) Wr(MB/s) Comp(sec) Comp(cnt) Avg(sec) Stall(cnt) KeyIn KeyDrop
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
L0 3/0 5 0.8 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 86.3 0 17 0.021 0 0 0
L1 5/0 9 0.9 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
L2 9/0 16 0.2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
Sum 17/0 31 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 86.3 0 17 0.021 0 0 0
Int 0/0 0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 83.9 0 2 0.022 0 0 0
Flush(GB): cumulative 0.030, interval 0.004
Stalls(count): 0 level0_slowdown, 0 level0_numfiles, 0 memtable_compaction, 0 leveln_slowdown_soft, 0 leveln_slowdown_hard
Level[0]: # data blocks=2571; # entries=84813; raw key size=2035512; raw average key size=24.000000; raw value size=8481300; raw average value size=100.000000; data block size=5690119; index block size=82415; filter block size=0; (estimated) table size=5772534; filter policy name=N/A;
Level[1]: # data blocks=4285; # entries=141355; raw key size=3392520; raw average key size=24.000000; raw value size=14135500; raw average value size=100.000000; data block size=9487353; index block size=137377; filter block size=0; (estimated) table size=9624730; filter policy name=N/A;
Level[2]: # data blocks=7713; # entries=254439; raw key size=6106536; raw average key size=24.000000; raw value size=25443900; raw average value size=100.000000; data block size=17077893; index block size=247269; filter block size=0; (estimated) table size=17325162; filter policy name=N/A;
Level[3]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[4]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[5]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[6]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Reviewers: anthony, IslamAbdelRahman, MarkCallaghan, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45651
2015-08-27 01:27:23 +00:00
|
|
|
DEFINE_bool(show_table_properties, false,
|
|
|
|
"If true, then per-level table"
|
|
|
|
" properties will be printed on every stats-interval when"
|
|
|
|
" stats_interval is set and stats_per_interval is on.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_string(db, "", "Use the db with the following name.");
|
2011-06-22 02:36:45 +00:00
|
|
|
|
2022-07-22 16:19:25 +00:00
|
|
|
DEFINE_bool(progress_reports, true,
|
|
|
|
"If true, db_bench will report number of finished operations.");
|
|
|
|
|
2017-02-27 20:59:34 +00:00
|
|
|
// Read cache flags
|
|
|
|
|
|
|
|
DEFINE_string(read_cache_path, "",
|
|
|
|
"If not empty string, a read cache will be used in this path");
|
|
|
|
|
|
|
|
DEFINE_int64(read_cache_size, 4LL * 1024 * 1024 * 1024,
|
|
|
|
"Maximum size of the read cache");
|
|
|
|
|
|
|
|
DEFINE_bool(read_cache_direct_write, true,
|
|
|
|
"Whether to use Direct IO for writing to the read cache");
|
|
|
|
|
|
|
|
DEFINE_bool(read_cache_direct_read, true,
|
|
|
|
"Whether to use Direct IO for reading from read cache");
|
|
|
|
|
2018-07-14 00:18:39 +00:00
|
|
|
DEFINE_bool(use_keep_filter, false, "Whether to use a noop compaction filter");
|
2018-07-13 02:33:59 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
static bool ValidateCacheNumshardbits(const char* flagname, int32_t value) {
|
|
|
|
if (value >= 20) {
|
|
|
|
fprintf(stderr, "Invalid value for --%s: %d, must be < 20\n",
|
|
|
|
flagname, value);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
2012-05-17 00:22:33 +00:00
|
|
|
|
2017-07-13 23:25:53 +00:00
|
|
|
DEFINE_bool(verify_checksum, true,
|
|
|
|
"Verify checksum for every block read"
|
2013-10-24 14:43:14 +00:00
|
|
|
" from storage");
|
2012-05-19 07:05:48 +00:00
|
|
|
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
DEFINE_int32(checksum_type,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().checksum,
|
|
|
|
"ChecksumType as an int");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(statistics, false, "Database statistics");
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(stats_level, ROCKSDB_NAMESPACE::StatsLevel::kExceptDetailedTimers,
|
2019-02-28 18:14:19 +00:00
|
|
|
"stats level for statistics");
|
2017-01-26 23:18:07 +00:00
|
|
|
DEFINE_string(statistics_string, "", "Serialized statistics string");
|
2020-02-20 20:07:53 +00:00
|
|
|
static class std::shared_ptr<ROCKSDB_NAMESPACE::Statistics> dbstats;
|
2012-05-30 06:18:16 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int64(writes, -1, "Number of write operations to do. If negative, do"
|
|
|
|
" --num reads.");
|
2012-08-15 22:44:23 +00:00
|
|
|
|
2017-04-07 18:25:42 +00:00
|
|
|
DEFINE_bool(finish_after_writes, false, "Write thread terminates after all writes are finished");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(sync, false, "Sync all writes to disk");
|
2012-08-19 23:05:02 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(use_fsync, false, "If true, issue fsync instead of fdatasync");
|
2013-03-01 19:25:13 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(disable_wal, false, "If true, do not write WAL for write.");
|
2012-10-15 17:10:56 +00:00
|
|
|
|
2021-11-04 23:02:17 +00:00
|
|
|
DEFINE_bool(manual_wal_flush, false,
|
|
|
|
"If true, buffer WAL until buffer is full or a manual FlushWAL().");
|
|
|
|
|
2022-02-18 00:18:01 +00:00
|
|
|
DEFINE_string(wal_compression, "none",
|
2022-01-26 21:57:30 +00:00
|
|
|
"Algorithm to use for WAL compression. none to disable.");
|
|
|
|
static enum ROCKSDB_NAMESPACE::CompressionType FLAGS_wal_compression_e =
|
|
|
|
ROCKSDB_NAMESPACE::kNoCompression;
|
|
|
|
|
2014-02-25 18:43:46 +00:00
|
|
|
DEFINE_string(wal_dir, "", "If not empty, use the given dir for WAL");
|
|
|
|
|
2017-04-07 18:25:42 +00:00
|
|
|
DEFINE_string(truth_db, "/dev/shm/truth_db/dbbench",
|
|
|
|
"Truth key/values used when using verify");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(num_levels, 7, "The total number of levels");
|
2012-08-15 22:44:23 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int64(target_file_size_base,
|
|
|
|
ROCKSDB_NAMESPACE::Options().target_file_size_base,
|
2017-03-02 18:45:04 +00:00
|
|
|
"Target file size at level-1");
|
2012-08-15 22:44:23 +00:00
|
|
|
|
2017-03-02 18:45:04 +00:00
|
|
|
DEFINE_int32(target_file_size_multiplier,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().target_file_size_multiplier,
|
2013-10-24 14:43:14 +00:00
|
|
|
"A multiplier to compute target level-N file size (N >= 2)");
|
2013-05-21 18:37:06 +00:00
|
|
|
|
2017-03-02 18:45:04 +00:00
|
|
|
DEFINE_uint64(max_bytes_for_level_base,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().max_bytes_for_level_base,
|
2017-03-02 18:45:04 +00:00
|
|
|
"Max bytes for level-1");
|
2012-08-19 23:05:02 +00:00
|
|
|
|
options.level_compaction_dynamic_level_bytes to allow RocksDB to pick size bases of levels dynamically.
Summary:
When having fixed max_bytes_for_level_base, the ratio of size of largest level and the second one can range from 0 to the multiplier. This makes LSM tree frequently irregular and unpredictable. It can also cause poor space amplification in some cases.
In this improvement (proposed by Igor Kabiljo), we introduce a parameter option.level_compaction_use_dynamic_max_bytes. When turning it on, RocksDB is free to pick a level base in the range of (options.max_bytes_for_level_base/options.max_bytes_for_level_multiplier, options.max_bytes_for_level_base] so that real level ratios are close to options.max_bytes_for_level_multiplier.
Test Plan: New unit tests and pass tests suites including valgrind.
Reviewers: MarkCallaghan, rven, yhchiang, igor, ikabiljo
Reviewed By: ikabiljo
Subscribers: yoshinorim, ikabiljo, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D31437
2015-02-05 19:44:17 +00:00
|
|
|
DEFINE_bool(level_compaction_dynamic_level_bytes, false,
|
|
|
|
"Whether level size base is dynamic");
|
|
|
|
|
2016-11-02 04:05:32 +00:00
|
|
|
DEFINE_double(max_bytes_for_level_multiplier, 10,
|
|
|
|
"A multiplier to compute max bytes for level-N (N >= 2)");
|
2012-08-19 23:05:02 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
static std::vector<int> FLAGS_max_bytes_for_level_multiplier_additional_v;
|
|
|
|
DEFINE_string(max_bytes_for_level_multiplier_additional, "",
|
|
|
|
"A vector that specifies additional fanout per level");
|
2012-10-19 21:00:53 +00:00
|
|
|
|
Don't artificially inflate L0 score
Summary:
This turns out to be pretty bad because if we prioritize L0->L1 then L1 can grow artificially large, which makes L0->L1 more and more expensive. For example:
256MB @ L0 + 256MB @ L1 --> 512MB @ L1
256MB @ L0 + 512MB @ L1 --> 768MB @ L1
256MB @ L0 + 768MB @ L1 --> 1GB @ L1
....
256MB @ L0 + 10GB @ L1 --> 10.2GB @ L1
At some point we need to start compacting L1->L2 to speed up L0->L1.
Test Plan:
The performance improvement is massive for heavy write workload. This is the benchmark I ran: https://phabricator.fb.com/P19842671. Before this change, the benchmark took 47 minutes to complete. After, the benchmark finished in 2minutes. You can see full results here: https://phabricator.fb.com/P19842674
Also, we ran this diff on MongoDB on RocksDB on one replicaset. Before the change, our initial sync was so slow that it couldn't keep up with primary writes. After the change, the import finished without any issues
Reviewers: dynamike, MarkCallaghan, rven, yhchiang, sdong
Reviewed By: sdong
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D38637
2015-05-21 18:40:48 +00:00
|
|
|
DEFINE_int32(level0_stop_writes_trigger,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().level0_stop_writes_trigger,
|
2022-04-01 23:06:14 +00:00
|
|
|
"Number of files in level-0 that will trigger put stop.");
|
2012-08-31 06:06:17 +00:00
|
|
|
|
Don't artificially inflate L0 score
Summary:
This turns out to be pretty bad because if we prioritize L0->L1 then L1 can grow artificially large, which makes L0->L1 more and more expensive. For example:
256MB @ L0 + 256MB @ L1 --> 512MB @ L1
256MB @ L0 + 512MB @ L1 --> 768MB @ L1
256MB @ L0 + 768MB @ L1 --> 1GB @ L1
....
256MB @ L0 + 10GB @ L1 --> 10.2GB @ L1
At some point we need to start compacting L1->L2 to speed up L0->L1.
Test Plan:
The performance improvement is massive for heavy write workload. This is the benchmark I ran: https://phabricator.fb.com/P19842671. Before this change, the benchmark took 47 minutes to complete. After, the benchmark finished in 2minutes. You can see full results here: https://phabricator.fb.com/P19842674
Also, we ran this diff on MongoDB on RocksDB on one replicaset. Before the change, our initial sync was so slow that it couldn't keep up with primary writes. After the change, the import finished without any issues
Reviewers: dynamike, MarkCallaghan, rven, yhchiang, sdong
Reviewed By: sdong
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D38637
2015-05-21 18:40:48 +00:00
|
|
|
DEFINE_int32(level0_slowdown_writes_trigger,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().level0_slowdown_writes_trigger,
|
2022-04-01 23:06:14 +00:00
|
|
|
"Number of files in level-0 that will slow down writes.");
|
2013-02-20 01:51:06 +00:00
|
|
|
|
Don't artificially inflate L0 score
Summary:
This turns out to be pretty bad because if we prioritize L0->L1 then L1 can grow artificially large, which makes L0->L1 more and more expensive. For example:
256MB @ L0 + 256MB @ L1 --> 512MB @ L1
256MB @ L0 + 512MB @ L1 --> 768MB @ L1
256MB @ L0 + 768MB @ L1 --> 1GB @ L1
....
256MB @ L0 + 10GB @ L1 --> 10.2GB @ L1
At some point we need to start compacting L1->L2 to speed up L0->L1.
Test Plan:
The performance improvement is massive for heavy write workload. This is the benchmark I ran: https://phabricator.fb.com/P19842671. Before this change, the benchmark took 47 minutes to complete. After, the benchmark finished in 2minutes. You can see full results here: https://phabricator.fb.com/P19842674
Also, we ran this diff on MongoDB on RocksDB on one replicaset. Before the change, our initial sync was so slow that it couldn't keep up with primary writes. After the change, the import finished without any issues
Reviewers: dynamike, MarkCallaghan, rven, yhchiang, sdong
Reviewed By: sdong
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D38637
2015-05-21 18:40:48 +00:00
|
|
|
DEFINE_int32(level0_file_num_compaction_trigger,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().level0_file_num_compaction_trigger,
|
2022-04-01 23:06:14 +00:00
|
|
|
"Number of files in level-0 when compactions start.");
|
2012-09-17 20:35:57 +00:00
|
|
|
|
2020-07-29 20:38:07 +00:00
|
|
|
DEFINE_uint64(periodic_compaction_seconds,
|
|
|
|
ROCKSDB_NAMESPACE::Options().periodic_compaction_seconds,
|
|
|
|
"Files older than this will be picked up for compaction and"
|
|
|
|
" rewritten to the same level");
|
|
|
|
|
Try to start TTL earlier with kMinOverlappingRatio is used (#8749)
Summary:
Right now, when options.ttl is set, compactions are triggered around the time when TTL is reached. This might cause extra compactions which are often bursty. This commit tries to mitigate it by picking those files earlier in normal compaction picking process. This is only implemented using kMinOverlappingRatio with Leveled compaction as it is the default value and it is more complicated to change other styles.
When a file is aged more than ttl/2, RocksDB starts to boost the compaction priority of files in normal compaction picking process, and hope by the time TTL is reached, very few extra compaction is needed.
In order for this to work, another change is made: during a compaction, if an output level file is older than ttl/2, cut output files based on original boundary (if it is not in the last level). This is to make sure that after an old file is moved to the next level, and new data is merged from the upper level, the new data falling into this range isn't reset with old timestamp. Without this change, in many cases, most files from one level will keep having old timestamp, even if they have newer data and we stuck in it.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8749
Test Plan: Add a unit test to test the boosting logic. Will add a unit test to test it end-to-end.
Reviewed By: jay-zhuang
Differential Revision: D30735261
fbshipit-source-id: 503c2d89250b22911eb99e72b379be154de3428e
2021-11-01 21:32:12 +00:00
|
|
|
DEFINE_uint64(ttl_seconds, ROCKSDB_NAMESPACE::Options().ttl, "Set options.ttl");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
static bool ValidateInt32Percent(const char* flagname, int32_t value) {
|
|
|
|
if (value <= 0 || value>=100) {
|
|
|
|
fprintf(stderr, "Invalid value for --%s: %d, 0< pct <100 \n",
|
|
|
|
flagname, value);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
DEFINE_int32(readwritepercent, 90, "Ratio of reads to reads/writes (expressed"
|
|
|
|
" as percentage) for the ReadRandomWriteRandom workload. The "
|
|
|
|
"default value 90 means 90% operations out of all reads and writes"
|
|
|
|
" operations are reads. In other words, 9 gets for every 1 put.");
|
|
|
|
|
2014-01-11 01:33:56 +00:00
|
|
|
DEFINE_int32(mergereadpercent, 70, "Ratio of merges to merges&reads (expressed"
|
|
|
|
" as percentage) for the ReadRandomMergeRandom workload. The"
|
|
|
|
" default value 70 means 70% out of all read and merge operations"
|
|
|
|
" are merges. In other words, 7 merges for every 3 gets.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(deletepercent, 2, "Percentage of deletes out of reads/writes/"
|
|
|
|
"deletes (used in RandomWithVerify only). RandomWithVerify "
|
|
|
|
"calculates writepercent as (100 - FLAGS_readwritepercent - "
|
|
|
|
"deletepercent), so deletepercent must be smaller than (100 - "
|
|
|
|
"FLAGS_readwritepercent)");
|
|
|
|
|
2022-01-19 01:25:33 +00:00
|
|
|
DEFINE_bool(optimize_filters_for_hits,
|
|
|
|
ROCKSDB_NAMESPACE::Options().optimize_filters_for_hits,
|
2016-05-05 14:32:10 +00:00
|
|
|
"Optimizes bloom filters for workloads for most lookups return "
|
|
|
|
"a value. For now this doesn't create bloom filters for the max "
|
|
|
|
"level of the LSM to reduce metadata that should fit in RAM. ");
|
|
|
|
|
2022-01-19 01:25:33 +00:00
|
|
|
DEFINE_bool(paranoid_checks, ROCKSDB_NAMESPACE::Options().paranoid_checks,
|
|
|
|
"RocksDB will aggressively check consistency of the data.");
|
|
|
|
|
|
|
|
DEFINE_bool(force_consistency_checks,
|
|
|
|
ROCKSDB_NAMESPACE::Options().force_consistency_checks,
|
|
|
|
"Runs consistency checks on the LSM every time a change is "
|
|
|
|
"applied.");
|
|
|
|
|
|
|
|
DEFINE_bool(check_flush_compaction_key_order,
|
|
|
|
ROCKSDB_NAMESPACE::Options().check_flush_compaction_key_order,
|
|
|
|
"During flush or compaction, check whether keys inserted to "
|
|
|
|
"output files are in order.");
|
|
|
|
|
2014-12-22 11:04:45 +00:00
|
|
|
DEFINE_uint64(delete_obsolete_files_period_micros, 0,
|
|
|
|
"Ignored. Left here for backward compatibility");
|
2013-10-24 14:43:14 +00:00
|
|
|
|
2018-10-19 00:16:36 +00:00
|
|
|
DEFINE_int64(writes_before_delete_range, 0,
|
|
|
|
"Number of writes before DeleteRange is called regularly.");
|
|
|
|
|
2016-11-16 01:33:27 +00:00
|
|
|
DEFINE_int64(writes_per_range_tombstone, 0,
|
2018-10-19 00:16:36 +00:00
|
|
|
"Number of writes between range tombstones");
|
2016-11-16 01:33:27 +00:00
|
|
|
|
|
|
|
DEFINE_int64(range_tombstone_width, 100, "Number of keys in tombstone's range");
|
|
|
|
|
|
|
|
DEFINE_int64(max_num_range_tombstones, 0,
|
2022-04-01 23:06:14 +00:00
|
|
|
"Maximum number of range tombstones to insert.");
|
2016-11-16 01:33:27 +00:00
|
|
|
|
2016-12-07 02:02:43 +00:00
|
|
|
DEFINE_bool(expand_range_tombstones, false,
|
|
|
|
"Expand range tombstone into sequential regular tombstones.");
|
|
|
|
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2017-11-21 07:19:46 +00:00
|
|
|
// Transactions Options
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
DEFINE_bool(optimistic_transaction_db, false,
|
2015-05-29 21:36:35 +00:00
|
|
|
"Open a OptimisticTransactionDB instance. "
|
|
|
|
"Required for randomtransaction benchmark.");
|
|
|
|
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
DEFINE_bool(transaction_db, false,
|
|
|
|
"Open a TransactionDB instance. "
|
|
|
|
"Required for randomtransaction benchmark.");
|
|
|
|
|
2015-05-29 21:36:35 +00:00
|
|
|
DEFINE_uint64(transaction_sets, 2,
|
|
|
|
"Number of keys each transaction will "
|
|
|
|
"modify (use in RandomTransaction only). Max: 9999");
|
|
|
|
|
2015-08-28 23:09:34 +00:00
|
|
|
DEFINE_bool(transaction_set_snapshot, false,
|
|
|
|
"Setting to true will have each transaction call SetSnapshot()"
|
|
|
|
" upon creation.");
|
|
|
|
|
2015-05-29 21:36:35 +00:00
|
|
|
DEFINE_int32(transaction_sleep, 0,
|
|
|
|
"Max microseconds to sleep in between "
|
|
|
|
"reading and writing a value (used in RandomTransaction only). ");
|
|
|
|
|
2015-08-28 23:09:34 +00:00
|
|
|
DEFINE_uint64(transaction_lock_timeout, 100,
|
|
|
|
"If using a transaction_db, specifies the lock wait timeout in"
|
|
|
|
" milliseconds before failing a transaction waiting on a lock");
|
2016-06-02 23:24:14 +00:00
|
|
|
DEFINE_string(
|
|
|
|
options_file, "",
|
|
|
|
"The path to a RocksDB options file. If specified, then db_bench will "
|
|
|
|
"run with the RocksDB options in the default column family of the "
|
|
|
|
"specified options file. "
|
|
|
|
"Note that with this setting, db_bench will ONLY accept the following "
|
|
|
|
"RocksDB options related command-line arguments, all other arguments "
|
|
|
|
"that are related to RocksDB options will be ignored:\n"
|
|
|
|
"\t--use_existing_db\n"
|
2019-03-01 19:14:28 +00:00
|
|
|
"\t--use_existing_keys\n"
|
2016-06-02 23:24:14 +00:00
|
|
|
"\t--statistics\n"
|
|
|
|
"\t--row_cache_size\n"
|
|
|
|
"\t--row_cache_numshardbits\n"
|
|
|
|
"\t--enable_io_prio\n"
|
|
|
|
"\t--dump_malloc_stats\n"
|
|
|
|
"\t--num_multi_db\n");
|
2017-03-24 23:58:51 +00:00
|
|
|
|
2017-11-21 07:19:46 +00:00
|
|
|
// FIFO Compaction Options
|
2017-03-24 23:58:51 +00:00
|
|
|
DEFINE_uint64(fifo_compaction_max_table_files_size_mb, 0,
|
|
|
|
"The limit of total table file sizes to trigger FIFO compaction");
|
2017-11-21 07:19:46 +00:00
|
|
|
|
2017-05-05 01:14:29 +00:00
|
|
|
DEFINE_bool(fifo_compaction_allow_compaction, true,
|
|
|
|
"Allow compaction in FIFO compaction.");
|
2017-11-21 07:19:46 +00:00
|
|
|
|
2017-06-28 00:02:20 +00:00
|
|
|
DEFINE_uint64(fifo_compaction_ttl, 0, "TTL for the SST Files in seconds.");
|
2017-11-21 07:19:46 +00:00
|
|
|
|
2021-08-09 19:50:19 +00:00
|
|
|
DEFINE_uint64(fifo_age_for_warm, 0, "age_for_warm for FIFO compaction.");
|
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB Options
|
|
|
|
DEFINE_bool(use_blob_db, false, "[Stacked BlobDB] Open a BlobDB instance.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(
|
|
|
|
blob_db_enable_gc,
|
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().enable_garbage_collection,
|
2021-02-17 19:08:12 +00:00
|
|
|
"[Stacked BlobDB] Enable BlobDB garbage collection.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_double(
|
|
|
|
blob_db_gc_cutoff,
|
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().garbage_collection_cutoff,
|
2021-02-17 19:08:12 +00:00
|
|
|
"[Stacked BlobDB] Cutoff ratio for BlobDB garbage collection.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(blob_db_is_fifo,
|
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().is_fifo,
|
2021-02-17 19:08:12 +00:00
|
|
|
"[Stacked BlobDB] Enable FIFO eviction strategy in BlobDB.");
|
2019-12-19 01:44:29 +00:00
|
|
|
|
|
|
|
DEFINE_uint64(blob_db_max_db_size,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().max_db_size,
|
2021-02-17 19:08:12 +00:00
|
|
|
"[Stacked BlobDB] Max size limit of the directory where blob "
|
|
|
|
"files are stored.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
DEFINE_uint64(blob_db_max_ttl_range, 0,
|
|
|
|
"[Stacked BlobDB] TTL range to generate BlobDB data (in "
|
|
|
|
"seconds). 0 means no TTL.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
DEFINE_uint64(
|
|
|
|
blob_db_ttl_range_secs,
|
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().ttl_range_secs,
|
|
|
|
"[Stacked BlobDB] TTL bucket size to use when creating blob files.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
DEFINE_uint64(
|
|
|
|
blob_db_min_blob_size,
|
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().min_blob_size,
|
|
|
|
"[Stacked BlobDB] Smallest blob to store in a file. Blobs "
|
|
|
|
"smaller than this will be inlined with the key in the LSM tree.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2019-12-19 01:44:29 +00:00
|
|
|
DEFINE_uint64(blob_db_bytes_per_sync,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().bytes_per_sync,
|
2021-02-17 19:08:12 +00:00
|
|
|
"[Stacked BlobDB] Bytes to sync blob file at.");
|
2017-12-07 04:40:46 +00:00
|
|
|
|
2019-12-19 01:44:29 +00:00
|
|
|
DEFINE_uint64(blob_db_file_size,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::blob_db::BlobDBOptions().blob_file_size,
|
2021-02-17 19:08:12 +00:00
|
|
|
"[Stacked BlobDB] Target size of each blob file.");
|
2017-11-21 07:19:46 +00:00
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
DEFINE_string(
|
|
|
|
blob_db_compression_type, "snappy",
|
|
|
|
"[Stacked BlobDB] Algorithm to use to compress blobs in blob files.");
|
2020-02-20 20:07:53 +00:00
|
|
|
static enum ROCKSDB_NAMESPACE::CompressionType
|
|
|
|
FLAGS_blob_db_compression_type_e = ROCKSDB_NAMESPACE::kSnappyCompression;
|
2020-02-12 22:44:46 +00:00
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
|
|
|
|
|
|
|
// Integrated BlobDB options
|
|
|
|
DEFINE_bool(
|
|
|
|
enable_blob_files,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions().enable_blob_files,
|
|
|
|
"[Integrated BlobDB] Enable writing large values to separate blob files.");
|
|
|
|
|
|
|
|
DEFINE_uint64(min_blob_size,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions().min_blob_size,
|
|
|
|
"[Integrated BlobDB] The size of the smallest value to be stored "
|
|
|
|
"separately in a blob file.");
|
|
|
|
|
|
|
|
DEFINE_uint64(blob_file_size,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions().blob_file_size,
|
|
|
|
"[Integrated BlobDB] The size limit for blob files.");
|
|
|
|
|
|
|
|
DEFINE_string(blob_compression_type, "none",
|
|
|
|
"[Integrated BlobDB] The compression algorithm to use for large "
|
|
|
|
"values stored in blob files.");
|
|
|
|
|
|
|
|
DEFINE_bool(enable_blob_garbage_collection,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions()
|
|
|
|
.enable_blob_garbage_collection,
|
|
|
|
"[Integrated BlobDB] Enable blob garbage collection.");
|
|
|
|
|
|
|
|
DEFINE_double(blob_garbage_collection_age_cutoff,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions()
|
|
|
|
.blob_garbage_collection_age_cutoff,
|
|
|
|
"[Integrated BlobDB] The cutoff in terms of blob file age for "
|
|
|
|
"garbage collection.");
|
|
|
|
|
Make it possible to force the garbage collection of the oldest blob files (#8994)
Summary:
The current BlobDB garbage collection logic works by relocating the valid
blobs from the oldest blob files as they are encountered during compaction,
and cleaning up blob files once they contain nothing but garbage. However,
with sufficiently skewed workloads, it is theoretically possible to end up in a
situation when few or no compactions get scheduled for the SST files that contain
references to the oldest blob files, which can lead to increased space amp due
to the lack of GC.
In order to efficiently handle such workloads, the patch adds a new BlobDB
configuration option called `blob_garbage_collection_force_threshold`,
which signals to BlobDB to schedule targeted compactions for the SST files
that keep alive the oldest batch of blob files if the overall ratio of garbage in
the given blob files meets the threshold *and* all the given blob files are
eligible for GC based on `blob_garbage_collection_age_cutoff`. (For example,
if the new option is set to 0.9, targeted compactions will get scheduled if the
sum of garbage bytes meets or exceeds 90% of the sum of total bytes in the
oldest blob files, assuming all affected blob files are below the age-based cutoff.)
The net result of these targeted compactions is that the valid blobs in the oldest
blob files are relocated and the oldest blob files themselves cleaned up (since
*all* SST files that rely on them get compacted away).
These targeted compactions are similar to periodic compactions in the sense
that they force certain SST files that otherwise would not get picked up to undergo
compaction and also in the sense that instead of merging files from multiple levels,
they target a single file. (Note: such compactions might still include neighboring files
from the same level due to the need of having a "clean cut" boundary but they never
include any files from any other level.)
This functionality is currently only supported with the leveled compaction style
and is inactive by default (since the default value is set to 1.0, i.e. 100%).
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8994
Test Plan: Ran `make check` and tested using `db_bench` and the stress/crash tests.
Reviewed By: riversand963
Differential Revision: D31489850
Pulled By: ltamasi
fbshipit-source-id: 44057d511726a0e2a03c5d9313d7511b3f0c4eab
2021-10-12 01:00:44 +00:00
|
|
|
DEFINE_double(blob_garbage_collection_force_threshold,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions()
|
|
|
|
.blob_garbage_collection_force_threshold,
|
|
|
|
"[Integrated BlobDB] The threshold for the ratio of garbage in "
|
|
|
|
"the oldest blob files for forcing garbage collection.");
|
|
|
|
|
2021-11-20 01:52:42 +00:00
|
|
|
DEFINE_uint64(blob_compaction_readahead_size,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions()
|
|
|
|
.blob_compaction_readahead_size,
|
|
|
|
"[Integrated BlobDB] Compaction readahead for blob files.");
|
|
|
|
|
2022-06-03 03:04:33 +00:00
|
|
|
DEFINE_int32(
|
|
|
|
blob_file_starting_level,
|
|
|
|
ROCKSDB_NAMESPACE::AdvancedColumnFamilyOptions().blob_file_starting_level,
|
|
|
|
"[Integrated BlobDB] The starting level for blob files.");
|
|
|
|
|
2022-06-22 23:04:03 +00:00
|
|
|
DEFINE_bool(use_blob_cache, false, "[Integrated BlobDB] Enable blob cache.");
|
|
|
|
|
|
|
|
DEFINE_bool(
|
|
|
|
use_shared_block_and_blob_cache, true,
|
|
|
|
"[Integrated BlobDB] Use a shared backing cache for both block "
|
|
|
|
"cache and blob cache. It only takes effect if use_blob_cache is enabled.");
|
|
|
|
|
|
|
|
DEFINE_uint64(
|
|
|
|
blob_cache_size, 8 << 20,
|
|
|
|
"[Integrated BlobDB] Number of bytes to use as a cache of blobs. It only "
|
|
|
|
"takes effect if the block and blob caches are different "
|
|
|
|
"(use_shared_block_and_blob_cache = false).");
|
|
|
|
|
|
|
|
DEFINE_int32(blob_cache_numshardbits, 6,
|
|
|
|
"[Integrated BlobDB] Number of shards for the blob cache is 2 ** "
|
|
|
|
"blob_cache_numshardbits. Negative means use default settings. "
|
|
|
|
"It only takes effect if blob_cache_size is greater than 0, and "
|
|
|
|
"the block and blob caches are different "
|
|
|
|
"(use_shared_block_and_blob_cache = false).");
|
|
|
|
|
2022-07-17 14:13:59 +00:00
|
|
|
DEFINE_int32(prepopulate_blob_cache, 0,
|
|
|
|
"[Integrated BlobDB] Pre-populate hot/warm blobs in blob cache. 0 "
|
|
|
|
"to disable and 1 to insert during flush.");
|
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
|
2019-05-31 02:29:34 +00:00
|
|
|
// Secondary DB instance Options
|
|
|
|
DEFINE_bool(use_secondary_db, false,
|
|
|
|
"Open a RocksDB secondary instance. A primary instance can be "
|
|
|
|
"running in another db_bench process.");
|
|
|
|
|
|
|
|
DEFINE_string(secondary_path, "",
|
|
|
|
"Path to a directory used by the secondary instance to store "
|
|
|
|
"private files, e.g. info log.");
|
|
|
|
|
|
|
|
DEFINE_int32(secondary_update_interval, 5,
|
|
|
|
"Secondary instance attempts to catch up with the primary every "
|
|
|
|
"secondary_update_interval seconds.");
|
|
|
|
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2015-08-28 23:09:34 +00:00
|
|
|
|
2016-04-14 20:56:29 +00:00
|
|
|
DEFINE_bool(report_bg_io_stats, false,
|
Add options.compaction_measure_io_stats to print write I/O stats in compactions
Summary:
Add options.compaction_measure_io_stats to print out / pass to listener accumulated time spent on write calls. Example outputs in info logs:
2015/08/12-16:27:59.463944 7fd428bff700 (Original Log Time 2015/08/12-16:27:59.463922) EVENT_LOG_v1 {"time_micros": 1439422079463897, "job": 6, "event": "compaction_finished", "output_level": 1, "num_output_files": 4, "total_output_size": 6900525, "num_input_records": 111483, "num_output_records": 106877, "file_write_nanos": 15663206, "file_range_sync_nanos": 649588, "file_fsync_nanos": 349614797, "file_prepare_write_nanos": 1505812, "lsm_state": [2, 4, 0, 0, 0, 0, 0]}
Add two more counters in iostats_context.
Also add a parameter of db_bench.
Test Plan: Add a unit test. Also manually verify LOG outputs in db_bench
Subscribers: leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D44115
2015-08-13 00:24:45 +00:00
|
|
|
"Measure times spents on I/Os while in compactions. ");
|
|
|
|
|
2016-12-10 00:36:43 +00:00
|
|
|
DEFINE_bool(use_stderr_info_logger, false,
|
|
|
|
"Write info logs to stderr instead of to LOG file. ");
|
|
|
|
|
2021-08-12 02:31:44 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
|
2018-08-01 07:14:43 +00:00
|
|
|
DEFINE_string(trace_file, "", "Trace workload to a file. ");
|
|
|
|
|
2021-08-12 02:31:44 +00:00
|
|
|
DEFINE_double(trace_replay_fast_forward, 1.0,
|
|
|
|
"Fast forward trace replay, must > 0.0.");
|
2019-06-17 18:03:47 +00:00
|
|
|
DEFINE_int32(block_cache_trace_sampling_frequency, 1,
|
|
|
|
"Block cache trace sampling frequency, termed s. It uses spatial "
|
|
|
|
"downsampling and samples accesses to one out of s blocks.");
|
|
|
|
DEFINE_int64(
|
|
|
|
block_cache_trace_max_trace_file_size_in_bytes,
|
|
|
|
uint64_t{64} * 1024 * 1024 * 1024,
|
|
|
|
"The maximum block cache trace file size in bytes. Block cache accesses "
|
|
|
|
"will not be logged if the trace file size exceeds this threshold. Default "
|
|
|
|
"is 64 GB.");
|
|
|
|
DEFINE_string(block_cache_trace_file, "", "Block cache trace file path.");
|
2019-10-18 21:12:21 +00:00
|
|
|
DEFINE_int32(trace_replay_threads, 1,
|
|
|
|
"The number of threads to replay, must >=1.");
|
2019-06-17 18:03:47 +00:00
|
|
|
|
2021-09-18 16:31:57 +00:00
|
|
|
DEFINE_bool(io_uring_enabled, true,
|
|
|
|
"If true, enable the use of IO uring if the platform supports it");
|
|
|
|
extern "C" bool RocksDbIOUringEnable() { return FLAGS_io_uring_enabled; }
|
2021-08-12 02:31:44 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
|
|
|
|
2021-11-11 00:18:27 +00:00
|
|
|
DEFINE_bool(adaptive_readahead, false,
|
|
|
|
"carry forward internal auto readahead size from one file to next "
|
|
|
|
"file at each level during iteration");
|
|
|
|
|
2022-02-17 07:17:03 +00:00
|
|
|
DEFINE_bool(rate_limit_user_ops, false,
|
|
|
|
"When true use Env::IO_USER priority level to charge internal rate "
|
|
|
|
"limiter for reads associated with user operations.");
|
|
|
|
|
|
|
|
DEFINE_bool(file_checksum, false,
|
|
|
|
"When true use FileChecksumGenCrc32cFactory for "
|
|
|
|
"file_checksum_gen_factory.");
|
|
|
|
|
Rate-limit automatic WAL flush after each user write (#9607)
Summary:
**Context:**
WAL flush is currently not rate-limited by `Options::rate_limiter`. This PR is to provide rate-limiting to auto WAL flush, the one that automatically happen after each user write operation (i.e, `Options::manual_wal_flush == false`), by adding `WriteOptions::rate_limiter_options`.
Note that we are NOT rate-limiting WAL flush that do NOT automatically happen after each user write, such as `Options::manual_wal_flush == true + manual FlushWAL()` (rate-limiting multiple WAL flushes), for the benefits of:
- being consistent with [ReadOptions::rate_limiter_priority](https://github.com/facebook/rocksdb/blob/7.0.fb/include/rocksdb/options.h#L515)
- being able to turn off some WAL flush's rate-limiting but not all (e.g, turn off specific the WAL flush of a critical user write like a service's heartbeat)
`WriteOptions::rate_limiter_options` only accept `Env::IO_USER` and `Env::IO_TOTAL` currently due to an implementation constraint.
- The constraint is that we currently queue parallel writes (including WAL writes) based on FIFO policy which does not factor rate limiter priority into this layer's scheduling. If we allow lower priorities such as `Env::IO_HIGH/MID/LOW` and such writes specified with lower priorities occurs before ones specified with higher priorities (even just by a tiny bit in arrival time), the former would have blocked the latter, leading to a "priority inversion" issue and contradictory to what we promise for rate-limiting priority. Therefore we only allow `Env::IO_USER` and `Env::IO_TOTAL` right now before improving that scheduling.
A pre-requisite to this feature is to support operation-level rate limiting in `WritableFileWriter`, which is also included in this PR.
**Summary:**
- Renamed test suite `DBRateLimiterTest to DBRateLimiterOnReadTest` for adding a new test suite
- Accept `rate_limiter_priority` in `WritableFileWriter`'s private and public write functions
- Passed `WriteOptions::rate_limiter_options` to `WritableFileWriter` in the path of automatic WAL flush.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9607
Test Plan:
- Added new unit test to verify existing flush/compaction rate-limiting does not break, since `DBTest, RateLimitingTest` is disabled and current db-level rate-limiting tests focus on read only (e.g, `db_rate_limiter_test`, `DBTest2, RateLimitedCompactionReads`).
- Added new unit test `DBRateLimiterOnWriteWALTest, AutoWalFlush`
- `strace -ftt -e trace=write ./db_bench -benchmarks=fillseq -db=/dev/shm/testdb -rate_limit_auto_wal_flush=1 -rate_limiter_bytes_per_sec=15 -rate_limiter_refill_period_us=1000000 -write_buffer_size=100000000 -disable_auto_compactions=1 -num=100`
- verified that WAL flush(i.e, system-call _write_) were chunked into 15 bytes and each _write_ was roughly 1 second apart
- verified the chunking disappeared when `-rate_limit_auto_wal_flush=0`
- crash test: `python3 tools/db_crashtest.py blackbox --disable_wal=0 --rate_limit_auto_wal_flush=1 --rate_limiter_bytes_per_sec=10485760 --interval=10` killed as normal
**Benchmarked on flush/compaction to ensure no performance regression:**
- compaction with rate-limiting (see table 1, avg over 1280-run): pre-change: **915635 micros/op**; post-change:
**907350 micros/op (improved by 0.106%)**
```
#!/bin/bash
TEST_TMPDIR=/dev/shm/testdb
START=1
NUM_DATA_ENTRY=8
N=10
rm -f compact_bmk_output.txt compact_bmk_output_2.txt dont_care_output.txt
for i in $(eval echo "{$START..$NUM_DATA_ENTRY}")
do
NUM_RUN=$(($N*(2**($i-1))))
for j in $(eval echo "{$START..$NUM_RUN}")
do
./db_bench --benchmarks=fillrandom -db=$TEST_TMPDIR -disable_auto_compactions=1 -write_buffer_size=6710886 > dont_care_output.txt && ./db_bench --benchmarks=compact -use_existing_db=1 -db=$TEST_TMPDIR -level0_file_num_compaction_trigger=1 -rate_limiter_bytes_per_sec=100000000 | egrep 'compact'
done > compact_bmk_output.txt && awk -v NUM_RUN=$NUM_RUN '{sum+=$3;sum_sqrt+=$3^2}END{print sum/NUM_RUN, sqrt(sum_sqrt/NUM_RUN-(sum/NUM_RUN)^2)}' compact_bmk_output.txt >> compact_bmk_output_2.txt
done
```
- compaction w/o rate-limiting (see table 2, avg over 640-run): pre-change: **822197 micros/op**; post-change: **823148 micros/op (regressed by 0.12%)**
```
Same as above script, except that -rate_limiter_bytes_per_sec=0
```
- flush with rate-limiting (see table 3, avg over 320-run, run on the [patch](https://github.com/hx235/rocksdb/commit/ee5c6023a9f6533fab9afdc681568daa21da4953) to augment current db_bench ): pre-change: **745752 micros/op**; post-change: **745331 micros/op (regressed by 0.06 %)**
```
#!/bin/bash
TEST_TMPDIR=/dev/shm/testdb
START=1
NUM_DATA_ENTRY=8
N=10
rm -f flush_bmk_output.txt flush_bmk_output_2.txt
for i in $(eval echo "{$START..$NUM_DATA_ENTRY}")
do
NUM_RUN=$(($N*(2**($i-1))))
for j in $(eval echo "{$START..$NUM_RUN}")
do
./db_bench -db=$TEST_TMPDIR -write_buffer_size=1048576000 -num=1000000 -rate_limiter_bytes_per_sec=100000000 -benchmarks=fillseq,flush | egrep 'flush'
done > flush_bmk_output.txt && awk -v NUM_RUN=$NUM_RUN '{sum+=$3;sum_sqrt+=$3^2}END{print sum/NUM_RUN, sqrt(sum_sqrt/NUM_RUN-(sum/NUM_RUN)^2)}' flush_bmk_output.txt >> flush_bmk_output_2.txt
done
```
- flush w/o rate-limiting (see table 4, avg over 320-run, run on the [patch](https://github.com/hx235/rocksdb/commit/ee5c6023a9f6533fab9afdc681568daa21da4953) to augment current db_bench): pre-change: **487512 micros/op**, post-change: **485856 micors/ops (improved by 0.34%)**
```
Same as above script, except that -rate_limiter_bytes_per_sec=0
```
| table 1 - compact with rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 896978 | 16046.9 | 901242 | 15670.9 | 0.475373978
20 | 893718 | 15813 | 886505 | 17544.7 | -0.8070778478
40 | 900426 | 23882.2 | 894958 | 15104.5 | -0.6072681153
80 | 906635 | 21761.5 | 903332 | 23948.3 | -0.3643141948
160 | 898632 | 21098.9 | 907583 | 21145 | 0.9960695813
3.20E+02 | 905252 | 22785.5 | 908106 | 25325.5 | 0.3152713278
6.40E+02 | 905213 | 23598.6 | 906741 | 21370.5 | 0.1688000504
**1.28E+03** | **908316** | **23533.1** | **907350** | **24626.8** | **-0.1063506533**
average over #-run | 901896.25 | 21064.9625 | 901977.125 | 20592.025 | 0.008967217682
| table 2 - compact w/o rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 811211 | 26996.7 | 807586 | 28456.4 | -0.4468627768
20 | 815465 | 14803.7 | 814608 | 28719.7 | -0.105093413
40 | 809203 | 26187.1 | 797835 | 25492.1 | -1.404839082
80 | 822088 | 28765.3 | 822192 | 32840.4 | 0.01265071379
160 | 821719 | 36344.7 | 821664 | 29544.9 | -0.006693285661
3.20E+02 | 820921 | 27756.4 | 821403 | 28347.7 | 0.05871454135
**6.40E+02** | **822197** | **28960.6** | **823148** | **30055.1** | **0.1156657103**
average over #-run | 8.18E+05 | 2.71E+04 | 8.15E+05 | 2.91E+04 | -0.25
| table 3 - flush with rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 741721 | 11770.8 | 740345 | 5949.76 | -0.1855144994
20 | 735169 | 3561.83 | 743199 | 9755.77 | 1.09226586
40 | 743368 | 8891.03 | 742102 | 8683.22 | -0.1703059588
80 | 742129 | 8148.51 | 743417 | 9631.58| 0.1735547324
160 | 749045 | 9757.21 | 746256 | 9191.86 | -0.3723407806
**3.20E+02** | **745752** | **9819.65** | **745331** | **9840.62** | **-0.0564530836**
6.40E+02 | 749006 | 11080.5 | 748173 | 10578.7 | -0.1112140624
average over #-run | 743741.4286 | 9004.218571 | 744117.5714 | 9090.215714 | 0.05057441238
| table 4 - flush w/o rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 477283 | 24719.6 | 473864 | 12379 | -0.7163464863
20 | 486743 | 20175.2 | 502296 | 23931.3 | 3.195320734
40 | 482846 | 15309.2 | 489820 | 22259.5 | 1.444352858
80 | 491490 | 21883.1 | 490071 | 23085.7 | -0.2887139108
160 | 493347 | 28074.3 | 483609 | 21211.7 | -1.973864238
**3.20E+02** | **487512** | **21401.5** | **485856** | **22195.2** | **-0.3396839462**
6.40E+02 | 490307 | 25418.6 | 485435 | 22405.2 | -0.9936631539
average over #-run | 4.87E+05 | 2.24E+04 | 4.87E+05 | 2.11E+04 | 0.00E+00
Reviewed By: ajkr
Differential Revision: D34442441
Pulled By: hx235
fbshipit-source-id: 4790f13e1e5c0a95ae1d1cc93ffcf69dc6e78bdd
2022-03-08 21:19:39 +00:00
|
|
|
DEFINE_bool(rate_limit_auto_wal_flush, false,
|
|
|
|
"When true use Env::IO_USER priority level to charge internal rate "
|
|
|
|
"limiter for automatic WAL flush (`Options::manual_wal_flush` == "
|
2022-04-01 23:06:14 +00:00
|
|
|
"false) after the user write operation.");
|
Rate-limit automatic WAL flush after each user write (#9607)
Summary:
**Context:**
WAL flush is currently not rate-limited by `Options::rate_limiter`. This PR is to provide rate-limiting to auto WAL flush, the one that automatically happen after each user write operation (i.e, `Options::manual_wal_flush == false`), by adding `WriteOptions::rate_limiter_options`.
Note that we are NOT rate-limiting WAL flush that do NOT automatically happen after each user write, such as `Options::manual_wal_flush == true + manual FlushWAL()` (rate-limiting multiple WAL flushes), for the benefits of:
- being consistent with [ReadOptions::rate_limiter_priority](https://github.com/facebook/rocksdb/blob/7.0.fb/include/rocksdb/options.h#L515)
- being able to turn off some WAL flush's rate-limiting but not all (e.g, turn off specific the WAL flush of a critical user write like a service's heartbeat)
`WriteOptions::rate_limiter_options` only accept `Env::IO_USER` and `Env::IO_TOTAL` currently due to an implementation constraint.
- The constraint is that we currently queue parallel writes (including WAL writes) based on FIFO policy which does not factor rate limiter priority into this layer's scheduling. If we allow lower priorities such as `Env::IO_HIGH/MID/LOW` and such writes specified with lower priorities occurs before ones specified with higher priorities (even just by a tiny bit in arrival time), the former would have blocked the latter, leading to a "priority inversion" issue and contradictory to what we promise for rate-limiting priority. Therefore we only allow `Env::IO_USER` and `Env::IO_TOTAL` right now before improving that scheduling.
A pre-requisite to this feature is to support operation-level rate limiting in `WritableFileWriter`, which is also included in this PR.
**Summary:**
- Renamed test suite `DBRateLimiterTest to DBRateLimiterOnReadTest` for adding a new test suite
- Accept `rate_limiter_priority` in `WritableFileWriter`'s private and public write functions
- Passed `WriteOptions::rate_limiter_options` to `WritableFileWriter` in the path of automatic WAL flush.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9607
Test Plan:
- Added new unit test to verify existing flush/compaction rate-limiting does not break, since `DBTest, RateLimitingTest` is disabled and current db-level rate-limiting tests focus on read only (e.g, `db_rate_limiter_test`, `DBTest2, RateLimitedCompactionReads`).
- Added new unit test `DBRateLimiterOnWriteWALTest, AutoWalFlush`
- `strace -ftt -e trace=write ./db_bench -benchmarks=fillseq -db=/dev/shm/testdb -rate_limit_auto_wal_flush=1 -rate_limiter_bytes_per_sec=15 -rate_limiter_refill_period_us=1000000 -write_buffer_size=100000000 -disable_auto_compactions=1 -num=100`
- verified that WAL flush(i.e, system-call _write_) were chunked into 15 bytes and each _write_ was roughly 1 second apart
- verified the chunking disappeared when `-rate_limit_auto_wal_flush=0`
- crash test: `python3 tools/db_crashtest.py blackbox --disable_wal=0 --rate_limit_auto_wal_flush=1 --rate_limiter_bytes_per_sec=10485760 --interval=10` killed as normal
**Benchmarked on flush/compaction to ensure no performance regression:**
- compaction with rate-limiting (see table 1, avg over 1280-run): pre-change: **915635 micros/op**; post-change:
**907350 micros/op (improved by 0.106%)**
```
#!/bin/bash
TEST_TMPDIR=/dev/shm/testdb
START=1
NUM_DATA_ENTRY=8
N=10
rm -f compact_bmk_output.txt compact_bmk_output_2.txt dont_care_output.txt
for i in $(eval echo "{$START..$NUM_DATA_ENTRY}")
do
NUM_RUN=$(($N*(2**($i-1))))
for j in $(eval echo "{$START..$NUM_RUN}")
do
./db_bench --benchmarks=fillrandom -db=$TEST_TMPDIR -disable_auto_compactions=1 -write_buffer_size=6710886 > dont_care_output.txt && ./db_bench --benchmarks=compact -use_existing_db=1 -db=$TEST_TMPDIR -level0_file_num_compaction_trigger=1 -rate_limiter_bytes_per_sec=100000000 | egrep 'compact'
done > compact_bmk_output.txt && awk -v NUM_RUN=$NUM_RUN '{sum+=$3;sum_sqrt+=$3^2}END{print sum/NUM_RUN, sqrt(sum_sqrt/NUM_RUN-(sum/NUM_RUN)^2)}' compact_bmk_output.txt >> compact_bmk_output_2.txt
done
```
- compaction w/o rate-limiting (see table 2, avg over 640-run): pre-change: **822197 micros/op**; post-change: **823148 micros/op (regressed by 0.12%)**
```
Same as above script, except that -rate_limiter_bytes_per_sec=0
```
- flush with rate-limiting (see table 3, avg over 320-run, run on the [patch](https://github.com/hx235/rocksdb/commit/ee5c6023a9f6533fab9afdc681568daa21da4953) to augment current db_bench ): pre-change: **745752 micros/op**; post-change: **745331 micros/op (regressed by 0.06 %)**
```
#!/bin/bash
TEST_TMPDIR=/dev/shm/testdb
START=1
NUM_DATA_ENTRY=8
N=10
rm -f flush_bmk_output.txt flush_bmk_output_2.txt
for i in $(eval echo "{$START..$NUM_DATA_ENTRY}")
do
NUM_RUN=$(($N*(2**($i-1))))
for j in $(eval echo "{$START..$NUM_RUN}")
do
./db_bench -db=$TEST_TMPDIR -write_buffer_size=1048576000 -num=1000000 -rate_limiter_bytes_per_sec=100000000 -benchmarks=fillseq,flush | egrep 'flush'
done > flush_bmk_output.txt && awk -v NUM_RUN=$NUM_RUN '{sum+=$3;sum_sqrt+=$3^2}END{print sum/NUM_RUN, sqrt(sum_sqrt/NUM_RUN-(sum/NUM_RUN)^2)}' flush_bmk_output.txt >> flush_bmk_output_2.txt
done
```
- flush w/o rate-limiting (see table 4, avg over 320-run, run on the [patch](https://github.com/hx235/rocksdb/commit/ee5c6023a9f6533fab9afdc681568daa21da4953) to augment current db_bench): pre-change: **487512 micros/op**, post-change: **485856 micors/ops (improved by 0.34%)**
```
Same as above script, except that -rate_limiter_bytes_per_sec=0
```
| table 1 - compact with rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 896978 | 16046.9 | 901242 | 15670.9 | 0.475373978
20 | 893718 | 15813 | 886505 | 17544.7 | -0.8070778478
40 | 900426 | 23882.2 | 894958 | 15104.5 | -0.6072681153
80 | 906635 | 21761.5 | 903332 | 23948.3 | -0.3643141948
160 | 898632 | 21098.9 | 907583 | 21145 | 0.9960695813
3.20E+02 | 905252 | 22785.5 | 908106 | 25325.5 | 0.3152713278
6.40E+02 | 905213 | 23598.6 | 906741 | 21370.5 | 0.1688000504
**1.28E+03** | **908316** | **23533.1** | **907350** | **24626.8** | **-0.1063506533**
average over #-run | 901896.25 | 21064.9625 | 901977.125 | 20592.025 | 0.008967217682
| table 2 - compact w/o rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 811211 | 26996.7 | 807586 | 28456.4 | -0.4468627768
20 | 815465 | 14803.7 | 814608 | 28719.7 | -0.105093413
40 | 809203 | 26187.1 | 797835 | 25492.1 | -1.404839082
80 | 822088 | 28765.3 | 822192 | 32840.4 | 0.01265071379
160 | 821719 | 36344.7 | 821664 | 29544.9 | -0.006693285661
3.20E+02 | 820921 | 27756.4 | 821403 | 28347.7 | 0.05871454135
**6.40E+02** | **822197** | **28960.6** | **823148** | **30055.1** | **0.1156657103**
average over #-run | 8.18E+05 | 2.71E+04 | 8.15E+05 | 2.91E+04 | -0.25
| table 3 - flush with rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 741721 | 11770.8 | 740345 | 5949.76 | -0.1855144994
20 | 735169 | 3561.83 | 743199 | 9755.77 | 1.09226586
40 | 743368 | 8891.03 | 742102 | 8683.22 | -0.1703059588
80 | 742129 | 8148.51 | 743417 | 9631.58| 0.1735547324
160 | 749045 | 9757.21 | 746256 | 9191.86 | -0.3723407806
**3.20E+02** | **745752** | **9819.65** | **745331** | **9840.62** | **-0.0564530836**
6.40E+02 | 749006 | 11080.5 | 748173 | 10578.7 | -0.1112140624
average over #-run | 743741.4286 | 9004.218571 | 744117.5714 | 9090.215714 | 0.05057441238
| table 4 - flush w/o rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 477283 | 24719.6 | 473864 | 12379 | -0.7163464863
20 | 486743 | 20175.2 | 502296 | 23931.3 | 3.195320734
40 | 482846 | 15309.2 | 489820 | 22259.5 | 1.444352858
80 | 491490 | 21883.1 | 490071 | 23085.7 | -0.2887139108
160 | 493347 | 28074.3 | 483609 | 21211.7 | -1.973864238
**3.20E+02** | **487512** | **21401.5** | **485856** | **22195.2** | **-0.3396839462**
6.40E+02 | 490307 | 25418.6 | 485435 | 22405.2 | -0.9936631539
average over #-run | 4.87E+05 | 2.24E+04 | 4.87E+05 | 2.11E+04 | 0.00E+00
Reviewed By: ajkr
Differential Revision: D34442441
Pulled By: hx235
fbshipit-source-id: 4790f13e1e5c0a95ae1d1cc93ffcf69dc6e78bdd
2022-03-08 21:19:39 +00:00
|
|
|
|
2022-03-23 00:21:35 +00:00
|
|
|
DEFINE_bool(async_io, false,
|
|
|
|
"When set true, RocksDB does asynchronous reads for internal auto "
|
|
|
|
"readahead prefetching.");
|
|
|
|
|
2022-05-17 22:01:51 +00:00
|
|
|
DEFINE_bool(charge_compression_dictionary_building_buffer, false,
|
|
|
|
"Setting for "
|
2022-07-19 06:26:57 +00:00
|
|
|
"CacheEntryRoleOptions::charged of "
|
2022-05-17 22:01:51 +00:00
|
|
|
"CacheEntryRole::kCompressionDictionaryBuildingBuffer");
|
|
|
|
|
|
|
|
DEFINE_bool(charge_filter_construction, false,
|
|
|
|
"Setting for "
|
2022-07-19 06:26:57 +00:00
|
|
|
"CacheEntryRoleOptions::charged of "
|
2022-05-17 22:01:51 +00:00
|
|
|
"CacheEntryRole::kFilterConstruction");
|
|
|
|
|
|
|
|
DEFINE_bool(charge_table_reader, false,
|
|
|
|
"Setting for "
|
2022-07-19 06:26:57 +00:00
|
|
|
"CacheEntryRoleOptions::charged of "
|
2022-05-17 22:01:51 +00:00
|
|
|
"CacheEntryRole::kBlockBasedTableReader");
|
2022-04-06 17:33:00 +00:00
|
|
|
|
Account memory of FileMetaData in global memory limit (#9924)
Summary:
**Context/Summary:**
As revealed by heap profiling, allocation of `FileMetaData` for [newly created file added to a Version](https://github.com/facebook/rocksdb/pull/9924/files#diff-a6aa385940793f95a2c5b39cc670bd440c4547fa54fd44622f756382d5e47e43R774) can consume significant heap memory. This PR is to account that toward our global memory limit based on block cache capacity.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9924
Test Plan:
- Previous `make check` verified there are only 2 places where the memory of the allocated `FileMetaData` can be released
- New unit test `TEST_P(ChargeFileMetadataTestWithParam, Basic)`
- db bench (CPU cost of `charge_file_metadata` in write and compact)
- **write micros/op: -0.24%** : `TEST_TMPDIR=/dev/shm/testdb ./db_bench -benchmarks=fillseq -db=$TEST_TMPDIR -charge_file_metadata=1 (remove this option for pre-PR) -disable_auto_compactions=1 -write_buffer_size=100000 -num=4000000 | egrep 'fillseq'`
- **compact micros/op -0.87%** : `TEST_TMPDIR=/dev/shm/testdb ./db_bench -benchmarks=fillseq -db=$TEST_TMPDIR -charge_file_metadata=1 -disable_auto_compactions=1 -write_buffer_size=100000 -num=4000000 -numdistinct=1000 && ./db_bench -benchmarks=compact -db=$TEST_TMPDIR -use_existing_db=1 -charge_file_metadata=1 -disable_auto_compactions=1 | egrep 'compact'`
table 1 - write
#-run | (pre-PR) avg micros/op | std micros/op | (post-PR) micros/op | std micros/op | change (%)
-- | -- | -- | -- | -- | --
10 | 3.9711 | 0.264408 | 3.9914 | 0.254563 | 0.5111933721
20 | 3.83905 | 0.0664488 | 3.8251 | 0.0695456 | -0.3633711465
40 | 3.86625 | 0.136669 | 3.8867 | 0.143765 | 0.5289363078
80 | 3.87828 | 0.119007 | 3.86791 | 0.115674 | **-0.2673865734**
160 | 3.87677 | 0.162231 | 3.86739 | 0.16663 | **-0.2419539978**
table 2 - compact
#-run | (pre-PR) avg micros/op | std micros/op | (post-PR) micros/op | std micros/op | change (%)
-- | -- | -- | -- | -- | --
10 | 2,399,650.00 | 96,375.80 | 2,359,537.00 | 53,243.60 | -1.67
20 | 2,410,480.00 | 89,988.00 | 2,433,580.00 | 91,121.20 | 0.96
40 | 2.41E+06 | 121811 | 2.39E+06 | 131525 | **-0.96**
80 | 2.40E+06 | 134503 | 2.39E+06 | 108799 | **-0.78**
- stress test: `python3 tools/db_crashtest.py blackbox --charge_file_metadata=1 --cache_size=1` killed as normal
Reviewed By: ajkr
Differential Revision: D36055583
Pulled By: hx235
fbshipit-source-id: b60eab94707103cb1322cf815f05810ef0232625
2022-06-14 20:06:40 +00:00
|
|
|
DEFINE_bool(charge_file_metadata, false,
|
|
|
|
"Setting for "
|
2022-07-19 06:26:57 +00:00
|
|
|
"CacheEntryRoleOptions::charged of "
|
Account memory of FileMetaData in global memory limit (#9924)
Summary:
**Context/Summary:**
As revealed by heap profiling, allocation of `FileMetaData` for [newly created file added to a Version](https://github.com/facebook/rocksdb/pull/9924/files#diff-a6aa385940793f95a2c5b39cc670bd440c4547fa54fd44622f756382d5e47e43R774) can consume significant heap memory. This PR is to account that toward our global memory limit based on block cache capacity.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9924
Test Plan:
- Previous `make check` verified there are only 2 places where the memory of the allocated `FileMetaData` can be released
- New unit test `TEST_P(ChargeFileMetadataTestWithParam, Basic)`
- db bench (CPU cost of `charge_file_metadata` in write and compact)
- **write micros/op: -0.24%** : `TEST_TMPDIR=/dev/shm/testdb ./db_bench -benchmarks=fillseq -db=$TEST_TMPDIR -charge_file_metadata=1 (remove this option for pre-PR) -disable_auto_compactions=1 -write_buffer_size=100000 -num=4000000 | egrep 'fillseq'`
- **compact micros/op -0.87%** : `TEST_TMPDIR=/dev/shm/testdb ./db_bench -benchmarks=fillseq -db=$TEST_TMPDIR -charge_file_metadata=1 -disable_auto_compactions=1 -write_buffer_size=100000 -num=4000000 -numdistinct=1000 && ./db_bench -benchmarks=compact -db=$TEST_TMPDIR -use_existing_db=1 -charge_file_metadata=1 -disable_auto_compactions=1 | egrep 'compact'`
table 1 - write
#-run | (pre-PR) avg micros/op | std micros/op | (post-PR) micros/op | std micros/op | change (%)
-- | -- | -- | -- | -- | --
10 | 3.9711 | 0.264408 | 3.9914 | 0.254563 | 0.5111933721
20 | 3.83905 | 0.0664488 | 3.8251 | 0.0695456 | -0.3633711465
40 | 3.86625 | 0.136669 | 3.8867 | 0.143765 | 0.5289363078
80 | 3.87828 | 0.119007 | 3.86791 | 0.115674 | **-0.2673865734**
160 | 3.87677 | 0.162231 | 3.86739 | 0.16663 | **-0.2419539978**
table 2 - compact
#-run | (pre-PR) avg micros/op | std micros/op | (post-PR) micros/op | std micros/op | change (%)
-- | -- | -- | -- | -- | --
10 | 2,399,650.00 | 96,375.80 | 2,359,537.00 | 53,243.60 | -1.67
20 | 2,410,480.00 | 89,988.00 | 2,433,580.00 | 91,121.20 | 0.96
40 | 2.41E+06 | 121811 | 2.39E+06 | 131525 | **-0.96**
80 | 2.40E+06 | 134503 | 2.39E+06 | 108799 | **-0.78**
- stress test: `python3 tools/db_crashtest.py blackbox --charge_file_metadata=1 --cache_size=1` killed as normal
Reviewed By: ajkr
Differential Revision: D36055583
Pulled By: hx235
fbshipit-source-id: b60eab94707103cb1322cf815f05810ef0232625
2022-06-14 20:06:40 +00:00
|
|
|
"CacheEntryRole::kFileMetadata");
|
|
|
|
|
2022-07-19 06:26:57 +00:00
|
|
|
DEFINE_bool(charge_blob_cache, false,
|
|
|
|
"Setting for "
|
|
|
|
"CacheEntryRoleOptions::charged of "
|
|
|
|
"CacheEntryRole::kBlobCache");
|
|
|
|
|
2022-05-24 17:28:57 +00:00
|
|
|
DEFINE_uint64(backup_rate_limit, 0ull,
|
|
|
|
"If non-zero, db_bench will rate limit reads and writes for DB "
|
|
|
|
"backup. This "
|
|
|
|
"is the global rate in ops/second.");
|
|
|
|
|
|
|
|
DEFINE_uint64(restore_rate_limit, 0ull,
|
|
|
|
"If non-zero, db_bench will rate limit reads and writes for DB "
|
|
|
|
"restore. This "
|
|
|
|
"is the global rate in ops/second.");
|
|
|
|
|
|
|
|
DEFINE_string(backup_dir, "",
|
|
|
|
"If not empty string, use the given dir for backup.");
|
|
|
|
|
|
|
|
DEFINE_string(restore_dir, "",
|
|
|
|
"If not empty string, use the given dir for restore.");
|
|
|
|
|
2022-08-19 01:03:44 +00:00
|
|
|
DEFINE_uint64(
|
|
|
|
initial_auto_readahead_size,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().initial_auto_readahead_size,
|
|
|
|
"RocksDB does auto-readahead for iterators on noticing more than two reads "
|
|
|
|
"for a table file if user doesn't provide readahead_size. The readahead "
|
|
|
|
"size starts at initial_auto_readahead_size");
|
|
|
|
|
|
|
|
DEFINE_uint64(
|
|
|
|
max_auto_readahead_size,
|
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions().max_auto_readahead_size,
|
|
|
|
"Rocksdb implicit readahead starts at "
|
|
|
|
"BlockBasedTableOptions.initial_auto_readahead_size and doubles on every "
|
|
|
|
"additional read upto max_auto_readahead_size");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
static enum ROCKSDB_NAMESPACE::CompressionType StringToCompressionType(
|
|
|
|
const char* ctype) {
|
2013-10-24 14:43:14 +00:00
|
|
|
assert(ctype);
|
|
|
|
|
|
|
|
if (!strcasecmp(ctype, "none"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kNoCompression;
|
2013-10-24 14:43:14 +00:00
|
|
|
else if (!strcasecmp(ctype, "snappy"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kSnappyCompression;
|
2013-10-24 14:43:14 +00:00
|
|
|
else if (!strcasecmp(ctype, "zlib"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kZlibCompression;
|
2013-10-24 14:43:14 +00:00
|
|
|
else if (!strcasecmp(ctype, "bzip2"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kBZip2Compression;
|
2014-02-08 02:12:30 +00:00
|
|
|
else if (!strcasecmp(ctype, "lz4"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kLZ4Compression;
|
2014-02-08 02:12:30 +00:00
|
|
|
else if (!strcasecmp(ctype, "lz4hc"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kLZ4HCCompression;
|
2016-04-20 05:54:24 +00:00
|
|
|
else if (!strcasecmp(ctype, "xpress"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kXpressCompression;
|
2015-08-27 22:40:42 +00:00
|
|
|
else if (!strcasecmp(ctype, "zstd"))
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kZSTD;
|
2022-03-23 19:26:34 +00:00
|
|
|
else {
|
|
|
|
fprintf(stderr, "Cannot parse compression type '%s'\n", ctype);
|
|
|
|
exit(1);
|
|
|
|
}
|
2013-10-24 14:43:14 +00:00
|
|
|
}
|
2014-12-23 02:39:28 +00:00
|
|
|
|
2017-02-07 19:34:14 +00:00
|
|
|
static std::string ColumnFamilyName(size_t i) {
|
2014-12-23 02:39:28 +00:00
|
|
|
if (i == 0) {
|
2020-02-20 20:07:53 +00:00
|
|
|
return ROCKSDB_NAMESPACE::kDefaultColumnFamilyName;
|
2014-12-23 02:39:28 +00:00
|
|
|
} else {
|
|
|
|
char name[100];
|
2014-12-31 02:33:35 +00:00
|
|
|
snprintf(name, sizeof(name), "column_family_name_%06zu", i);
|
2014-12-23 02:39:28 +00:00
|
|
|
return std::string(name);
|
|
|
|
}
|
|
|
|
}
|
2014-04-10 04:17:14 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_string(compression_type, "snappy",
|
|
|
|
"Algorithm to use to compress the database");
|
2020-02-20 20:07:53 +00:00
|
|
|
static enum ROCKSDB_NAMESPACE::CompressionType FLAGS_compression_type_e =
|
|
|
|
ROCKSDB_NAMESPACE::kSnappyCompression;
|
2012-09-14 18:21:54 +00:00
|
|
|
|
2019-03-18 19:07:35 +00:00
|
|
|
DEFINE_int64(sample_for_compression, 0, "Sample every N block for compression");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(compression_level, ROCKSDB_NAMESPACE::CompressionOptions().level,
|
2018-08-09 17:17:56 +00:00
|
|
|
"Compression level. The meaning of this value is library-"
|
|
|
|
"dependent. If unset, we try to use the default for the library "
|
|
|
|
"specified in `--compression_type`");
|
2013-12-03 20:32:07 +00:00
|
|
|
|
2018-08-09 17:17:56 +00:00
|
|
|
DEFINE_int32(compression_max_dict_bytes,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::CompressionOptions().max_dict_bytes,
|
2016-04-28 00:39:18 +00:00
|
|
|
"Maximum size of dictionary used to prime the compression "
|
|
|
|
"library.");
|
|
|
|
|
2018-08-09 17:17:56 +00:00
|
|
|
DEFINE_int32(compression_zstd_max_train_bytes,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::CompressionOptions().zstd_max_train_bytes,
|
2017-11-07 21:49:35 +00:00
|
|
|
"Maximum size of training data passed to zstd's dictionary "
|
|
|
|
"trainer.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(min_level_to_compress, -1, "If non-negative, compression starts"
|
|
|
|
" from this level. Levels with number < min_level_to_compress are"
|
|
|
|
" not compressed. Otherwise, apply compression_type to "
|
|
|
|
"all levels.");
|
|
|
|
|
2020-04-30 17:46:54 +00:00
|
|
|
DEFINE_int32(compression_parallel_threads, 1,
|
|
|
|
"Number of threads for parallel compression.");
|
2020-04-01 23:37:54 +00:00
|
|
|
|
Limit buffering for collecting samples for compression dictionary (#7970)
Summary:
For dictionary compression, we need to collect some representative samples of the data to be compressed, which we use to either generate or train (when `CompressionOptions::zstd_max_train_bytes > 0`) a dictionary. Previously, the strategy was to buffer all the data blocks during flush, and up to the target file size during compaction. That strategy allowed us to randomly pick samples from as wide a range as possible that'd be guaranteed to land in a single output file.
However, some users try to make huge files in memory-constrained environments, where this strategy can cause OOM. This PR introduces an option, `CompressionOptions::max_dict_buffer_bytes`, that limits how much data blocks are buffered before we switch to unbuffered mode (which means creating the per-SST dictionary, writing out the buffered data, and compressing/writing new blocks as soon as they are built). It is not strict as we currently buffer more than just data blocks -- also keys are buffered. But it does make a step towards giving users predictable memory usage.
Related changes include:
- Changed sampling for dictionary compression to select unique data blocks when there is limited availability of data blocks
- Made use of `BlockBuilder::SwapAndReset()` to save an allocation+memcpy when buffering data blocks for building a dictionary
- Changed `ParseBoolean()` to accept an input containing characters after the boolean. This is necessary since, with this PR, a value for `CompressionOptions::enabled` is no longer necessarily the final component in the `CompressionOptions` string.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/7970
Test Plan:
- updated `CompressionOptions` unit tests to verify limit is respected (to the extent expected in the current implementation) in various scenarios of flush/compaction to bottommost/non-bottommost level
- looked at jemalloc heap profiles right before and after switching to unbuffered mode during flush/compaction. Verified memory usage in buffering is proportional to the limit set.
Reviewed By: pdillinger
Differential Revision: D26467994
Pulled By: ajkr
fbshipit-source-id: 3da4ef9fba59974e4ef40e40c01611002c861465
2021-02-19 22:06:59 +00:00
|
|
|
DEFINE_uint64(compression_max_dict_buffer_bytes,
|
|
|
|
ROCKSDB_NAMESPACE::CompressionOptions().max_dict_buffer_bytes,
|
|
|
|
"Maximum bytes to buffer to collect samples for dictionary.");
|
|
|
|
|
Support using ZDICT_finalizeDictionary to generate zstd dictionary (#9857)
Summary:
An untrained dictionary is currently simply the concatenation of several samples. The ZSTD API, ZDICT_finalizeDictionary(), can improve such a dictionary's effectiveness at low cost. This PR changes how dictionary is created by calling the ZSTD ZDICT_finalizeDictionary() API instead of creating raw content dictionary (when max_dict_buffer_bytes > 0), and pass in all buffered uncompressed data blocks as samples.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9857
Test Plan:
#### db_bench test for cpu/memory of compression+decompression and space saving on synthetic data:
Set up: change the parameter [here](https://github.com/facebook/rocksdb/blob/fb9a167a55e0970b1ef6f67c1600c8d9c4c6114f/tools/db_bench_tool.cc#L1766) to 16384 to make synthetic data more compressible.
```
# linked local ZSTD with version 1.5.2
# DEBUG_LEVEL=0 ROCKSDB_NO_FBCODE=1 ROCKSDB_DISABLE_ZSTD=1 EXTRA_CXXFLAGS="-DZSTD_STATIC_LINKING_ONLY -DZSTD -I/data/users/changyubi/install/include/" EXTRA_LDFLAGS="-L/data/users/changyubi/install/lib/ -l:libzstd.a" make -j32 db_bench
dict_bytes=16384
train_bytes=1048576
echo "========== No Dictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=0 -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=0 -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
echo "========== Raw Content Dictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench_main -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench_main -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
echo "========== FinalizeDictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
echo "========== TrainDictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
# Result: TrainDictionary is much better on space saving, but FinalizeDictionary seems to use less memory.
# before compression data size: 1.2GB
dict_bytes=16384
max_dict_buffer_bytes = 1048576
space cpu/memory
No Dictionary 468M 14.93user 1.00system 0:15.92elapsed 100%CPU (0avgtext+0avgdata 23904maxresident)k
Raw Dictionary 251M 15.81user 0.80system 0:16.56elapsed 100%CPU (0avgtext+0avgdata 156808maxresident)k
FinalizeDictionary 236M 11.93user 0.64system 0:12.56elapsed 100%CPU (0avgtext+0avgdata 89548maxresident)k
TrainDictionary 84M 7.29user 0.45system 0:07.75elapsed 100%CPU (0avgtext+0avgdata 97288maxresident)k
```
#### Benchmark on 10 sample SST files for spacing saving and CPU time on compression:
FinalizeDictionary is comparable to TrainDictionary in terms of space saving, and takes less time in compression.
```
dict_bytes=16384
train_bytes=1048576
for sst_file in `ls ../temp/myrock-sst/`
do
echo "********** $sst_file **********"
echo "========== No Dictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD
echo "========== Raw Content Dictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD --compression_max_dict_bytes=$dict_bytes
echo "========== FinalizeDictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD --compression_max_dict_bytes=$dict_bytes --compression_zstd_max_train_bytes=$train_bytes --compression_use_zstd_finalize_dict
echo "========== TrainDictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD --compression_max_dict_bytes=$dict_bytes --compression_zstd_max_train_bytes=$train_bytes
done
010240.sst (Size/Time) 011029.sst 013184.sst 021552.sst 185054.sst 185137.sst 191666.sst 7560381.sst 7604174.sst 7635312.sst
No Dictionary 28165569 / 2614419 32899411 / 2976832 32977848 / 3055542 31966329 / 2004590 33614351 / 1755877 33429029 / 1717042 33611933 / 1776936 33634045 / 2771417 33789721 / 2205414 33592194 / 388254
Raw Content Dictionary 28019950 / 2697961 33748665 / 3572422 33896373 / 3534701 26418431 / 2259658 28560825 / 1839168 28455030 / 1846039 28494319 / 1861349 32391599 / 3095649 33772142 / 2407843 33592230 / 474523
FinalizeDictionary 27896012 / 2650029 33763886 / 3719427 33904283 / 3552793 26008225 / 2198033 28111872 / 1869530 28014374 / 1789771 28047706 / 1848300 32296254 / 3204027 33698698 / 2381468 33592344 / 517433
TrainDictionary 28046089 / 2740037 33706480 / 3679019 33885741 / 3629351 25087123 / 2204558 27194353 / 1970207 27234229 / 1896811 27166710 / 1903119 32011041 / 3322315 32730692 / 2406146 33608631 / 570593
```
#### Decompression/Read test:
With FinalizeDictionary/TrainDictionary, some data structure used for decompression are in stored in dictionary, so they are expected to be faster in terms of decompression/reads.
```
dict_bytes=16384
train_bytes=1048576
echo "No Dictionary"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=0 > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=0 2>&1 | grep MB/s
echo "Raw Dictionary"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes 2>&1 | grep MB/s
echo "FinalizeDict"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false 2>&1 | grep MB/s
echo "Train Dictionary"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes 2>&1 | grep MB/s
No Dictionary
readrandom : 12.183 micros/op 82082 ops/sec 12.183 seconds 1000000 operations; 9.1 MB/s (1000000 of 1000000 found)
Raw Dictionary
readrandom : 12.314 micros/op 81205 ops/sec 12.314 seconds 1000000 operations; 9.0 MB/s (1000000 of 1000000 found)
FinalizeDict
readrandom : 9.787 micros/op 102180 ops/sec 9.787 seconds 1000000 operations; 11.3 MB/s (1000000 of 1000000 found)
Train Dictionary
readrandom : 9.698 micros/op 103108 ops/sec 9.699 seconds 1000000 operations; 11.4 MB/s (1000000 of 1000000 found)
```
Reviewed By: ajkr
Differential Revision: D35720026
Pulled By: cbi42
fbshipit-source-id: 24d230fdff0fd28a1bb650658798f00dfcfb2a1f
2022-05-20 19:09:09 +00:00
|
|
|
DEFINE_bool(compression_use_zstd_dict_trainer,
|
|
|
|
ROCKSDB_NAMESPACE::CompressionOptions().use_zstd_dict_trainer,
|
|
|
|
"If true, use ZSTD_TrainDictionary() to create dictionary, else"
|
|
|
|
"use ZSTD_FinalizeDictionary() to create dictionary");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
static bool ValidateTableCacheNumshardbits(const char* flagname,
|
|
|
|
int32_t value) {
|
2021-03-29 17:31:58 +00:00
|
|
|
if (0 >= value || value >= 20) {
|
|
|
|
fprintf(stderr, "Invalid value for --%s: %d, must be 0 < val < 20\n",
|
2013-10-24 14:43:14 +00:00
|
|
|
flagname, value);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
DEFINE_int32(table_cache_numshardbits, 4, "");
|
2012-11-01 00:02:24 +00:00
|
|
|
|
2016-06-10 00:53:03 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2020-08-17 18:51:45 +00:00
|
|
|
DEFINE_string(env_uri, "",
|
2022-04-01 23:06:14 +00:00
|
|
|
"URI for registry Env lookup. Mutually exclusive with --fs_uri");
|
2020-08-17 18:51:45 +00:00
|
|
|
DEFINE_string(fs_uri, "",
|
|
|
|
"URI for registry Filesystem lookup. Mutually exclusive"
|
2022-01-25 03:56:37 +00:00
|
|
|
" with --env_uri."
|
2020-08-17 18:51:45 +00:00
|
|
|
" Creates a default environment with the specified filesystem.");
|
2016-06-10 00:53:03 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2021-05-03 20:30:00 +00:00
|
|
|
DEFINE_string(simulate_hybrid_fs_file, "",
|
|
|
|
"File for Store Metadata for Simulate hybrid FS. Empty means "
|
|
|
|
"disable the feature. Now, if it is set, "
|
2022-08-08 21:36:34 +00:00
|
|
|
"last_level_temperature is set to kWarm.");
|
2021-12-29 19:13:49 +00:00
|
|
|
DEFINE_int32(simulate_hybrid_hdd_multipliers, 1,
|
|
|
|
"In simulate_hybrid_fs_file or simulate_hdd mode, how many HDDs "
|
|
|
|
"are simulated.");
|
|
|
|
DEFINE_bool(simulate_hdd, false, "Simulate read/write latency on HDD.");
|
2019-10-22 18:42:00 +00:00
|
|
|
|
2022-08-08 20:08:35 +00:00
|
|
|
DEFINE_int64(
|
|
|
|
preclude_last_level_data_seconds, 0,
|
|
|
|
"Preclude the latest data from the last level. (Used for tiered storage)");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
static std::shared_ptr<ROCKSDB_NAMESPACE::Env> env_guard;
|
2019-10-22 18:42:00 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
static ROCKSDB_NAMESPACE::Env* FLAGS_env = ROCKSDB_NAMESPACE::Env::Default();
|
2012-06-08 08:11:14 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int64(stats_interval, 0, "Stats are reported every N operations when "
|
|
|
|
"this is greater than zero. When 0 the interval grows over time.");
|
2012-10-03 13:51:11 +00:00
|
|
|
|
2015-03-30 19:58:32 +00:00
|
|
|
DEFINE_int64(stats_interval_seconds, 0, "Report stats every N seconds. This "
|
|
|
|
"overrides stats_interval when both are > 0.");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_int32(stats_per_interval, 0, "Reports additional stats per interval when"
|
|
|
|
" this is greater than 0.");
|
2012-10-26 20:37:21 +00:00
|
|
|
|
2022-03-24 20:39:01 +00:00
|
|
|
DEFINE_uint64(slow_usecs, 1000000,
|
|
|
|
"A message is printed for operations that "
|
|
|
|
"take at least this many microseconds.");
|
|
|
|
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
DEFINE_int64(report_interval_seconds, 0,
|
2021-07-12 12:04:23 +00:00
|
|
|
"If greater than zero, it will write simple stats in CSV format "
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
"to --report_file every N seconds");
|
|
|
|
|
|
|
|
DEFINE_string(report_file, "report.csv",
|
|
|
|
"Filename where some simple stats are reported to (if "
|
|
|
|
"--report_interval_seconds is bigger than 0)");
|
|
|
|
|
2015-03-06 19:22:06 +00:00
|
|
|
DEFINE_int32(thread_status_per_interval, 0,
|
|
|
|
"Takes and report a snapshot of the current status of each thread"
|
|
|
|
" when this is greater than 0.");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_int32(perf_level, ROCKSDB_NAMESPACE::PerfLevel::kDisable,
|
|
|
|
"Level of perf collection");
|
2013-11-18 19:32:54 +00:00
|
|
|
|
2015-11-19 02:10:20 +00:00
|
|
|
DEFINE_uint64(soft_pending_compaction_bytes_limit, 64ull * 1024 * 1024 * 1024,
|
|
|
|
"Slowdown writes if pending compaction bytes exceed this number");
|
|
|
|
|
2015-11-06 19:34:06 +00:00
|
|
|
DEFINE_uint64(hard_pending_compaction_bytes_limit, 128ull * 1024 * 1024 * 1024,
|
2015-09-11 21:31:23 +00:00
|
|
|
"Stop writes if pending compaction bytes exceed this number");
|
2012-10-26 20:37:21 +00:00
|
|
|
|
2015-12-23 21:49:53 +00:00
|
|
|
DEFINE_uint64(delayed_write_rate, 8388608u,
|
2015-05-15 22:52:51 +00:00
|
|
|
"Limited bytes allowed to DB when soft_rate_limit or "
|
|
|
|
"level0_slowdown_writes_trigger triggers");
|
|
|
|
|
2017-06-30 22:21:02 +00:00
|
|
|
DEFINE_bool(enable_pipelined_write, true,
|
|
|
|
"Allow WAL and memtable writes to be pipelined");
|
|
|
|
|
2020-03-02 23:31:56 +00:00
|
|
|
DEFINE_bool(
|
|
|
|
unordered_write, false,
|
|
|
|
"Enable the unordered write feature, which provides higher throughput but "
|
|
|
|
"relaxes the guarantees around atomic reads and immutable snapshots");
|
2019-05-14 00:43:47 +00:00
|
|
|
|
2017-06-30 22:21:02 +00:00
|
|
|
DEFINE_bool(allow_concurrent_memtable_write, true,
|
support for concurrent adds to memtable
Summary:
This diff adds support for concurrent adds to the skiplist memtable
implementations. Memory allocation is made thread-safe by the addition of
a spinlock, with small per-core buffers to avoid contention. Concurrent
memtable writes are made via an additional method and don't impose a
performance overhead on the non-concurrent case, so parallelism can be
selected on a per-batch basis.
Write thread synchronization is an increasing bottleneck for higher levels
of concurrency, so this diff adds --enable_write_thread_adaptive_yield
(default off). This feature causes threads joining a write batch
group to spin for a short time (default 100 usec) using sched_yield,
rather than going to sleep on a mutex. If the timing of the yield calls
indicates that another thread has actually run during the yield then
spinning is avoided. This option improves performance for concurrent
situations even without parallel adds, although it has the potential to
increase CPU usage (and the heuristic adaptation is not yet mature).
Parallel writes are not currently compatible with
inplace updates, update callbacks, or delete filtering.
Enable it with --allow_concurrent_memtable_write (and
--enable_write_thread_adaptive_yield). Parallel memtable writes
are performance neutral when there is no actual parallelism, and in
my experiments (SSD server-class Linux and varying contention and key
sizes for fillrandom) they are always a performance win when there is
more than one thread.
Statistics are updated earlier in the write path, dropping the number
of DB mutex acquisitions from 2 to 1 for almost all cases.
This diff was motivated and inspired by Yahoo's cLSM work. It is more
conservative than cLSM: RocksDB's write batch group leader role is
preserved (along with all of the existing flush and write throttling
logic) and concurrent writers are blocked until all memtable insertions
have completed and the sequence number has been advanced, to preserve
linearizability.
My test config is "db_bench -benchmarks=fillrandom -threads=$T
-batch_size=1 -memtablerep=skip_list -value_size=100 --num=1000000/$T
-level0_slowdown_writes_trigger=9999 -level0_stop_writes_trigger=9999
-disable_auto_compactions --max_write_buffer_number=8
-max_background_flushes=8 --disable_wal --write_buffer_size=160000000
--block_size=16384 --allow_concurrent_memtable_write" on a two-socket
Xeon E5-2660 @ 2.2Ghz with lots of memory and an SSD hard drive. With 1
thread I get ~440Kops/sec. Peak performance for 1 socket (numactl
-N1) is slightly more than 1Mops/sec, at 16 threads. Peak performance
across both sockets happens at 30 threads, and is ~900Kops/sec, although
with fewer threads there is less performance loss when the system has
background work.
Test Plan:
1. concurrent stress tests for InlineSkipList and DynamicBloom
2. make clean; make check
3. make clean; DISABLE_JEMALLOC=1 make valgrind_check; valgrind db_bench
4. make clean; COMPILE_WITH_TSAN=1 make all check; db_bench
5. make clean; COMPILE_WITH_ASAN=1 make all check; db_bench
6. make clean; OPT=-DROCKSDB_LITE make check
7. verify no perf regressions when disabled
Reviewers: igor, sdong
Reviewed By: sdong
Subscribers: MarkCallaghan, IslamAbdelRahman, anthony, yhchiang, rven, sdong, guyg8, kradhakrishnan, dhruba
Differential Revision: https://reviews.facebook.net/D50589
2015-08-14 23:59:07 +00:00
|
|
|
"Allow multi-writers to update mem tables in parallel.");
|
|
|
|
|
2021-08-11 01:07:48 +00:00
|
|
|
DEFINE_double(experimental_mempurge_threshold, 0.0,
|
|
|
|
"Maximum useful payload ratio estimate that triggers a mempurge "
|
|
|
|
"(memtable garbage collection).");
|
Add simple heuristics for experimental mempurge. (#8583)
Summary:
Add `experimental_mempurge_policy` option flag and introduce two new `MemPurge` (Memtable Garbage Collection) policies: 'ALWAYS' and 'ALTERNATE'. Default value: ALTERNATE.
`ALWAYS`: every flush will first go through a `MemPurge` process. If the output is too big to fit into a single memtable, then the mempurge is aborted and a regular flush process carries on. `ALWAYS` is designed for user that need to reduce the number of L0 SST file created to a strict minimum, and can afford a small dent in performance (possibly hits to CPU usage, read efficiency, and maximum burst write throughput).
`ALTERNATE`: a flush is transformed into a `MemPurge` except if one of the memtables being flushed is the product of a previous `MemPurge`. `ALTERNATE` is a good tradeoff between reduction in number of L0 SST files created and performance. `ALTERNATE` perform particularly well for completely random garbage ratios, or garbage ratios anywhere in (0%,50%], and even higher when there is a wild variability in garbage ratios.
This PR also includes support for `experimental_mempurge_policy` in `db_bench`.
Testing was done locally by replacing all the `MemPurge` policies of the unit tests with `ALTERNATE`, as well as local testing with `db_crashtest.py` `whitebox` and `blackbox`. Overall, if an `ALWAYS` mempurge policy passes the tests, there is no reasons why an `ALTERNATE` policy would fail, and therefore the mempurge policy was set to `ALWAYS` for all mempurge unit tests.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8583
Reviewed By: pdillinger
Differential Revision: D29888050
Pulled By: bjlemaire
fbshipit-source-id: e2cf26646d66679f6f5fb29842624615610759c1
2021-07-26 18:55:27 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(inplace_update_support,
|
|
|
|
ROCKSDB_NAMESPACE::Options().inplace_update_support,
|
2018-01-26 18:46:30 +00:00
|
|
|
"Support in-place memtable update for smaller or same-size values");
|
|
|
|
|
|
|
|
DEFINE_uint64(inplace_update_num_locks,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().inplace_update_num_locks,
|
2018-01-26 18:46:30 +00:00
|
|
|
"Number of RW locks to protect in-place memtable updates");
|
|
|
|
|
2017-06-30 22:21:02 +00:00
|
|
|
DEFINE_bool(enable_write_thread_adaptive_yield, true,
|
support for concurrent adds to memtable
Summary:
This diff adds support for concurrent adds to the skiplist memtable
implementations. Memory allocation is made thread-safe by the addition of
a spinlock, with small per-core buffers to avoid contention. Concurrent
memtable writes are made via an additional method and don't impose a
performance overhead on the non-concurrent case, so parallelism can be
selected on a per-batch basis.
Write thread synchronization is an increasing bottleneck for higher levels
of concurrency, so this diff adds --enable_write_thread_adaptive_yield
(default off). This feature causes threads joining a write batch
group to spin for a short time (default 100 usec) using sched_yield,
rather than going to sleep on a mutex. If the timing of the yield calls
indicates that another thread has actually run during the yield then
spinning is avoided. This option improves performance for concurrent
situations even without parallel adds, although it has the potential to
increase CPU usage (and the heuristic adaptation is not yet mature).
Parallel writes are not currently compatible with
inplace updates, update callbacks, or delete filtering.
Enable it with --allow_concurrent_memtable_write (and
--enable_write_thread_adaptive_yield). Parallel memtable writes
are performance neutral when there is no actual parallelism, and in
my experiments (SSD server-class Linux and varying contention and key
sizes for fillrandom) they are always a performance win when there is
more than one thread.
Statistics are updated earlier in the write path, dropping the number
of DB mutex acquisitions from 2 to 1 for almost all cases.
This diff was motivated and inspired by Yahoo's cLSM work. It is more
conservative than cLSM: RocksDB's write batch group leader role is
preserved (along with all of the existing flush and write throttling
logic) and concurrent writers are blocked until all memtable insertions
have completed and the sequence number has been advanced, to preserve
linearizability.
My test config is "db_bench -benchmarks=fillrandom -threads=$T
-batch_size=1 -memtablerep=skip_list -value_size=100 --num=1000000/$T
-level0_slowdown_writes_trigger=9999 -level0_stop_writes_trigger=9999
-disable_auto_compactions --max_write_buffer_number=8
-max_background_flushes=8 --disable_wal --write_buffer_size=160000000
--block_size=16384 --allow_concurrent_memtable_write" on a two-socket
Xeon E5-2660 @ 2.2Ghz with lots of memory and an SSD hard drive. With 1
thread I get ~440Kops/sec. Peak performance for 1 socket (numactl
-N1) is slightly more than 1Mops/sec, at 16 threads. Peak performance
across both sockets happens at 30 threads, and is ~900Kops/sec, although
with fewer threads there is less performance loss when the system has
background work.
Test Plan:
1. concurrent stress tests for InlineSkipList and DynamicBloom
2. make clean; make check
3. make clean; DISABLE_JEMALLOC=1 make valgrind_check; valgrind db_bench
4. make clean; COMPILE_WITH_TSAN=1 make all check; db_bench
5. make clean; COMPILE_WITH_ASAN=1 make all check; db_bench
6. make clean; OPT=-DROCKSDB_LITE make check
7. verify no perf regressions when disabled
Reviewers: igor, sdong
Reviewed By: sdong
Subscribers: MarkCallaghan, IslamAbdelRahman, anthony, yhchiang, rven, sdong, guyg8, kradhakrishnan, dhruba
Differential Revision: https://reviews.facebook.net/D50589
2015-08-14 23:59:07 +00:00
|
|
|
"Use a yielding spin loop for brief writer thread waits.");
|
|
|
|
|
|
|
|
DEFINE_uint64(
|
|
|
|
write_thread_max_yield_usec, 100,
|
|
|
|
"Maximum microseconds for enable_write_thread_adaptive_yield operation.");
|
|
|
|
|
|
|
|
DEFINE_uint64(write_thread_slow_yield_usec, 3,
|
|
|
|
"The threshold at which a slow yield is considered a signal that "
|
|
|
|
"other processes or threads want the core.");
|
|
|
|
|
2015-05-13 00:40:27 +00:00
|
|
|
DEFINE_uint64(rate_limiter_bytes_per_sec, 0, "Set options.rate_limiter value.");
|
|
|
|
|
Simplify GenericRateLimiter algorithm (#8602)
Summary:
`GenericRateLimiter` slow path handles requests that cannot be satisfied
immediately. Such requests enter a queue, and their thread stays in `Request()`
until they are granted or the rate limiter is stopped. These threads are
responsible for unblocking themselves. The work to do so is split into two main
duties.
(1) Waiting for the next refill time.
(2) Refilling the bytes and granting requests.
Prior to this PR, the slow path logic involved a leader election algorithm to
pick one thread to perform (1) followed by (2). It elected the thread whose
request was at the front of the highest priority non-empty queue since that
request was most likely to be granted. This algorithm was efficient in terms of
reducing intermediate wakeups, which is a thread waking up only to resume
waiting after finding its request is not granted. However, the conceptual
complexity of this algorithm was too high. It took me a long time to draw a
timeline to understand how it works for just one edge case yet there were so
many.
This PR drops the leader election to reduce conceptual complexity. Now, the two
duties can be performed by whichever thread acquires the lock first. The risk
of this change is increasing the number of intermediate wakeups, however, we
took steps to mitigate that.
- `wait_until_refill_pending_` flag ensures only one thread performs (1). This\
prevents the thundering herd problem at the next refill time. The remaining\
threads wait on their condition variable with an unbounded duration -- thus we\
must remember to notify them to ensure forward progress.
- (1) is typically done by a thread at the front of a queue. This is trivial\
when the queues are initially empty as the first choice that arrives must be\
the only entry in its queue. When queues are initially non-empty, we achieve\
this by having (2) notify a thread at the front of a queue (preferring higher\
priority) to perform the next duty.
- We do not require any additional wakeup for (2). Typically it will just be\
done by the thread that finished (1).
Combined, the second and third bullet points above suggest the refill/granting
will typically be done by a request at the front of its queue. This is
important because one wakeup is saved when a granted request happens to be in an
already running thread.
Note there are a few cases that still lead to intermediate wakeup, however. The
first two are existing issues that also apply to the old algorithm, however, the
third (including both subpoints) is new.
- No request may be granted (only possible when rate limit dynamically\
decreases).
- Requests from a different queue may be granted.
- (2) may be run by a non-front request thread causing it to not be granted even\
if some requests in that same queue are granted. It can happen for a couple\
(unlikely) reasons.
- A new request may sneak in and grab the lock at the refill time, before the\
thread finishing (1) can wake up and grab it.
- A new request may sneak in and grab the lock and execute (1) before (2)'s\
chosen candidate can wake up and grab the lock. Then that non-front request\
thread performing (1) can carry over to perform (2).
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8602
Test Plan:
- Use existing tests. The edge cases listed in the comment are all performance\
related; I could not really think of any related to correctness. The logic\
looks the same whether a thread wakes up/finishes its work early/on-time/late,\
or whether the thread is chosen vs. "steals" the work.
- Verified write throughput and CPU overhead are basically the same with and\
without this change, even in a rate limiter heavy workload:
Test command:
```
$ rm -rf /dev/shm/dbbench/ && TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -benchmarks=fillrandom -num_multi_db=64 -num_low_pri_threads=64 -num_high_pri_threads=64 -write_buffer_size=262144 -target_file_size_base=262144 -max_bytes_for_level_base=1048576 -rate_limiter_bytes_per_sec=16777216 -key_size=24 -value_size=1000 -num=10000 -compression_type=none -rate_limiter_refill_period_us=1000
```
Results before this PR:
```
fillrandom : 108.463 micros/op 9219 ops/sec; 9.0 MB/s
7.40user 8.84system 1:26.20elapsed 18%CPU (0avgtext+0avgdata 256140maxresident)k
```
Results after this PR:
```
fillrandom : 108.108 micros/op 9250 ops/sec; 9.0 MB/s
7.45user 8.23system 1:26.68elapsed 18%CPU (0avgtext+0avgdata 255688maxresident)k
```
Reviewed By: hx235
Differential Revision: D30048013
Pulled By: ajkr
fbshipit-source-id: 6741bba9d9dfbccab359806d725105817fef818b
2021-08-09 23:46:14 +00:00
|
|
|
DEFINE_int64(rate_limiter_refill_period_us, 100 * 1000,
|
2022-04-01 23:06:14 +00:00
|
|
|
"Set refill period on rate limiter.");
|
Simplify GenericRateLimiter algorithm (#8602)
Summary:
`GenericRateLimiter` slow path handles requests that cannot be satisfied
immediately. Such requests enter a queue, and their thread stays in `Request()`
until they are granted or the rate limiter is stopped. These threads are
responsible for unblocking themselves. The work to do so is split into two main
duties.
(1) Waiting for the next refill time.
(2) Refilling the bytes and granting requests.
Prior to this PR, the slow path logic involved a leader election algorithm to
pick one thread to perform (1) followed by (2). It elected the thread whose
request was at the front of the highest priority non-empty queue since that
request was most likely to be granted. This algorithm was efficient in terms of
reducing intermediate wakeups, which is a thread waking up only to resume
waiting after finding its request is not granted. However, the conceptual
complexity of this algorithm was too high. It took me a long time to draw a
timeline to understand how it works for just one edge case yet there were so
many.
This PR drops the leader election to reduce conceptual complexity. Now, the two
duties can be performed by whichever thread acquires the lock first. The risk
of this change is increasing the number of intermediate wakeups, however, we
took steps to mitigate that.
- `wait_until_refill_pending_` flag ensures only one thread performs (1). This\
prevents the thundering herd problem at the next refill time. The remaining\
threads wait on their condition variable with an unbounded duration -- thus we\
must remember to notify them to ensure forward progress.
- (1) is typically done by a thread at the front of a queue. This is trivial\
when the queues are initially empty as the first choice that arrives must be\
the only entry in its queue. When queues are initially non-empty, we achieve\
this by having (2) notify a thread at the front of a queue (preferring higher\
priority) to perform the next duty.
- We do not require any additional wakeup for (2). Typically it will just be\
done by the thread that finished (1).
Combined, the second and third bullet points above suggest the refill/granting
will typically be done by a request at the front of its queue. This is
important because one wakeup is saved when a granted request happens to be in an
already running thread.
Note there are a few cases that still lead to intermediate wakeup, however. The
first two are existing issues that also apply to the old algorithm, however, the
third (including both subpoints) is new.
- No request may be granted (only possible when rate limit dynamically\
decreases).
- Requests from a different queue may be granted.
- (2) may be run by a non-front request thread causing it to not be granted even\
if some requests in that same queue are granted. It can happen for a couple\
(unlikely) reasons.
- A new request may sneak in and grab the lock at the refill time, before the\
thread finishing (1) can wake up and grab it.
- A new request may sneak in and grab the lock and execute (1) before (2)'s\
chosen candidate can wake up and grab the lock. Then that non-front request\
thread performing (1) can carry over to perform (2).
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8602
Test Plan:
- Use existing tests. The edge cases listed in the comment are all performance\
related; I could not really think of any related to correctness. The logic\
looks the same whether a thread wakes up/finishes its work early/on-time/late,\
or whether the thread is chosen vs. "steals" the work.
- Verified write throughput and CPU overhead are basically the same with and\
without this change, even in a rate limiter heavy workload:
Test command:
```
$ rm -rf /dev/shm/dbbench/ && TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -benchmarks=fillrandom -num_multi_db=64 -num_low_pri_threads=64 -num_high_pri_threads=64 -write_buffer_size=262144 -target_file_size_base=262144 -max_bytes_for_level_base=1048576 -rate_limiter_bytes_per_sec=16777216 -key_size=24 -value_size=1000 -num=10000 -compression_type=none -rate_limiter_refill_period_us=1000
```
Results before this PR:
```
fillrandom : 108.463 micros/op 9219 ops/sec; 9.0 MB/s
7.40user 8.84system 1:26.20elapsed 18%CPU (0avgtext+0avgdata 256140maxresident)k
```
Results after this PR:
```
fillrandom : 108.108 micros/op 9250 ops/sec; 9.0 MB/s
7.45user 8.23system 1:26.68elapsed 18%CPU (0avgtext+0avgdata 255688maxresident)k
```
Reviewed By: hx235
Differential Revision: D30048013
Pulled By: ajkr
fbshipit-source-id: 6741bba9d9dfbccab359806d725105817fef818b
2021-08-09 23:46:14 +00:00
|
|
|
|
2017-10-05 02:02:22 +00:00
|
|
|
DEFINE_bool(rate_limiter_auto_tuned, false,
|
|
|
|
"Enable dynamic adjustment of rate limit according to demand for "
|
|
|
|
"background I/O");
|
|
|
|
|
2018-06-15 19:07:38 +00:00
|
|
|
|
|
|
|
DEFINE_bool(sine_write_rate, false,
|
|
|
|
"Use a sine wave write_rate_limit");
|
|
|
|
|
|
|
|
DEFINE_uint64(sine_write_rate_interval_milliseconds, 10000,
|
|
|
|
"Interval of which the sine wave write_rate_limit is recalculated");
|
|
|
|
|
|
|
|
DEFINE_double(sine_a, 1,
|
|
|
|
"A in f(x) = A sin(bx + c) + d");
|
|
|
|
|
|
|
|
DEFINE_double(sine_b, 1,
|
|
|
|
"B in f(x) = A sin(bx + c) + d");
|
|
|
|
|
|
|
|
DEFINE_double(sine_c, 0,
|
|
|
|
"C in f(x) = A sin(bx + c) + d");
|
|
|
|
|
|
|
|
DEFINE_double(sine_d, 1,
|
|
|
|
"D in f(x) = A sin(bx + c) + d");
|
|
|
|
|
2017-06-13 21:51:22 +00:00
|
|
|
DEFINE_bool(rate_limit_bg_reads, false,
|
|
|
|
"Use options.rate_limiter on compaction reads");
|
|
|
|
|
2015-06-17 23:44:52 +00:00
|
|
|
DEFINE_uint64(
|
|
|
|
benchmark_write_rate_limit, 0,
|
2016-01-04 20:01:27 +00:00
|
|
|
"If non-zero, db_bench will rate-limit the writes going into RocksDB. This "
|
|
|
|
"is the global rate in bytes/second.");
|
2015-06-17 23:44:52 +00:00
|
|
|
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
// the parameters of mix_graph
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
DEFINE_double(keyrange_dist_a, 0.0,
|
|
|
|
"The parameter 'a' of prefix average access distribution "
|
|
|
|
"f(x)=a*exp(b*x)+c*exp(d*x)");
|
|
|
|
DEFINE_double(keyrange_dist_b, 0.0,
|
|
|
|
"The parameter 'b' of prefix average access distribution "
|
|
|
|
"f(x)=a*exp(b*x)+c*exp(d*x)");
|
|
|
|
DEFINE_double(keyrange_dist_c, 0.0,
|
|
|
|
"The parameter 'c' of prefix average access distribution"
|
|
|
|
"f(x)=a*exp(b*x)+c*exp(d*x)");
|
|
|
|
DEFINE_double(keyrange_dist_d, 0.0,
|
|
|
|
"The parameter 'd' of prefix average access distribution"
|
|
|
|
"f(x)=a*exp(b*x)+c*exp(d*x)");
|
|
|
|
DEFINE_int64(keyrange_num, 1,
|
|
|
|
"The number of key ranges that are in the same prefix "
|
2022-04-01 23:06:14 +00:00
|
|
|
"group, each prefix range will have its key access distribution");
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
DEFINE_double(key_dist_a, 0.0,
|
2022-04-01 23:06:14 +00:00
|
|
|
"The parameter 'a' of key access distribution model f(x)=a*x^b");
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
DEFINE_double(key_dist_b, 0.0,
|
2022-04-01 23:06:14 +00:00
|
|
|
"The parameter 'b' of key access distribution model f(x)=a*x^b");
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
DEFINE_double(value_theta, 0.0,
|
|
|
|
"The parameter 'theta' of Generized Pareto Distribution "
|
|
|
|
"f(x)=(1/sigma)*(1+k*(x-theta)/sigma)^-(1/k+1)");
|
2022-03-22 00:30:51 +00:00
|
|
|
// Use reasonable defaults based on the mixgraph paper
|
|
|
|
DEFINE_double(value_k, 0.2615,
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
"The parameter 'k' of Generized Pareto Distribution "
|
|
|
|
"f(x)=(1/sigma)*(1+k*(x-theta)/sigma)^-(1/k+1)");
|
2022-03-22 00:30:51 +00:00
|
|
|
// Use reasonable defaults based on the mixgraph paper
|
|
|
|
DEFINE_double(value_sigma, 25.45,
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
"The parameter 'theta' of Generized Pareto Distribution "
|
|
|
|
"f(x)=(1/sigma)*(1+k*(x-theta)/sigma)^-(1/k+1)");
|
|
|
|
DEFINE_double(iter_theta, 0.0,
|
|
|
|
"The parameter 'theta' of Generized Pareto Distribution "
|
|
|
|
"f(x)=(1/sigma)*(1+k*(x-theta)/sigma)^-(1/k+1)");
|
2022-03-22 00:30:51 +00:00
|
|
|
// Use reasonable defaults based on the mixgraph paper
|
|
|
|
DEFINE_double(iter_k, 2.517,
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
"The parameter 'k' of Generized Pareto Distribution "
|
|
|
|
"f(x)=(1/sigma)*(1+k*(x-theta)/sigma)^-(1/k+1)");
|
2022-03-22 00:30:51 +00:00
|
|
|
// Use reasonable defaults based on the mixgraph paper
|
|
|
|
DEFINE_double(iter_sigma, 14.236,
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
"The parameter 'sigma' of Generized Pareto Distribution "
|
|
|
|
"f(x)=(1/sigma)*(1+k*(x-theta)/sigma)^-(1/k+1)");
|
|
|
|
DEFINE_double(mix_get_ratio, 1.0,
|
|
|
|
"The ratio of Get queries of mix_graph workload");
|
|
|
|
DEFINE_double(mix_put_ratio, 0.0,
|
|
|
|
"The ratio of Put queries of mix_graph workload");
|
|
|
|
DEFINE_double(mix_seek_ratio, 0.0,
|
|
|
|
"The ratio of Seek queries of mix_graph workload");
|
|
|
|
DEFINE_int64(mix_max_scan_len, 10000, "The max scan length of Iterator");
|
|
|
|
DEFINE_int64(mix_max_value_size, 1024, "The max value size of this workload");
|
|
|
|
DEFINE_double(
|
|
|
|
sine_mix_rate_noise, 0.0,
|
|
|
|
"Add the noise ratio to the sine rate, it is between 0.0 and 1.0");
|
|
|
|
DEFINE_bool(sine_mix_rate, false,
|
|
|
|
"Enable the sine QPS control on the mix workload");
|
|
|
|
DEFINE_uint64(
|
|
|
|
sine_mix_rate_interval_milliseconds, 10000,
|
|
|
|
"Interval of which the sine wave read_rate_limit is recalculated");
|
|
|
|
DEFINE_int64(mix_accesses, -1,
|
|
|
|
"The total query accesses of mix_graph workload");
|
|
|
|
|
2016-12-19 20:25:35 +00:00
|
|
|
DEFINE_uint64(
|
|
|
|
benchmark_read_rate_limit, 0,
|
|
|
|
"If non-zero, db_bench will rate-limit the reads from RocksDB. This "
|
|
|
|
"is the global rate in ops/second.");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_uint64(max_compaction_bytes,
|
|
|
|
ROCKSDB_NAMESPACE::Options().max_compaction_bytes,
|
2016-06-16 23:02:52 +00:00
|
|
|
"Max bytes allowed in one compaction");
|
2012-11-14 17:10:46 +00:00
|
|
|
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(readonly, false, "Run read only benchmarks.");
|
2018-10-25 03:13:06 +00:00
|
|
|
|
|
|
|
DEFINE_bool(print_malloc_stats, false,
|
|
|
|
"Print malloc stats to stdout after benchmarks finish.");
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2012-11-06 03:18:49 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_bool(disable_auto_compactions, false, "Do not auto trigger compactions");
|
2012-11-20 23:45:41 +00:00
|
|
|
|
2013-11-07 02:46:28 +00:00
|
|
|
DEFINE_uint64(wal_ttl_seconds, 0, "Set the TTL for the WAL Files in seconds.");
|
|
|
|
DEFINE_uint64(wal_size_limit_MB, 0, "Set the size limit for the WAL Files"
|
|
|
|
" in MB.");
|
2014-12-23 02:39:28 +00:00
|
|
|
DEFINE_uint64(max_total_wal_size, 0, "Set total max WAL size");
|
2012-11-26 21:56:45 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(mmap_read, ROCKSDB_NAMESPACE::Options().allow_mmap_reads,
|
2013-10-24 14:43:14 +00:00
|
|
|
"Allow reads to occur via mmap-ing files");
|
2013-03-15 00:00:04 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(mmap_write, ROCKSDB_NAMESPACE::Options().allow_mmap_writes,
|
2013-10-24 14:43:14 +00:00
|
|
|
"Allow writes to occur via mmap-ing files");
|
2013-03-15 00:00:04 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(use_direct_reads, ROCKSDB_NAMESPACE::Options().use_direct_reads,
|
2016-10-28 17:36:05 +00:00
|
|
|
"Use O_DIRECT for reading data");
|
|
|
|
|
2017-04-13 20:07:33 +00:00
|
|
|
DEFINE_bool(use_direct_io_for_flush_and_compaction,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().use_direct_io_for_flush_and_compaction,
|
2018-05-10 02:26:43 +00:00
|
|
|
"Use O_DIRECT for background flush and compaction writes");
|
2016-12-22 20:51:29 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(advise_random_on_open,
|
|
|
|
ROCKSDB_NAMESPACE::Options().advise_random_on_open,
|
2013-10-24 14:43:14 +00:00
|
|
|
"Advise random access on table file open");
|
2013-05-17 22:53:01 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_string(compaction_fadvice, "NORMAL",
|
|
|
|
"Access pattern advice when a file is compacted");
|
|
|
|
static auto FLAGS_compaction_fadvice_e =
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().access_hint_on_compaction_start;
|
2013-05-17 22:53:01 +00:00
|
|
|
|
2014-02-07 17:47:47 +00:00
|
|
|
DEFINE_bool(use_tailing_iterator, false,
|
|
|
|
"Use tailing iterator to access a series of keys instead of get");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(use_adaptive_mutex, ROCKSDB_NAMESPACE::Options().use_adaptive_mutex,
|
2013-10-24 14:43:14 +00:00
|
|
|
"Use adaptive mutex");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_uint64(bytes_per_sync, ROCKSDB_NAMESPACE::Options().bytes_per_sync,
|
2015-05-19 23:19:30 +00:00
|
|
|
"Allows OS to incrementally sync SST files to disk while they are"
|
2013-10-24 14:43:14 +00:00
|
|
|
" being written, in the background. Issue one request for every"
|
|
|
|
" bytes_per_sync written. 0 turns it off.");
|
2015-05-19 23:19:30 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_uint64(wal_bytes_per_sync,
|
|
|
|
ROCKSDB_NAMESPACE::Options().wal_bytes_per_sync,
|
2015-05-19 23:19:30 +00:00
|
|
|
"Allows OS to incrementally sync WAL files to disk while they are"
|
|
|
|
" being written, in the background. Issue one request for every"
|
|
|
|
" wal_bytes_per_sync written. 0 turns it off.");
|
|
|
|
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
DEFINE_bool(use_single_deletes, true,
|
|
|
|
"Use single deletes (used in RandomReplaceKeys only).");
|
|
|
|
|
|
|
|
DEFINE_double(stddev, 2000.0,
|
|
|
|
"Standard deviation of normal distribution used for picking keys"
|
|
|
|
" (used in RandomReplaceKeys only).");
|
|
|
|
|
2016-08-01 19:28:51 +00:00
|
|
|
DEFINE_int32(key_id_range, 100000,
|
|
|
|
"Range of possible value of key id (used in TimeSeries only).");
|
|
|
|
|
|
|
|
DEFINE_string(expire_style, "none",
|
|
|
|
"Style to remove expired time entries. Can be one of the options "
|
|
|
|
"below: none (do not expired data), compaction_filter (use a "
|
|
|
|
"compaction filter to remove expired data), delete (seek IDs and "
|
|
|
|
"remove expired data) (used in TimeSeries only).");
|
|
|
|
|
|
|
|
DEFINE_uint64(
|
|
|
|
time_range, 100000,
|
|
|
|
"Range of timestamp that store in the database (used in TimeSeries"
|
|
|
|
" only).");
|
|
|
|
|
|
|
|
DEFINE_int32(num_deletion_threads, 1,
|
|
|
|
"Number of threads to do deletion (used in TimeSeries and delete "
|
|
|
|
"expire_style only).");
|
|
|
|
|
2014-01-11 01:33:56 +00:00
|
|
|
DEFINE_int32(max_successive_merges, 0, "Maximum number of successive merge"
|
|
|
|
" operations on a key in the memtable");
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
static bool ValidatePrefixSize(const char* flagname, int32_t value) {
|
|
|
|
if (value < 0 || value>=2000000000) {
|
|
|
|
fprintf(stderr, "Invalid value for --%s: %d. 0<= PrefixSize <=2000000000\n",
|
|
|
|
flagname, value);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
2019-04-15 17:49:47 +00:00
|
|
|
|
2014-02-12 18:41:55 +00:00
|
|
|
DEFINE_int32(prefix_size, 0, "control the prefix size for HashSkipList and "
|
|
|
|
"plain table");
|
2014-03-05 01:08:05 +00:00
|
|
|
DEFINE_int64(keys_per_prefix, 0, "control average number of keys generated "
|
|
|
|
"per prefix, 0 means no special handling of the prefix, "
|
|
|
|
"i.e. use the prefix comes with the generated random number.");
|
2019-04-15 17:49:47 +00:00
|
|
|
DEFINE_bool(total_order_seek, false,
|
|
|
|
"Enable total order seek regardless of index format.");
|
|
|
|
DEFINE_bool(prefix_same_as_start, false,
|
|
|
|
"Enforce iterator to return keys with prefix same as seek key.");
|
|
|
|
DEFINE_bool(
|
|
|
|
seek_missing_prefix, false,
|
|
|
|
"Iterator seek to keys with non-exist prefixes. Require prefix_size > 8");
|
|
|
|
|
2016-12-02 00:50:59 +00:00
|
|
|
DEFINE_int32(memtable_insert_with_hint_prefix_size, 0,
|
|
|
|
"If non-zero, enable "
|
|
|
|
"memtable insert with hint with the given prefix size.");
|
2014-08-14 03:49:58 +00:00
|
|
|
DEFINE_bool(enable_io_prio, false, "Lower the background flush/compaction "
|
|
|
|
"threads' IO priority");
|
2018-04-24 15:38:01 +00:00
|
|
|
DEFINE_bool(enable_cpu_prio, false, "Lower the background flush/compaction "
|
|
|
|
"threads' CPU priority");
|
CuckooTable: add one option to allow identity function for the first hash function
Summary:
MurmurHash becomes expensive when we do millions Get() a second in one
thread. Add this option to allow the first hash function to use identity
function as hash function. It results in QPS increase from 3.7M/s to
~4.3M/s. I did not observe improvement for end to end RocksDB
performance. This may be caused by other bottlenecks that I will address
in a separate diff.
Test Plan:
```
[ljin@dev1964 rocksdb] ./cuckoo_table_reader_test --enable_perf --file_dir=/dev/shm --write --identity_as_first_hash=0
==== Test CuckooReaderTest.WhenKeyExists
==== Test CuckooReaderTest.WhenKeyExistsWithUint64Comparator
==== Test CuckooReaderTest.CheckIterator
==== Test CuckooReaderTest.CheckIteratorUint64
==== Test CuckooReaderTest.WhenKeyNotFound
==== Test CuckooReaderTest.TestReadPerformance
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.272us (3.7 Mqps) with batch size of 0, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.138us (7.2 Mqps) with batch size of 10, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.142us (7.1 Mqps) with batch size of 25, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.142us (7.0 Mqps) with batch size of 50, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.144us (6.9 Mqps) with batch size of 100, # of found keys 125829120
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.201us (5.0 Mqps) with batch size of 0, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.121us (8.3 Mqps) with batch size of 10, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.123us (8.1 Mqps) with batch size of 25, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.121us (8.3 Mqps) with batch size of 50, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.112us (8.9 Mqps) with batch size of 100, # of found keys 104857600
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.251us (4.0 Mqps) with batch size of 0, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.107us (9.4 Mqps) with batch size of 10, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.099us (10.1 Mqps) with batch size of 25, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.100us (10.0 Mqps) with batch size of 50, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.116us (8.6 Mqps) with batch size of 100, # of found keys 83886080
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.189us (5.3 Mqps) with batch size of 0, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.095us (10.5 Mqps) with batch size of 10, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.096us (10.4 Mqps) with batch size of 25, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.098us (10.2 Mqps) with batch size of 50, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.105us (9.5 Mqps) with batch size of 100, # of found keys 73400320
[ljin@dev1964 rocksdb] ./cuckoo_table_reader_test --enable_perf --file_dir=/dev/shm --write --identity_as_first_hash=1
==== Test CuckooReaderTest.WhenKeyExists
==== Test CuckooReaderTest.WhenKeyExistsWithUint64Comparator
==== Test CuckooReaderTest.CheckIterator
==== Test CuckooReaderTest.CheckIteratorUint64
==== Test CuckooReaderTest.WhenKeyNotFound
==== Test CuckooReaderTest.TestReadPerformance
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.230us (4.3 Mqps) with batch size of 0, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.086us (11.7 Mqps) with batch size of 10, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.088us (11.3 Mqps) with batch size of 25, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.083us (12.1 Mqps) with batch size of 50, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.083us (12.1 Mqps) with batch size of 100, # of found keys 125829120
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.159us (6.3 Mqps) with batch size of 0, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 10, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.080us (12.6 Mqps) with batch size of 25, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.080us (12.5 Mqps) with batch size of 50, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.082us (12.2 Mqps) with batch size of 100, # of found keys 104857600
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.154us (6.5 Mqps) with batch size of 0, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.077us (13.0 Mqps) with batch size of 10, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.077us (12.9 Mqps) with batch size of 25, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 50, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.079us (12.6 Mqps) with batch size of 100, # of found keys 83886080
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.218us (4.6 Mqps) with batch size of 0, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.083us (12.0 Mqps) with batch size of 10, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.085us (11.7 Mqps) with batch size of 25, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.086us (11.6 Mqps) with batch size of 50, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 100, # of found keys 73400320
```
Reviewers: sdong, igor, yhchiang
Reviewed By: igor
Subscribers: leveldb
Differential Revision: https://reviews.facebook.net/D23451
2014-09-18 18:00:48 +00:00
|
|
|
DEFINE_bool(identity_as_first_hash, false, "the first hash function of cuckoo "
|
|
|
|
"table becomes an identity function. This is only valid when key "
|
|
|
|
"is 8 bytes");
|
2016-04-27 23:23:33 +00:00
|
|
|
DEFINE_bool(dump_malloc_stats, true, "Dump malloc stats in LOG ");
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_uint64(stats_dump_period_sec,
|
|
|
|
ROCKSDB_NAMESPACE::Options().stats_dump_period_sec,
|
2018-07-12 22:55:07 +00:00
|
|
|
"Gap between printing stats to log in seconds");
|
2019-02-20 23:46:59 +00:00
|
|
|
DEFINE_uint64(stats_persist_period_sec,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().stats_persist_period_sec,
|
2019-02-20 23:46:59 +00:00
|
|
|
"Gap between persisting stats in seconds");
|
2020-02-20 20:07:53 +00:00
|
|
|
DEFINE_bool(persist_stats_to_disk,
|
|
|
|
ROCKSDB_NAMESPACE::Options().persist_stats_to_disk,
|
2019-06-17 22:17:43 +00:00
|
|
|
"whether to persist stats to disk");
|
2019-02-20 23:46:59 +00:00
|
|
|
DEFINE_uint64(stats_history_buffer_size,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Options().stats_history_buffer_size,
|
2019-02-20 23:46:59 +00:00
|
|
|
"Max number of stats snapshots to keep in memory");
|
2022-04-01 04:23:58 +00:00
|
|
|
DEFINE_bool(avoid_flush_during_recovery,
|
|
|
|
ROCKSDB_NAMESPACE::Options().avoid_flush_during_recovery,
|
|
|
|
"If true, avoids flushing the recovered WAL data where possible.");
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
DEFINE_int64(multiread_stride, 0,
|
|
|
|
"Stride length for the keys in a MultiGet batch");
|
|
|
|
DEFINE_bool(multiread_batched, false, "Use the new MultiGet API");
|
2013-08-23 06:10:02 +00:00
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_string(memtablerep, "skip_list", "");
|
2014-03-05 18:27:17 +00:00
|
|
|
DEFINE_int64(hash_bucket_count, 1024 * 1024, "hash bucket count");
|
2014-02-12 18:41:55 +00:00
|
|
|
DEFINE_bool(use_plain_table, false, "if use plain table "
|
|
|
|
"instead of block-based table format");
|
2014-08-18 18:59:38 +00:00
|
|
|
DEFINE_bool(use_cuckoo_table, false, "if use cuckoo table format");
|
|
|
|
DEFINE_double(cuckoo_hash_ratio, 0.9, "Hash ratio for Cuckoo SST table.");
|
2014-07-17 00:32:30 +00:00
|
|
|
DEFINE_bool(use_hash_search, false, "if use kHashSearch "
|
|
|
|
"instead of kBinarySearch. "
|
|
|
|
"This is valid if only we use BlockTable");
|
2013-10-24 14:43:14 +00:00
|
|
|
DEFINE_string(merge_operator, "", "The merge operator to use with the database."
|
|
|
|
"If a new merge operator is specified, be sure to use fresh"
|
|
|
|
" database The possible merge operators are defined in"
|
|
|
|
" utilities/merge_operators.h");
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
DEFINE_int32(skip_list_lookahead, 0, "Used with skip_list memtablerep; try "
|
|
|
|
"linear search first for this many steps from the previous "
|
|
|
|
"position");
|
2014-10-29 21:24:34 +00:00
|
|
|
DEFINE_bool(report_file_operations, false, "if report number of file "
|
|
|
|
"operations");
|
2021-07-02 01:41:20 +00:00
|
|
|
DEFINE_bool(report_open_timing, false, "if report open timing");
|
2019-04-27 04:20:25 +00:00
|
|
|
DEFINE_int32(readahead_size, 0, "Iterator readahead size");
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
DEFINE_bool(read_with_latest_user_timestamp, true,
|
|
|
|
"If true, always use the current latest timestamp for read. If "
|
|
|
|
"false, choose a random timestamp from the past.");
|
|
|
|
|
2021-05-19 22:24:37 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
DEFINE_string(secondary_cache_uri, "",
|
|
|
|
"Full URI for creating a custom secondary cache object");
|
|
|
|
static class std::shared_ptr<ROCKSDB_NAMESPACE::SecondaryCache> secondary_cache;
|
|
|
|
#endif // ROCKSDB_LITE
|
|
|
|
|
2018-02-02 20:14:42 +00:00
|
|
|
static const bool FLAGS_prefix_size_dummy __attribute__((__unused__)) =
|
2014-05-09 00:25:13 +00:00
|
|
|
RegisterFlagValidator(&FLAGS_prefix_size, &ValidatePrefixSize);
|
2013-11-17 07:44:39 +00:00
|
|
|
|
2018-02-02 20:14:42 +00:00
|
|
|
static const bool FLAGS_key_size_dummy __attribute__((__unused__)) =
|
2014-05-09 00:25:13 +00:00
|
|
|
RegisterFlagValidator(&FLAGS_key_size, &ValidateKeySize);
|
2013-11-17 07:44:39 +00:00
|
|
|
|
2018-02-02 20:14:42 +00:00
|
|
|
static const bool FLAGS_cache_numshardbits_dummy __attribute__((__unused__)) =
|
2014-05-09 00:25:13 +00:00
|
|
|
RegisterFlagValidator(&FLAGS_cache_numshardbits,
|
|
|
|
&ValidateCacheNumshardbits);
|
2013-11-17 07:44:39 +00:00
|
|
|
|
2018-02-02 20:14:42 +00:00
|
|
|
static const bool FLAGS_readwritepercent_dummy __attribute__((__unused__)) =
|
2014-05-09 00:25:13 +00:00
|
|
|
RegisterFlagValidator(&FLAGS_readwritepercent, &ValidateInt32Percent);
|
2013-11-17 07:44:39 +00:00
|
|
|
|
2014-06-20 08:23:02 +00:00
|
|
|
DEFINE_int32(disable_seek_compaction, false,
|
|
|
|
"Not used, left here for backwards compatibility");
|
|
|
|
|
2022-06-15 19:38:04 +00:00
|
|
|
DEFINE_bool(allow_data_in_errors,
|
|
|
|
ROCKSDB_NAMESPACE::Options().allow_data_in_errors,
|
|
|
|
"If true, allow logging data, e.g. key, value in LOG files.");
|
|
|
|
|
2018-02-02 20:14:42 +00:00
|
|
|
static const bool FLAGS_deletepercent_dummy __attribute__((__unused__)) =
|
2014-05-09 00:25:13 +00:00
|
|
|
RegisterFlagValidator(&FLAGS_deletepercent, &ValidateInt32Percent);
|
2018-02-02 20:14:42 +00:00
|
|
|
static const bool FLAGS_table_cache_numshardbits_dummy __attribute__((__unused__)) =
|
2014-05-09 00:25:13 +00:00
|
|
|
RegisterFlagValidator(&FLAGS_table_cache_numshardbits,
|
|
|
|
&ValidateTableCacheNumshardbits);
|
2013-11-17 07:44:39 +00:00
|
|
|
|
2022-06-15 20:43:58 +00:00
|
|
|
DEFINE_uint32(write_batch_protection_bytes_per_key, 0,
|
|
|
|
"Size of per-key-value checksum in each write batch. Currently "
|
|
|
|
"only value 0 and 8 are supported.");
|
|
|
|
|
2022-08-12 20:51:32 +00:00
|
|
|
DEFINE_uint32(
|
|
|
|
memtable_protection_bytes_per_key, 0,
|
|
|
|
"Enable memtable per key-value checksum protection. "
|
|
|
|
"Each entry in memtable will be suffixed by a per key-value checksum. "
|
|
|
|
"This options determines the size of such checksums. "
|
|
|
|
"Supported values: 0, 1, 2, 4, 8.");
|
|
|
|
|
2022-07-06 16:58:45 +00:00
|
|
|
DEFINE_bool(build_info, false,
|
|
|
|
"Print the build info via GetRocksBuildInfoAsString");
|
|
|
|
|
2022-07-13 00:16:57 +00:00
|
|
|
DEFINE_bool(track_and_verify_wals_in_manifest, false,
|
|
|
|
"If true, enable WAL tracking in the MANIFEST");
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
namespace ROCKSDB_NAMESPACE {
|
2014-10-29 21:24:34 +00:00
|
|
|
namespace {
|
2021-09-08 14:45:59 +00:00
|
|
|
static Status CreateMemTableRepFactory(
|
|
|
|
const ConfigOptions& config_options,
|
|
|
|
std::shared_ptr<MemTableRepFactory>* factory) {
|
|
|
|
Status s;
|
|
|
|
if (!strcasecmp(FLAGS_memtablerep.c_str(), SkipListFactory::kNickName())) {
|
|
|
|
factory->reset(new SkipListFactory(FLAGS_skip_list_lookahead));
|
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
} else if (!strcasecmp(FLAGS_memtablerep.c_str(), "prefix_hash")) {
|
|
|
|
factory->reset(NewHashSkipListRepFactory(FLAGS_hash_bucket_count));
|
|
|
|
} else if (!strcasecmp(FLAGS_memtablerep.c_str(),
|
|
|
|
VectorRepFactory::kNickName())) {
|
|
|
|
factory->reset(new VectorRepFactory());
|
|
|
|
} else if (!strcasecmp(FLAGS_memtablerep.c_str(), "hash_linkedlist")) {
|
|
|
|
factory->reset(NewHashLinkListRepFactory(FLAGS_hash_bucket_count));
|
|
|
|
#endif // ROCKSDB_LITE
|
|
|
|
} else {
|
|
|
|
std::unique_ptr<MemTableRepFactory> unique;
|
|
|
|
s = MemTableRepFactory::CreateFromString(config_options, FLAGS_memtablerep,
|
|
|
|
&unique);
|
|
|
|
if (s.ok()) {
|
|
|
|
factory->reset(unique.release());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return s;
|
|
|
|
}
|
|
|
|
|
2014-10-29 21:24:34 +00:00
|
|
|
} // namespace
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
enum DistributionType : unsigned char {
|
|
|
|
kFixed = 0,
|
|
|
|
kUniform,
|
|
|
|
kNormal
|
|
|
|
};
|
|
|
|
|
|
|
|
static enum DistributionType FLAGS_value_size_distribution_type_e = kFixed;
|
|
|
|
|
|
|
|
static enum DistributionType StringToDistributionType(const char* ctype) {
|
|
|
|
assert(ctype);
|
|
|
|
|
|
|
|
if (!strcasecmp(ctype, "fixed"))
|
|
|
|
return kFixed;
|
|
|
|
else if (!strcasecmp(ctype, "uniform"))
|
|
|
|
return kUniform;
|
|
|
|
else if (!strcasecmp(ctype, "normal"))
|
|
|
|
return kNormal;
|
|
|
|
|
|
|
|
fprintf(stdout, "Cannot parse distribution type '%s'\n", ctype);
|
2022-03-24 18:46:27 +00:00
|
|
|
exit(1);
|
2020-02-12 22:44:46 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
class BaseDistribution {
|
|
|
|
public:
|
2020-03-16 20:47:28 +00:00
|
|
|
BaseDistribution(unsigned int _min, unsigned int _max)
|
|
|
|
: min_value_size_(_min), max_value_size_(_max) {}
|
2020-02-12 22:44:46 +00:00
|
|
|
virtual ~BaseDistribution() {}
|
|
|
|
|
|
|
|
unsigned int Generate() {
|
|
|
|
auto val = Get();
|
|
|
|
if (NeedTruncate()) {
|
|
|
|
val = std::max(min_value_size_, val);
|
|
|
|
val = std::min(max_value_size_, val);
|
|
|
|
}
|
|
|
|
return val;
|
|
|
|
}
|
|
|
|
private:
|
|
|
|
virtual unsigned int Get() = 0;
|
|
|
|
virtual bool NeedTruncate() {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
unsigned int min_value_size_;
|
|
|
|
unsigned int max_value_size_;
|
|
|
|
};
|
|
|
|
|
|
|
|
class FixedDistribution : public BaseDistribution
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
FixedDistribution(unsigned int size) :
|
|
|
|
BaseDistribution(size, size),
|
|
|
|
size_(size) {}
|
|
|
|
private:
|
|
|
|
virtual unsigned int Get() override {
|
|
|
|
return size_;
|
|
|
|
}
|
|
|
|
virtual bool NeedTruncate() override {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
unsigned int size_;
|
|
|
|
};
|
|
|
|
|
|
|
|
class NormalDistribution
|
|
|
|
: public BaseDistribution, public std::normal_distribution<double> {
|
|
|
|
public:
|
2020-03-16 20:47:28 +00:00
|
|
|
NormalDistribution(unsigned int _min, unsigned int _max)
|
|
|
|
: BaseDistribution(_min, _max),
|
|
|
|
// 99.7% values within the range [min, max].
|
|
|
|
std::normal_distribution<double>(
|
|
|
|
(double)(_min + _max) / 2.0 /*mean*/,
|
|
|
|
(double)(_max - _min) / 6.0 /*stddev*/),
|
|
|
|
gen_(rd_()) {}
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
private:
|
|
|
|
virtual unsigned int Get() override {
|
|
|
|
return static_cast<unsigned int>((*this)(gen_));
|
|
|
|
}
|
|
|
|
std::random_device rd_;
|
|
|
|
std::mt19937 gen_;
|
|
|
|
};
|
|
|
|
|
|
|
|
class UniformDistribution
|
|
|
|
: public BaseDistribution,
|
|
|
|
public std::uniform_int_distribution<unsigned int> {
|
|
|
|
public:
|
2020-03-16 20:47:28 +00:00
|
|
|
UniformDistribution(unsigned int _min, unsigned int _max)
|
|
|
|
: BaseDistribution(_min, _max),
|
|
|
|
std::uniform_int_distribution<unsigned int>(_min, _max),
|
|
|
|
gen_(rd_()) {}
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
private:
|
|
|
|
virtual unsigned int Get() override {
|
|
|
|
return (*this)(gen_);
|
|
|
|
}
|
|
|
|
virtual bool NeedTruncate() override {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
std::random_device rd_;
|
|
|
|
std::mt19937 gen_;
|
|
|
|
};
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
// Helper for quickly generating random data.
|
2011-03-18 22:37:00 +00:00
|
|
|
class RandomGenerator {
|
|
|
|
private:
|
|
|
|
std::string data_;
|
2012-11-06 20:02:18 +00:00
|
|
|
unsigned int pos_;
|
2020-02-12 22:44:46 +00:00
|
|
|
std::unique_ptr<BaseDistribution> dist_;
|
2011-03-18 22:37:00 +00:00
|
|
|
|
|
|
|
public:
|
2020-02-12 22:44:46 +00:00
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
RandomGenerator() {
|
2020-02-12 22:44:46 +00:00
|
|
|
auto max_value_size = FLAGS_value_size_max;
|
|
|
|
switch (FLAGS_value_size_distribution_type_e) {
|
|
|
|
case kUniform:
|
|
|
|
dist_.reset(new UniformDistribution(FLAGS_value_size_min,
|
|
|
|
FLAGS_value_size_max));
|
|
|
|
break;
|
|
|
|
case kNormal:
|
|
|
|
dist_.reset(new NormalDistribution(FLAGS_value_size_min,
|
|
|
|
FLAGS_value_size_max));
|
|
|
|
break;
|
|
|
|
case kFixed:
|
|
|
|
default:
|
|
|
|
dist_.reset(new FixedDistribution(value_size));
|
|
|
|
max_value_size = value_size;
|
|
|
|
}
|
2011-03-18 22:37:00 +00:00
|
|
|
// We use a limited amount of data over and over again and ensure
|
|
|
|
// that it is larger than the compression window (32KB), and also
|
|
|
|
// large enough to serve all typical value sizes we want to write.
|
|
|
|
Random rnd(301);
|
|
|
|
std::string piece;
|
2020-02-12 22:44:46 +00:00
|
|
|
while (data_.size() < (unsigned)std::max(1048576, max_value_size)) {
|
2011-03-18 22:37:00 +00:00
|
|
|
// Add a short fragment that is as compressible as specified
|
|
|
|
// by FLAGS_compression_ratio.
|
|
|
|
test::CompressibleString(&rnd, FLAGS_compression_ratio, 100, &piece);
|
|
|
|
data_.append(piece);
|
|
|
|
}
|
|
|
|
pos_ = 0;
|
|
|
|
}
|
|
|
|
|
2013-03-15 01:32:01 +00:00
|
|
|
Slice Generate(unsigned int len) {
|
2014-06-24 21:29:28 +00:00
|
|
|
assert(len <= data_.size());
|
2011-03-18 22:37:00 +00:00
|
|
|
if (pos_ + len > data_.size()) {
|
|
|
|
pos_ = 0;
|
|
|
|
}
|
|
|
|
pos_ += len;
|
|
|
|
return Slice(data_.data() + pos_ - len, len);
|
|
|
|
}
|
2017-05-10 21:54:35 +00:00
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice Generate() {
|
|
|
|
auto len = dist_->Generate();
|
|
|
|
return Generate(len);
|
2017-05-10 21:54:35 +00:00
|
|
|
}
|
2012-09-26 15:06:19 +00:00
|
|
|
};
|
2013-08-13 20:58:02 +00:00
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
static void AppendWithSpace(std::string* str, Slice msg) {
|
|
|
|
if (msg.empty()) return;
|
|
|
|
if (!str->empty()) {
|
|
|
|
str->push_back(' ');
|
|
|
|
}
|
|
|
|
str->append(msg.data(), msg.size());
|
|
|
|
}
|
|
|
|
|
2014-09-29 16:50:41 +00:00
|
|
|
struct DBWithColumnFamilies {
|
|
|
|
std::vector<ColumnFamilyHandle*> cfh;
|
|
|
|
DB* db;
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
OptimisticTransactionDB* opt_txn_db;
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2014-12-23 02:39:28 +00:00
|
|
|
std::atomic<size_t> num_created; // Need to be updated after all the
|
|
|
|
// new entries in cfh are set.
|
|
|
|
size_t num_hot; // Number of column families to be queried at each moment.
|
|
|
|
// After each CreateNewCf(), another num_hot number of new
|
|
|
|
// Column families will be created and used to be queried.
|
|
|
|
port::Mutex create_cf_mutex; // Only one thread can execute CreateNewCf()
|
2017-08-11 20:46:41 +00:00
|
|
|
std::vector<int> cfh_idx_to_prob; // ith index holds probability of operating
|
|
|
|
// on cfh[i].
|
2014-12-23 02:39:28 +00:00
|
|
|
|
2015-10-14 19:43:00 +00:00
|
|
|
DBWithColumnFamilies()
|
|
|
|
: db(nullptr)
|
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
, opt_txn_db(nullptr)
|
|
|
|
#endif // ROCKSDB_LITE
|
|
|
|
{
|
2014-09-29 16:50:41 +00:00
|
|
|
cfh.clear();
|
2015-03-12 00:57:16 +00:00
|
|
|
num_created = 0;
|
|
|
|
num_hot = 0;
|
2014-09-29 16:50:41 +00:00
|
|
|
}
|
2014-12-23 02:39:28 +00:00
|
|
|
|
|
|
|
DBWithColumnFamilies(const DBWithColumnFamilies& other)
|
|
|
|
: cfh(other.cfh),
|
|
|
|
db(other.db),
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
opt_txn_db(other.opt_txn_db),
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2014-12-23 02:39:28 +00:00
|
|
|
num_created(other.num_created.load()),
|
2017-08-11 20:46:41 +00:00
|
|
|
num_hot(other.num_hot),
|
|
|
|
cfh_idx_to_prob(other.cfh_idx_to_prob) {
|
|
|
|
}
|
2014-12-23 02:39:28 +00:00
|
|
|
|
2015-05-29 21:36:35 +00:00
|
|
|
void DeleteDBs() {
|
|
|
|
std::for_each(cfh.begin(), cfh.end(),
|
|
|
|
[](ColumnFamilyHandle* cfhi) { delete cfhi; });
|
|
|
|
cfh.clear();
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
if (opt_txn_db) {
|
|
|
|
delete opt_txn_db;
|
|
|
|
opt_txn_db = nullptr;
|
2015-05-29 21:36:35 +00:00
|
|
|
} else {
|
|
|
|
delete db;
|
2015-10-14 19:43:00 +00:00
|
|
|
db = nullptr;
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
2015-10-14 19:43:00 +00:00
|
|
|
#else
|
|
|
|
delete db;
|
2015-05-29 21:36:35 +00:00
|
|
|
db = nullptr;
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
|
|
|
|
2014-12-23 02:39:28 +00:00
|
|
|
ColumnFamilyHandle* GetCfh(int64_t rand_num) {
|
|
|
|
assert(num_hot > 0);
|
2017-08-11 20:46:41 +00:00
|
|
|
size_t rand_offset = 0;
|
|
|
|
if (!cfh_idx_to_prob.empty()) {
|
|
|
|
assert(cfh_idx_to_prob.size() == num_hot);
|
|
|
|
int sum = 0;
|
|
|
|
while (sum + cfh_idx_to_prob[rand_offset] < rand_num % 100) {
|
|
|
|
sum += cfh_idx_to_prob[rand_offset];
|
|
|
|
++rand_offset;
|
|
|
|
}
|
|
|
|
assert(rand_offset < cfh_idx_to_prob.size());
|
|
|
|
} else {
|
|
|
|
rand_offset = rand_num % num_hot;
|
|
|
|
}
|
2014-12-23 02:39:28 +00:00
|
|
|
return cfh[num_created.load(std::memory_order_acquire) - num_hot +
|
2017-08-11 20:46:41 +00:00
|
|
|
rand_offset];
|
2014-12-23 02:39:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// stage: assume CF from 0 to stage * num_hot has be created. Need to create
|
|
|
|
// stage * num_hot + 1 to stage * (num_hot + 1).
|
|
|
|
void CreateNewCf(ColumnFamilyOptions options, int64_t stage) {
|
|
|
|
MutexLock l(&create_cf_mutex);
|
|
|
|
if ((stage + 1) * num_hot <= num_created) {
|
|
|
|
// Already created.
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
auto new_num_created = num_created + num_hot;
|
|
|
|
assert(new_num_created <= cfh.size());
|
|
|
|
for (size_t i = num_created; i < new_num_created; i++) {
|
|
|
|
Status s =
|
|
|
|
db->CreateColumnFamily(options, ColumnFamilyName(i), &(cfh[i]));
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "create column family error: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
num_created.store(new_num_created, std::memory_order_release);
|
|
|
|
}
|
2014-09-29 16:50:41 +00:00
|
|
|
};
|
|
|
|
|
2022-04-01 23:06:14 +00:00
|
|
|
// A class that reports stats to CSV file.
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
class ReporterAgent {
|
|
|
|
public:
|
|
|
|
ReporterAgent(Env* env, const std::string& fname,
|
|
|
|
uint64_t report_interval_secs)
|
|
|
|
: env_(env),
|
|
|
|
total_ops_done_(0),
|
|
|
|
last_report_(0),
|
|
|
|
report_interval_secs_(report_interval_secs),
|
|
|
|
stop_(false) {
|
|
|
|
auto s = env_->NewWritableFile(fname, &report_file_, EnvOptions());
|
|
|
|
if (s.ok()) {
|
|
|
|
s = report_file_->Append(Header() + "\n");
|
|
|
|
}
|
|
|
|
if (s.ok()) {
|
|
|
|
s = report_file_->Flush();
|
|
|
|
}
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Can't open %s: %s\n", fname.c_str(),
|
|
|
|
s.ToString().c_str());
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
|
2017-02-06 22:43:55 +00:00
|
|
|
reporting_thread_ = port::Thread([&]() { SleepAndReport(); });
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
~ReporterAgent() {
|
|
|
|
{
|
|
|
|
std::unique_lock<std::mutex> lk(mutex_);
|
|
|
|
stop_ = true;
|
|
|
|
stop_cv_.notify_all();
|
|
|
|
}
|
|
|
|
reporting_thread_.join();
|
|
|
|
}
|
|
|
|
|
|
|
|
// thread safe
|
|
|
|
void ReportFinishedOps(int64_t num_ops) {
|
|
|
|
total_ops_done_.fetch_add(num_ops);
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
std::string Header() const { return "secs_elapsed,interval_qps"; }
|
|
|
|
void SleepAndReport() {
|
2021-03-15 11:32:24 +00:00
|
|
|
auto* clock = env_->GetSystemClock().get();
|
|
|
|
auto time_started = clock->NowMicros();
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
while (true) {
|
|
|
|
{
|
|
|
|
std::unique_lock<std::mutex> lk(mutex_);
|
|
|
|
if (stop_ ||
|
|
|
|
stop_cv_.wait_for(lk, std::chrono::seconds(report_interval_secs_),
|
|
|
|
[&]() { return stop_; })) {
|
|
|
|
// stopping
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
// else -> timeout, which means time for a report!
|
|
|
|
}
|
|
|
|
auto total_ops_done_snapshot = total_ops_done_.load();
|
|
|
|
// round the seconds elapsed
|
|
|
|
auto secs_elapsed =
|
2021-03-15 11:32:24 +00:00
|
|
|
(clock->NowMicros() - time_started + kMicrosInSecond / 2) /
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
kMicrosInSecond;
|
2022-05-06 20:03:58 +00:00
|
|
|
std::string report =
|
|
|
|
std::to_string(secs_elapsed) + "," +
|
|
|
|
std::to_string(total_ops_done_snapshot - last_report_) + "\n";
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
auto s = report_file_->Append(report);
|
|
|
|
if (s.ok()) {
|
|
|
|
s = report_file_->Flush();
|
|
|
|
}
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Can't write to report file (%s), stopping the reporting\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
last_report_ = total_ops_done_snapshot;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
Env* env_;
|
|
|
|
std::unique_ptr<WritableFile> report_file_;
|
|
|
|
std::atomic<int64_t> total_ops_done_;
|
|
|
|
int64_t last_report_;
|
|
|
|
const uint64_t report_interval_secs_;
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::port::Thread reporting_thread_;
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
std::mutex mutex_;
|
|
|
|
// will notify on stop
|
|
|
|
std::condition_variable stop_cv_;
|
|
|
|
bool stop_;
|
|
|
|
};
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
enum OperationType : unsigned char {
|
|
|
|
kRead = 0,
|
|
|
|
kWrite,
|
|
|
|
kDelete,
|
|
|
|
kSeek,
|
|
|
|
kMerge,
|
|
|
|
kUpdate,
|
|
|
|
kCompress,
|
|
|
|
kUncompress,
|
|
|
|
kCrc,
|
|
|
|
kHash,
|
|
|
|
kOthers
|
|
|
|
};
|
|
|
|
|
|
|
|
static std::unordered_map<OperationType, std::string, std::hash<unsigned char>>
|
|
|
|
OperationTypeString = {
|
|
|
|
{kRead, "read"},
|
|
|
|
{kWrite, "write"},
|
|
|
|
{kDelete, "delete"},
|
|
|
|
{kSeek, "seek"},
|
|
|
|
{kMerge, "merge"},
|
|
|
|
{kUpdate, "update"},
|
|
|
|
{kCompress, "compress"},
|
|
|
|
{kCompress, "uncompress"},
|
|
|
|
{kCrc, "crc"},
|
|
|
|
{kHash, "hash"},
|
|
|
|
{kOthers, "op"}
|
|
|
|
};
|
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
class CombinedStats;
|
2011-08-22 21:08:51 +00:00
|
|
|
class Stats {
|
|
|
|
private:
|
2021-03-15 11:32:24 +00:00
|
|
|
SystemClock* clock_;
|
2012-10-03 13:51:11 +00:00
|
|
|
int id_;
|
2020-06-04 22:32:29 +00:00
|
|
|
uint64_t start_ = 0;
|
2018-06-15 19:07:38 +00:00
|
|
|
uint64_t sine_interval_;
|
2015-11-19 19:47:12 +00:00
|
|
|
uint64_t finish_;
|
2011-08-22 21:08:51 +00:00
|
|
|
double seconds_;
|
2015-11-19 19:47:12 +00:00
|
|
|
uint64_t done_;
|
|
|
|
uint64_t last_report_done_;
|
|
|
|
uint64_t next_report_;
|
|
|
|
uint64_t bytes_;
|
|
|
|
uint64_t last_op_finish_;
|
|
|
|
uint64_t last_report_finish_;
|
2016-03-12 00:54:25 +00:00
|
|
|
std::unordered_map<OperationType, std::shared_ptr<HistogramImpl>,
|
2015-12-08 01:33:18 +00:00
|
|
|
std::hash<unsigned char>> hist_;
|
2011-08-22 21:08:51 +00:00
|
|
|
std::string message_;
|
2013-03-19 13:36:03 +00:00
|
|
|
bool exclude_from_merge_;
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
ReporterAgent* reporter_agent_; // does not own
|
2016-08-25 19:57:35 +00:00
|
|
|
friend class CombinedStats;
|
2011-08-22 21:08:51 +00:00
|
|
|
|
|
|
|
public:
|
2021-03-15 11:32:24 +00:00
|
|
|
Stats() : clock_(FLAGS_env->GetSystemClock().get()) { Start(-1); }
|
2011-08-22 21:08:51 +00:00
|
|
|
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
void SetReporterAgent(ReporterAgent* reporter_agent) {
|
|
|
|
reporter_agent_ = reporter_agent;
|
|
|
|
}
|
|
|
|
|
2012-10-03 13:51:11 +00:00
|
|
|
void Start(int id) {
|
|
|
|
id_ = id;
|
|
|
|
next_report_ = FLAGS_stats_interval ? FLAGS_stats_interval : 100;
|
2011-08-22 21:08:51 +00:00
|
|
|
last_op_finish_ = start_;
|
2015-12-08 01:33:18 +00:00
|
|
|
hist_.clear();
|
2011-08-22 21:08:51 +00:00
|
|
|
done_ = 0;
|
2012-10-03 13:51:11 +00:00
|
|
|
last_report_done_ = 0;
|
2011-08-22 21:08:51 +00:00
|
|
|
bytes_ = 0;
|
|
|
|
seconds_ = 0;
|
2021-03-15 11:32:24 +00:00
|
|
|
start_ = clock_->NowMicros();
|
|
|
|
sine_interval_ = clock_->NowMicros();
|
2011-08-22 21:08:51 +00:00
|
|
|
finish_ = start_;
|
2012-10-03 13:51:11 +00:00
|
|
|
last_report_finish_ = start_;
|
2011-08-22 21:08:51 +00:00
|
|
|
message_.clear();
|
2013-03-19 13:36:03 +00:00
|
|
|
// When set, stats from this thread won't be merged with others.
|
|
|
|
exclude_from_merge_ = false;
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
void Merge(const Stats& other) {
|
2013-03-19 13:36:03 +00:00
|
|
|
if (other.exclude_from_merge_)
|
|
|
|
return;
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
for (auto it = other.hist_.begin(); it != other.hist_.end(); ++it) {
|
|
|
|
auto this_it = hist_.find(it->first);
|
|
|
|
if (this_it != hist_.end()) {
|
2016-03-12 00:54:25 +00:00
|
|
|
this_it->second->Merge(*(other.hist_.at(it->first)));
|
2015-12-08 01:33:18 +00:00
|
|
|
} else {
|
|
|
|
hist_.insert({ it->first, it->second });
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
done_ += other.done_;
|
|
|
|
bytes_ += other.bytes_;
|
|
|
|
seconds_ += other.seconds_;
|
|
|
|
if (other.start_ < start_) start_ = other.start_;
|
|
|
|
if (other.finish_ > finish_) finish_ = other.finish_;
|
|
|
|
|
2022-04-01 23:06:14 +00:00
|
|
|
// Just keep the messages from one thread.
|
2011-08-22 21:08:51 +00:00
|
|
|
if (message_.empty()) message_ = other.message_;
|
|
|
|
}
|
|
|
|
|
|
|
|
void Stop() {
|
2021-03-15 11:32:24 +00:00
|
|
|
finish_ = clock_->NowMicros();
|
2011-08-22 21:08:51 +00:00
|
|
|
seconds_ = (finish_ - start_) * 1e-6;
|
|
|
|
}
|
|
|
|
|
|
|
|
void AddMessage(Slice msg) {
|
|
|
|
AppendWithSpace(&message_, msg);
|
|
|
|
}
|
|
|
|
|
2012-10-03 13:51:11 +00:00
|
|
|
void SetId(int id) { id_ = id; }
|
2013-03-19 13:36:03 +00:00
|
|
|
void SetExcludeFromMerge() { exclude_from_merge_ = true; }
|
2012-10-03 13:51:11 +00:00
|
|
|
|
2015-03-06 19:22:06 +00:00
|
|
|
void PrintThreadStatus() {
|
|
|
|
std::vector<ThreadStatus> thread_list;
|
|
|
|
FLAGS_env->GetThreadList(&thread_list);
|
|
|
|
|
2015-05-07 05:50:35 +00:00
|
|
|
fprintf(stderr, "\n%18s %10s %12s %20s %13s %45s %12s %s\n",
|
2015-03-10 21:51:28 +00:00
|
|
|
"ThreadID", "ThreadType", "cfName", "Operation",
|
2015-05-07 05:50:35 +00:00
|
|
|
"ElapsedTime", "Stage", "State", "OperationProperties");
|
2015-03-06 19:22:06 +00:00
|
|
|
|
2015-03-10 21:51:28 +00:00
|
|
|
int64_t current_time = 0;
|
2021-03-15 11:32:24 +00:00
|
|
|
clock_->GetCurrentTime(¤t_time).PermitUncheckedError();
|
2015-03-06 19:22:06 +00:00
|
|
|
for (auto ts : thread_list) {
|
2015-05-07 05:50:35 +00:00
|
|
|
fprintf(stderr, "%18" PRIu64 " %10s %12s %20s %13s %45s %12s",
|
2015-03-06 19:22:06 +00:00
|
|
|
ts.thread_id,
|
|
|
|
ThreadStatus::GetThreadTypeName(ts.thread_type).c_str(),
|
|
|
|
ts.cf_name.c_str(),
|
|
|
|
ThreadStatus::GetOperationName(ts.operation_type).c_str(),
|
2015-03-23 23:35:04 +00:00
|
|
|
ThreadStatus::MicrosToString(ts.op_elapsed_micros).c_str(),
|
2015-03-13 17:45:40 +00:00
|
|
|
ThreadStatus::GetOperationStageName(ts.operation_stage).c_str(),
|
2015-03-06 19:22:06 +00:00
|
|
|
ThreadStatus::GetStateName(ts.state_type).c_str());
|
2015-05-07 05:50:35 +00:00
|
|
|
|
|
|
|
auto op_properties = ThreadStatus::InterpretOperationProperties(
|
|
|
|
ts.operation_type, ts.op_properties);
|
|
|
|
for (const auto& op_prop : op_properties) {
|
|
|
|
fprintf(stderr, " %s %" PRIu64" |",
|
|
|
|
op_prop.first.c_str(), op_prop.second);
|
|
|
|
}
|
|
|
|
fprintf(stderr, "\n");
|
2015-03-06 19:22:06 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-03-15 11:32:24 +00:00
|
|
|
void ResetSineInterval() { sine_interval_ = clock_->NowMicros(); }
|
2018-06-15 19:07:38 +00:00
|
|
|
|
|
|
|
uint64_t GetSineInterval() {
|
|
|
|
return sine_interval_;
|
|
|
|
}
|
|
|
|
|
|
|
|
uint64_t GetStart() {
|
|
|
|
return start_;
|
|
|
|
}
|
|
|
|
|
2016-01-04 20:01:27 +00:00
|
|
|
void ResetLastOpTime() {
|
2022-04-01 23:06:14 +00:00
|
|
|
// Set to now to avoid latency from calls to SleepForMicroseconds.
|
2021-03-15 11:32:24 +00:00
|
|
|
last_op_finish_ = clock_->NowMicros();
|
2016-01-04 20:01:27 +00:00
|
|
|
}
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
void FinishedOps(DBWithColumnFamilies* db_with_cfh, DB* db, int64_t num_ops,
|
|
|
|
enum OperationType op_type = kOthers) {
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
if (reporter_agent_) {
|
|
|
|
reporter_agent_->ReportFinishedOps(num_ops);
|
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
if (FLAGS_histogram) {
|
2021-03-15 11:32:24 +00:00
|
|
|
uint64_t now = clock_->NowMicros();
|
2015-11-19 19:47:12 +00:00
|
|
|
uint64_t micros = now - last_op_finish_;
|
2015-12-08 01:33:18 +00:00
|
|
|
|
|
|
|
if (hist_.find(op_type) == hist_.end())
|
|
|
|
{
|
2016-03-12 00:54:25 +00:00
|
|
|
auto hist_temp = std::make_shared<HistogramImpl>();
|
|
|
|
hist_.insert({op_type, std::move(hist_temp)});
|
2015-12-08 01:33:18 +00:00
|
|
|
}
|
2016-03-12 00:54:25 +00:00
|
|
|
hist_[op_type]->Add(micros);
|
2015-12-08 01:33:18 +00:00
|
|
|
|
2022-03-24 20:39:01 +00:00
|
|
|
if (micros >= FLAGS_slow_usecs && !FLAGS_stats_interval) {
|
2015-11-19 19:47:12 +00:00
|
|
|
fprintf(stderr, "long op: %" PRIu64 " micros%30s\r", micros, "");
|
2011-08-22 21:08:51 +00:00
|
|
|
fflush(stderr);
|
|
|
|
}
|
|
|
|
last_op_finish_ = now;
|
|
|
|
}
|
|
|
|
|
2014-06-23 20:23:02 +00:00
|
|
|
done_ += num_ops;
|
2022-07-22 16:19:25 +00:00
|
|
|
if (done_ >= next_report_ && FLAGS_progress_reports) {
|
2012-10-03 13:51:11 +00:00
|
|
|
if (!FLAGS_stats_interval) {
|
|
|
|
if (next_report_ < 1000) next_report_ += 100;
|
|
|
|
else if (next_report_ < 5000) next_report_ += 500;
|
|
|
|
else if (next_report_ < 10000) next_report_ += 1000;
|
|
|
|
else if (next_report_ < 50000) next_report_ += 5000;
|
|
|
|
else if (next_report_ < 100000) next_report_ += 10000;
|
|
|
|
else if (next_report_ < 500000) next_report_ += 50000;
|
|
|
|
else next_report_ += 100000;
|
2014-03-05 01:08:05 +00:00
|
|
|
fprintf(stderr, "... finished %" PRIu64 " ops%30s\r", done_, "");
|
2012-10-03 13:51:11 +00:00
|
|
|
} else {
|
2021-03-15 11:32:24 +00:00
|
|
|
uint64_t now = clock_->NowMicros();
|
2015-03-30 19:58:32 +00:00
|
|
|
int64_t usecs_since_last = now - last_report_finish_;
|
|
|
|
|
|
|
|
// Determine whether to print status where interval is either
|
|
|
|
// each N operations or each N seconds.
|
|
|
|
|
|
|
|
if (FLAGS_stats_interval_seconds &&
|
|
|
|
usecs_since_last < (FLAGS_stats_interval_seconds * 1000000)) {
|
2022-04-01 23:06:14 +00:00
|
|
|
// Don't check again for this many operations.
|
2015-03-30 19:58:32 +00:00
|
|
|
next_report_ += FLAGS_stats_interval;
|
|
|
|
|
|
|
|
} else {
|
|
|
|
fprintf(stderr,
|
2021-03-15 11:32:24 +00:00
|
|
|
"%s ... thread %d: (%" PRIu64 ",%" PRIu64
|
|
|
|
") ops and "
|
2015-03-30 19:58:32 +00:00
|
|
|
"(%.1f,%.1f) ops/second in (%.6f,%.6f) seconds\n",
|
2021-03-15 11:32:24 +00:00
|
|
|
clock_->TimeToString(now / 1000000).c_str(), id_,
|
2015-03-30 19:58:32 +00:00
|
|
|
done_ - last_report_done_, done_,
|
2021-03-15 11:32:24 +00:00
|
|
|
(done_ - last_report_done_) / (usecs_since_last / 1000000.0),
|
2015-03-30 19:58:32 +00:00
|
|
|
done_ / ((now - start_) / 1000000.0),
|
|
|
|
(now - last_report_finish_) / 1000000.0,
|
|
|
|
(now - start_) / 1000000.0);
|
|
|
|
|
2016-08-15 18:07:05 +00:00
|
|
|
if (id_ == 0 && FLAGS_stats_per_interval) {
|
2015-03-30 19:58:32 +00:00
|
|
|
std::string stats;
|
|
|
|
|
|
|
|
if (db_with_cfh && db_with_cfh->num_created.load()) {
|
|
|
|
for (size_t i = 0; i < db_with_cfh->num_created.load(); ++i) {
|
|
|
|
if (db->GetProperty(db_with_cfh->cfh[i], "rocksdb.cfstats",
|
|
|
|
&stats))
|
|
|
|
fprintf(stderr, "%s\n", stats.c_str());
|
Add argument --show_table_properties to db_bench
Summary:
Add argument --show_table_properties to db_bench
-show_table_properties (If true, then per-level table properties will be
printed on every stats-interval when stats_interval is set and
stats_per_interval is on.) type: bool default: false
Test Plan:
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1 --num_column_families=2
Sample Output:
Compaction Stats [column_family_name_000001]
Level Files Size(MB) Score Read(GB) Rn(GB) Rnp1(GB) Write(GB) Wnew(GB) Moved(GB) W-Amp Rd(MB/s) Wr(MB/s) Comp(sec) Comp(cnt) Avg(sec) Stall(cnt) KeyIn KeyDrop
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
L0 3/0 5 0.8 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 86.3 0 17 0.021 0 0 0
L1 5/0 9 0.9 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
L2 9/0 16 0.2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
Sum 17/0 31 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 86.3 0 17 0.021 0 0 0
Int 0/0 0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 83.9 0 2 0.022 0 0 0
Flush(GB): cumulative 0.030, interval 0.004
Stalls(count): 0 level0_slowdown, 0 level0_numfiles, 0 memtable_compaction, 0 leveln_slowdown_soft, 0 leveln_slowdown_hard
Level[0]: # data blocks=2571; # entries=84813; raw key size=2035512; raw average key size=24.000000; raw value size=8481300; raw average value size=100.000000; data block size=5690119; index block size=82415; filter block size=0; (estimated) table size=5772534; filter policy name=N/A;
Level[1]: # data blocks=4285; # entries=141355; raw key size=3392520; raw average key size=24.000000; raw value size=14135500; raw average value size=100.000000; data block size=9487353; index block size=137377; filter block size=0; (estimated) table size=9624730; filter policy name=N/A;
Level[2]: # data blocks=7713; # entries=254439; raw key size=6106536; raw average key size=24.000000; raw value size=25443900; raw average value size=100.000000; data block size=17077893; index block size=247269; filter block size=0; (estimated) table size=17325162; filter policy name=N/A;
Level[3]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[4]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[5]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[6]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Reviewers: anthony, IslamAbdelRahman, MarkCallaghan, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45651
2015-08-27 01:27:23 +00:00
|
|
|
if (FLAGS_show_table_properties) {
|
|
|
|
for (int level = 0; level < FLAGS_num_levels; ++level) {
|
|
|
|
if (db->GetProperty(
|
|
|
|
db_with_cfh->cfh[i],
|
|
|
|
"rocksdb.aggregated-table-properties-at-level" +
|
2022-05-06 20:03:58 +00:00
|
|
|
std::to_string(level),
|
Add argument --show_table_properties to db_bench
Summary:
Add argument --show_table_properties to db_bench
-show_table_properties (If true, then per-level table properties will be
printed on every stats-interval when stats_interval is set and
stats_per_interval is on.) type: bool default: false
Test Plan:
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1 --num_column_families=2
Sample Output:
Compaction Stats [column_family_name_000001]
Level Files Size(MB) Score Read(GB) Rn(GB) Rnp1(GB) Write(GB) Wnew(GB) Moved(GB) W-Amp Rd(MB/s) Wr(MB/s) Comp(sec) Comp(cnt) Avg(sec) Stall(cnt) KeyIn KeyDrop
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
L0 3/0 5 0.8 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 86.3 0 17 0.021 0 0 0
L1 5/0 9 0.9 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
L2 9/0 16 0.2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
Sum 17/0 31 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 86.3 0 17 0.021 0 0 0
Int 0/0 0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 83.9 0 2 0.022 0 0 0
Flush(GB): cumulative 0.030, interval 0.004
Stalls(count): 0 level0_slowdown, 0 level0_numfiles, 0 memtable_compaction, 0 leveln_slowdown_soft, 0 leveln_slowdown_hard
Level[0]: # data blocks=2571; # entries=84813; raw key size=2035512; raw average key size=24.000000; raw value size=8481300; raw average value size=100.000000; data block size=5690119; index block size=82415; filter block size=0; (estimated) table size=5772534; filter policy name=N/A;
Level[1]: # data blocks=4285; # entries=141355; raw key size=3392520; raw average key size=24.000000; raw value size=14135500; raw average value size=100.000000; data block size=9487353; index block size=137377; filter block size=0; (estimated) table size=9624730; filter policy name=N/A;
Level[2]: # data blocks=7713; # entries=254439; raw key size=6106536; raw average key size=24.000000; raw value size=25443900; raw average value size=100.000000; data block size=17077893; index block size=247269; filter block size=0; (estimated) table size=17325162; filter policy name=N/A;
Level[3]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[4]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[5]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[6]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Reviewers: anthony, IslamAbdelRahman, MarkCallaghan, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45651
2015-08-27 01:27:23 +00:00
|
|
|
&stats)) {
|
|
|
|
if (stats.find("# entries=0") == std::string::npos) {
|
|
|
|
fprintf(stderr, "Level[%d]: %s\n", level,
|
|
|
|
stats.c_str());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else if (db) {
|
|
|
|
if (db->GetProperty("rocksdb.stats", &stats)) {
|
Add number of running flushes & compactions to --stats_per_interval output (#9726)
Summary:
This is for https://github.com/facebook/rocksdb/issues/9709 and add two lines to the end of DB Stats
for num-running-compactions and num-running-flushes.
For example ...
** DB Stats **
Uptime(secs): 6.0 total, 1.0 interval
Cumulative writes: 915K writes, 915K keys, 915K commit groups, 1.0 writes per commit group, ingest: 0.11 GB, 18.95 MB/s
Cumulative WAL: 915K writes, 0 syncs, 915000.00 writes per sync, written: 0.11 GB, 18.95 MB/s
Cumulative stall: 00:00:0.000 H:M:S, 0.0 percent
Interval writes: 133K writes, 133K keys, 133K commit groups, 1.0 writes per commit group, ingest: 16.62 MB, 16.53 MB/s
Interval WAL: 133K writes, 0 syncs, 133000.00 writes per sync, written: 0.02 GB, 16.53 MB/s
Interval stall: 00:00:0.000 H:M:S, 0.0 percent
num-running-compactions: 0
num-running-flushes: 0
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9726
Reviewed By: jay-zhuang
Differential Revision: D35066759
Pulled By: mdcallag
fbshipit-source-id: c161fadd3c15c5aa715a820dab6bfedb46dc099b
2022-03-23 16:33:41 +00:00
|
|
|
fprintf(stderr, "%s", stats.c_str());
|
|
|
|
}
|
|
|
|
if (db->GetProperty("rocksdb.num-running-compactions", &stats)) {
|
|
|
|
fprintf(stderr, "num-running-compactions: %s\n", stats.c_str());
|
|
|
|
}
|
|
|
|
if (db->GetProperty("rocksdb.num-running-flushes", &stats)) {
|
|
|
|
fprintf(stderr, "num-running-flushes: %s\n\n", stats.c_str());
|
Add argument --show_table_properties to db_bench
Summary:
Add argument --show_table_properties to db_bench
-show_table_properties (If true, then per-level table properties will be
printed on every stats-interval when stats_interval is set and
stats_per_interval is on.) type: bool default: false
Test Plan:
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1 --num_column_families=2
Sample Output:
Compaction Stats [column_family_name_000001]
Level Files Size(MB) Score Read(GB) Rn(GB) Rnp1(GB) Write(GB) Wnew(GB) Moved(GB) W-Amp Rd(MB/s) Wr(MB/s) Comp(sec) Comp(cnt) Avg(sec) Stall(cnt) KeyIn KeyDrop
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
L0 3/0 5 0.8 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 86.3 0 17 0.021 0 0 0
L1 5/0 9 0.9 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
L2 9/0 16 0.2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
Sum 17/0 31 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 86.3 0 17 0.021 0 0 0
Int 0/0 0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 83.9 0 2 0.022 0 0 0
Flush(GB): cumulative 0.030, interval 0.004
Stalls(count): 0 level0_slowdown, 0 level0_numfiles, 0 memtable_compaction, 0 leveln_slowdown_soft, 0 leveln_slowdown_hard
Level[0]: # data blocks=2571; # entries=84813; raw key size=2035512; raw average key size=24.000000; raw value size=8481300; raw average value size=100.000000; data block size=5690119; index block size=82415; filter block size=0; (estimated) table size=5772534; filter policy name=N/A;
Level[1]: # data blocks=4285; # entries=141355; raw key size=3392520; raw average key size=24.000000; raw value size=14135500; raw average value size=100.000000; data block size=9487353; index block size=137377; filter block size=0; (estimated) table size=9624730; filter policy name=N/A;
Level[2]: # data blocks=7713; # entries=254439; raw key size=6106536; raw average key size=24.000000; raw value size=25443900; raw average value size=100.000000; data block size=17077893; index block size=247269; filter block size=0; (estimated) table size=17325162; filter policy name=N/A;
Level[3]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[4]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[5]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[6]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Reviewers: anthony, IslamAbdelRahman, MarkCallaghan, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45651
2015-08-27 01:27:23 +00:00
|
|
|
}
|
|
|
|
if (FLAGS_show_table_properties) {
|
|
|
|
for (int level = 0; level < FLAGS_num_levels; ++level) {
|
|
|
|
if (db->GetProperty(
|
|
|
|
"rocksdb.aggregated-table-properties-at-level" +
|
2022-05-06 20:03:58 +00:00
|
|
|
std::to_string(level),
|
Add argument --show_table_properties to db_bench
Summary:
Add argument --show_table_properties to db_bench
-show_table_properties (If true, then per-level table properties will be
printed on every stats-interval when stats_interval is set and
stats_per_interval is on.) type: bool default: false
Test Plan:
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1
./db_bench --show_table_properties=1 --stats_interval=100000 --stats_per_interval=1 --num_column_families=2
Sample Output:
Compaction Stats [column_family_name_000001]
Level Files Size(MB) Score Read(GB) Rn(GB) Rnp1(GB) Write(GB) Wnew(GB) Moved(GB) W-Amp Rd(MB/s) Wr(MB/s) Comp(sec) Comp(cnt) Avg(sec) Stall(cnt) KeyIn KeyDrop
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
L0 3/0 5 0.8 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 86.3 0 17 0.021 0 0 0
L1 5/0 9 0.9 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
L2 9/0 16 0.2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0.000 0 0 0
Sum 17/0 31 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 86.3 0 17 0.021 0 0 0
Int 0/0 0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0 83.9 0 2 0.022 0 0 0
Flush(GB): cumulative 0.030, interval 0.004
Stalls(count): 0 level0_slowdown, 0 level0_numfiles, 0 memtable_compaction, 0 leveln_slowdown_soft, 0 leveln_slowdown_hard
Level[0]: # data blocks=2571; # entries=84813; raw key size=2035512; raw average key size=24.000000; raw value size=8481300; raw average value size=100.000000; data block size=5690119; index block size=82415; filter block size=0; (estimated) table size=5772534; filter policy name=N/A;
Level[1]: # data blocks=4285; # entries=141355; raw key size=3392520; raw average key size=24.000000; raw value size=14135500; raw average value size=100.000000; data block size=9487353; index block size=137377; filter block size=0; (estimated) table size=9624730; filter policy name=N/A;
Level[2]: # data blocks=7713; # entries=254439; raw key size=6106536; raw average key size=24.000000; raw value size=25443900; raw average value size=100.000000; data block size=17077893; index block size=247269; filter block size=0; (estimated) table size=17325162; filter policy name=N/A;
Level[3]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[4]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[5]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Level[6]: # data blocks=0; # entries=0; raw key size=0; raw average key size=0.000000; raw value size=0; raw average value size=0.000000; data block size=0; index block size=0; filter block size=0; (estimated) table size=0; filter policy name=N/A;
Reviewers: anthony, IslamAbdelRahman, MarkCallaghan, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D45651
2015-08-27 01:27:23 +00:00
|
|
|
&stats)) {
|
|
|
|
if (stats.find("# entries=0") == std::string::npos) {
|
|
|
|
fprintf(stderr, "Level[%d]: %s\n", level, stats.c_str());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2015-03-30 19:58:32 +00:00
|
|
|
}
|
|
|
|
}
|
2014-09-29 16:50:41 +00:00
|
|
|
}
|
2012-10-23 17:34:09 +00:00
|
|
|
|
2015-03-30 19:58:32 +00:00
|
|
|
next_report_ += FLAGS_stats_interval;
|
|
|
|
last_report_finish_ = now;
|
|
|
|
last_report_done_ = done_;
|
|
|
|
}
|
2012-10-03 13:51:11 +00:00
|
|
|
}
|
2015-03-06 19:22:06 +00:00
|
|
|
if (id_ == 0 && FLAGS_thread_status_per_interval) {
|
|
|
|
PrintThreadStatus();
|
|
|
|
}
|
|
|
|
fflush(stderr);
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void AddBytes(int64_t n) {
|
|
|
|
bytes_ += n;
|
|
|
|
}
|
|
|
|
|
|
|
|
void Report(const Slice& name) {
|
|
|
|
// Pretend at least one op was done in case we are running a benchmark
|
2014-06-23 20:23:02 +00:00
|
|
|
// that does not call FinishedOps().
|
2011-08-22 21:08:51 +00:00
|
|
|
if (done_ < 1) done_ = 1;
|
|
|
|
|
|
|
|
std::string extra;
|
2022-05-04 17:15:49 +00:00
|
|
|
double elapsed = (finish_ - start_) * 1e-6;
|
2011-08-22 21:08:51 +00:00
|
|
|
if (bytes_ > 0) {
|
|
|
|
// Rate is computed on actual elapsed time, not the sum of per-thread
|
|
|
|
// elapsed times.
|
|
|
|
char rate[100];
|
|
|
|
snprintf(rate, sizeof(rate), "%6.1f MB/s",
|
|
|
|
(bytes_ / 1048576.0) / elapsed);
|
|
|
|
extra = rate;
|
|
|
|
}
|
|
|
|
AppendWithSpace(&extra, message_);
|
2012-05-11 18:32:37 +00:00
|
|
|
double throughput = (double)done_/elapsed;
|
2011-08-22 21:08:51 +00:00
|
|
|
|
2022-05-04 17:15:49 +00:00
|
|
|
fprintf(stdout,
|
|
|
|
"%-12s : %11.3f micros/op %ld ops/sec %.3f seconds %" PRIu64
|
|
|
|
" operations;%s%s\n",
|
|
|
|
name.ToString().c_str(), seconds_ * 1e6 / done_, (long)throughput,
|
|
|
|
elapsed, done_, (extra.empty() ? "" : " "), extra.c_str());
|
2011-08-22 21:08:51 +00:00
|
|
|
if (FLAGS_histogram) {
|
2015-12-08 01:33:18 +00:00
|
|
|
for (auto it = hist_.begin(); it != hist_.end(); ++it) {
|
|
|
|
fprintf(stdout, "Microseconds per %s:\n%s\n",
|
|
|
|
OperationTypeString[it->first].c_str(),
|
2016-03-12 00:54:25 +00:00
|
|
|
it->second->ToString().c_str());
|
2015-12-08 01:33:18 +00:00
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
2014-10-29 21:24:34 +00:00
|
|
|
if (FLAGS_report_file_operations) {
|
2022-02-03 23:00:03 +00:00
|
|
|
auto* counted_fs =
|
|
|
|
FLAGS_env->GetFileSystem()->CheckedCast<CountedFileSystem>();
|
|
|
|
assert(counted_fs);
|
|
|
|
fprintf(stdout, "%s", counted_fs->PrintCounters().c_str());
|
|
|
|
counted_fs->ResetCounters();
|
2014-10-29 21:24:34 +00:00
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
fflush(stdout);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
class CombinedStats {
|
|
|
|
public:
|
|
|
|
void AddStats(const Stats& stat) {
|
|
|
|
uint64_t total_ops = stat.done_;
|
|
|
|
uint64_t total_bytes_ = stat.bytes_;
|
|
|
|
double elapsed;
|
|
|
|
|
|
|
|
if (total_ops < 1) {
|
|
|
|
total_ops = 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
elapsed = (stat.finish_ - stat.start_) * 1e-6;
|
|
|
|
throughput_ops_.emplace_back(total_ops / elapsed);
|
|
|
|
|
|
|
|
if (total_bytes_ > 0) {
|
|
|
|
double mbs = (total_bytes_ / 1048576.0);
|
|
|
|
throughput_mbs_.emplace_back(mbs / elapsed);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void Report(const std::string& bench_name) {
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
if (throughput_ops_.size() < 2) {
|
|
|
|
// skip if there are not enough samples
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
const char* name = bench_name.c_str();
|
|
|
|
int num_runs = static_cast<int>(throughput_ops_.size());
|
|
|
|
|
|
|
|
if (throughput_mbs_.size() == throughput_ops_.size()) {
|
|
|
|
fprintf(stdout,
|
2022-06-15 21:44:43 +00:00
|
|
|
"%s [AVG %d runs] : %d (\xC2\xB1 %d) ops/sec; %6.1f (\xC2\xB1 "
|
|
|
|
"%.1f) MB/sec\n",
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
name, num_runs, static_cast<int>(CalcAvg(throughput_ops_)),
|
|
|
|
static_cast<int>(CalcConfidence95(throughput_ops_)),
|
|
|
|
CalcAvg(throughput_mbs_), CalcConfidence95(throughput_mbs_));
|
|
|
|
} else {
|
2022-06-15 21:44:43 +00:00
|
|
|
fprintf(stdout, "%s [AVG %d runs] : %d (\xC2\xB1 %d) ops/sec\n", name,
|
|
|
|
num_runs, static_cast<int>(CalcAvg(throughput_ops_)),
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
static_cast<int>(CalcConfidence95(throughput_ops_)));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void ReportWithConfidenceIntervals(const std::string& bench_name) {
|
|
|
|
if (throughput_ops_.size() < 2) {
|
|
|
|
// skip if there are not enough samples
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
const char* name = bench_name.c_str();
|
|
|
|
int num_runs = static_cast<int>(throughput_ops_.size());
|
|
|
|
|
|
|
|
int ops_avg = static_cast<int>(CalcAvg(throughput_ops_));
|
|
|
|
int ops_confidence_95 = static_cast<int>(CalcConfidence95(throughput_ops_));
|
|
|
|
|
|
|
|
if (throughput_mbs_.size() == throughput_ops_.size()) {
|
|
|
|
double mbs_avg = CalcAvg(throughput_mbs_);
|
|
|
|
double mbs_confidence_95 = CalcConfidence95(throughput_mbs_);
|
|
|
|
fprintf(stdout,
|
|
|
|
"%s [CI95 %d runs] : (%d, %d) ops/sec; (%.1f, %.1f) MB/sec\n",
|
|
|
|
name, num_runs, ops_avg - ops_confidence_95,
|
|
|
|
ops_avg + ops_confidence_95, mbs_avg - mbs_confidence_95,
|
|
|
|
mbs_avg + mbs_confidence_95);
|
|
|
|
} else {
|
|
|
|
fprintf(stdout, "%s [CI95 %d runs] : (%d, %d) ops/sec\n", name, num_runs,
|
|
|
|
ops_avg - ops_confidence_95, ops_avg + ops_confidence_95);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void ReportFinal(const std::string& bench_name) {
|
|
|
|
if (throughput_ops_.size() < 2) {
|
|
|
|
// skip if there are not enough samples
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
const char* name = bench_name.c_str();
|
|
|
|
int num_runs = static_cast<int>(throughput_ops_.size());
|
|
|
|
|
|
|
|
if (throughput_mbs_.size() == throughput_ops_.size()) {
|
2022-06-15 21:44:43 +00:00
|
|
|
// \xC2\xB1 is +/- character in UTF-8
|
2016-08-25 19:57:35 +00:00
|
|
|
fprintf(stdout,
|
2022-06-15 21:44:43 +00:00
|
|
|
"%s [AVG %d runs] : %d (\xC2\xB1 %d) ops/sec; %6.1f (\xC2\xB1 "
|
|
|
|
"%.1f) MB/sec\n"
|
2016-08-25 19:57:35 +00:00
|
|
|
"%s [MEDIAN %d runs] : %d ops/sec; %6.1f MB/sec\n",
|
|
|
|
name, num_runs, static_cast<int>(CalcAvg(throughput_ops_)),
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
static_cast<int>(CalcConfidence95(throughput_ops_)),
|
|
|
|
CalcAvg(throughput_mbs_), CalcConfidence95(throughput_mbs_), name,
|
|
|
|
num_runs, static_cast<int>(CalcMedian(throughput_ops_)),
|
2016-08-25 19:57:35 +00:00
|
|
|
CalcMedian(throughput_mbs_));
|
|
|
|
} else {
|
|
|
|
fprintf(stdout,
|
2022-06-15 21:44:43 +00:00
|
|
|
"%s [AVG %d runs] : %d (\xC2\xB1 %d) ops/sec\n"
|
2016-08-25 19:57:35 +00:00
|
|
|
"%s [MEDIAN %d runs] : %d ops/sec\n",
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
name, num_runs, static_cast<int>(CalcAvg(throughput_ops_)),
|
|
|
|
static_cast<int>(CalcConfidence95(throughput_ops_)), name,
|
2016-08-25 19:57:35 +00:00
|
|
|
num_runs, static_cast<int>(CalcMedian(throughput_ops_)));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
double CalcAvg(std::vector<double>& data) {
|
2016-08-25 19:57:35 +00:00
|
|
|
double avg = 0;
|
|
|
|
for (double x : data) {
|
|
|
|
avg += x;
|
|
|
|
}
|
|
|
|
avg = avg / data.size();
|
|
|
|
return avg;
|
|
|
|
}
|
|
|
|
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
// Calculates 95% CI assuming a normal distribution of samples.
|
|
|
|
// Samples are not from a normal distribution, but it still
|
|
|
|
// provides useful approximation.
|
|
|
|
double CalcConfidence95(std::vector<double>& data) {
|
|
|
|
assert(data.size() > 1);
|
|
|
|
double avg = CalcAvg(data);
|
|
|
|
double std_error = CalcStdDev(data, avg) / std::sqrt(data.size());
|
|
|
|
|
|
|
|
// Z score for the 97.5 percentile
|
|
|
|
// see https://en.wikipedia.org/wiki/1.96
|
|
|
|
return 1.959964 * std_error;
|
|
|
|
}
|
|
|
|
|
|
|
|
double CalcMedian(std::vector<double>& data) {
|
2016-08-25 19:57:35 +00:00
|
|
|
assert(data.size() > 0);
|
|
|
|
std::sort(data.begin(), data.end());
|
|
|
|
|
|
|
|
size_t mid = data.size() / 2;
|
|
|
|
if (data.size() % 2 == 1) {
|
|
|
|
// Odd number of entries
|
|
|
|
return data[mid];
|
|
|
|
} else {
|
|
|
|
// Even number of entries
|
|
|
|
return (data[mid] + data[mid - 1]) / 2;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
double CalcStdDev(std::vector<double>& data, double average) {
|
|
|
|
assert(data.size() > 1);
|
|
|
|
double squared_sum = 0.0;
|
|
|
|
for (double x : data) {
|
|
|
|
squared_sum += std::pow(x - average, 2);
|
|
|
|
}
|
|
|
|
|
|
|
|
// using samples count - 1 following Bessel's correction
|
|
|
|
// see https://en.wikipedia.org/wiki/Bessel%27s_correction
|
|
|
|
return std::sqrt(squared_sum / (data.size() - 1));
|
|
|
|
}
|
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
std::vector<double> throughput_ops_;
|
|
|
|
std::vector<double> throughput_mbs_;
|
|
|
|
};
|
|
|
|
|
2016-08-01 19:28:51 +00:00
|
|
|
class TimestampEmulator {
|
|
|
|
private:
|
|
|
|
std::atomic<uint64_t> timestamp_;
|
|
|
|
|
|
|
|
public:
|
|
|
|
TimestampEmulator() : timestamp_(0) {}
|
|
|
|
uint64_t Get() const { return timestamp_.load(); }
|
|
|
|
void Inc() { timestamp_++; }
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice Allocate(char* scratch) {
|
|
|
|
// TODO: support larger timestamp sizes
|
|
|
|
assert(FLAGS_user_timestamp_size == 8);
|
|
|
|
assert(scratch);
|
|
|
|
uint64_t ts = timestamp_.fetch_add(1);
|
|
|
|
EncodeFixed64(scratch, ts);
|
|
|
|
return Slice(scratch, FLAGS_user_timestamp_size);
|
|
|
|
}
|
|
|
|
Slice GetTimestampForRead(Random64& rand, char* scratch) {
|
|
|
|
assert(FLAGS_user_timestamp_size == 8);
|
|
|
|
assert(scratch);
|
|
|
|
if (FLAGS_read_with_latest_user_timestamp) {
|
|
|
|
return Allocate(scratch);
|
|
|
|
}
|
|
|
|
// Choose a random timestamp from the past.
|
|
|
|
uint64_t ts = rand.Next() % Get();
|
|
|
|
EncodeFixed64(scratch, ts);
|
|
|
|
return Slice(scratch, FLAGS_user_timestamp_size);
|
|
|
|
}
|
2016-08-01 19:28:51 +00:00
|
|
|
};
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
// State shared by all concurrent executions of the same benchmark.
|
|
|
|
struct SharedState {
|
|
|
|
port::Mutex mu;
|
|
|
|
port::CondVar cv;
|
|
|
|
int total;
|
2013-11-18 19:32:54 +00:00
|
|
|
int perf_level;
|
2015-06-17 23:44:52 +00:00
|
|
|
std::shared_ptr<RateLimiter> write_rate_limiter;
|
2016-12-19 20:25:35 +00:00
|
|
|
std::shared_ptr<RateLimiter> read_rate_limiter;
|
2011-08-22 21:08:51 +00:00
|
|
|
|
|
|
|
// Each thread goes through the following states:
|
|
|
|
// (1) initializing
|
|
|
|
// (2) waiting for others to be initialized
|
|
|
|
// (3) running
|
|
|
|
// (4) done
|
|
|
|
|
2012-05-22 19:18:23 +00:00
|
|
|
long num_initialized;
|
|
|
|
long num_done;
|
2011-08-22 21:08:51 +00:00
|
|
|
bool start;
|
|
|
|
|
2013-11-18 19:32:54 +00:00
|
|
|
SharedState() : cv(&mu), perf_level(FLAGS_perf_level) { }
|
2011-08-22 21:08:51 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
// Per-thread state for concurrent executions of the same benchmark.
|
|
|
|
struct ThreadState {
|
|
|
|
int tid; // 0..n-1 when running in n threads
|
2013-08-23 05:37:13 +00:00
|
|
|
Random64 rand; // Has different seeds for different threads
|
2011-08-22 21:08:51 +00:00
|
|
|
Stats stats;
|
2011-09-01 19:08:02 +00:00
|
|
|
SharedState* shared;
|
2011-08-22 21:08:51 +00:00
|
|
|
|
2022-03-25 22:30:28 +00:00
|
|
|
explicit ThreadState(int index, int my_seed)
|
|
|
|
: tid(index), rand(seed_base + my_seed) {}
|
2011-08-22 21:08:51 +00:00
|
|
|
};
|
|
|
|
|
2013-03-01 19:25:13 +00:00
|
|
|
class Duration {
|
|
|
|
public:
|
2015-11-19 19:47:12 +00:00
|
|
|
Duration(uint64_t max_seconds, int64_t max_ops, int64_t ops_per_stage = 0) {
|
2013-03-01 19:25:13 +00:00
|
|
|
max_seconds_ = max_seconds;
|
|
|
|
max_ops_= max_ops;
|
2014-12-23 02:39:28 +00:00
|
|
|
ops_per_stage_ = (ops_per_stage > 0) ? ops_per_stage : max_ops;
|
2013-03-01 19:25:13 +00:00
|
|
|
ops_ = 0;
|
|
|
|
start_at_ = FLAGS_env->NowMicros();
|
|
|
|
}
|
|
|
|
|
2014-12-23 02:39:28 +00:00
|
|
|
int64_t GetStage() { return std::min(ops_, max_ops_ - 1) / ops_per_stage_; }
|
|
|
|
|
2014-04-08 18:21:09 +00:00
|
|
|
bool Done(int64_t increment) {
|
2013-06-12 19:42:21 +00:00
|
|
|
if (increment <= 0) increment = 1; // avoid Done(0) and infinite loops
|
2013-03-01 19:25:13 +00:00
|
|
|
ops_ += increment;
|
|
|
|
|
|
|
|
if (max_seconds_) {
|
2013-06-12 19:42:21 +00:00
|
|
|
// Recheck every appx 1000 ops (exact iff increment is factor of 1000)
|
2017-06-15 23:06:22 +00:00
|
|
|
auto granularity = FLAGS_ops_between_duration_checks;
|
|
|
|
if ((ops_ / granularity) != ((ops_ - increment) / granularity)) {
|
2015-11-19 19:47:12 +00:00
|
|
|
uint64_t now = FLAGS_env->NowMicros();
|
|
|
|
return ((now - start_at_) / 1000000) >= max_seconds_;
|
2013-03-01 19:25:13 +00:00
|
|
|
} else {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
return ops_ > max_ops_;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
2015-11-19 19:47:12 +00:00
|
|
|
uint64_t max_seconds_;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t max_ops_;
|
2014-12-23 02:39:28 +00:00
|
|
|
int64_t ops_per_stage_;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t ops_;
|
2015-11-19 19:47:12 +00:00
|
|
|
uint64_t start_at_;
|
2013-03-01 19:25:13 +00:00
|
|
|
};
|
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
class Benchmark {
|
|
|
|
private:
|
2014-08-25 21:22:05 +00:00
|
|
|
std::shared_ptr<Cache> cache_;
|
|
|
|
std::shared_ptr<Cache> compressed_cache_;
|
2022-05-19 20:09:03 +00:00
|
|
|
std::shared_ptr<const SliceTransform> prefix_extractor_;
|
2014-08-19 01:15:01 +00:00
|
|
|
DBWithColumnFamilies db_;
|
|
|
|
std::vector<DBWithColumnFamilies> multi_dbs_;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t num_;
|
2013-03-01 22:10:09 +00:00
|
|
|
int key_size_;
|
2020-09-16 03:04:58 +00:00
|
|
|
int user_timestamp_size_;
|
2014-03-05 01:08:05 +00:00
|
|
|
int prefix_size_;
|
2022-03-24 15:57:48 +00:00
|
|
|
int total_thread_count_;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t keys_per_prefix_;
|
2014-04-08 18:21:09 +00:00
|
|
|
int64_t entries_per_batch_;
|
2018-10-19 00:16:36 +00:00
|
|
|
int64_t writes_before_delete_range_;
|
2016-11-16 01:33:27 +00:00
|
|
|
int64_t writes_per_range_tombstone_;
|
|
|
|
int64_t range_tombstone_width_;
|
|
|
|
int64_t max_num_range_tombstones_;
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions read_options_;
|
2011-08-22 21:08:51 +00:00
|
|
|
WriteOptions write_options_;
|
2014-12-23 02:39:28 +00:00
|
|
|
Options open_options_; // keep options around to properly destroy db later
|
2018-11-27 05:32:02 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2018-08-01 07:14:43 +00:00
|
|
|
TraceOptions trace_options_;
|
2019-06-17 18:03:47 +00:00
|
|
|
TraceOptions block_cache_trace_options_;
|
2018-11-27 05:32:02 +00:00
|
|
|
#endif
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t reads_;
|
2016-06-28 21:10:24 +00:00
|
|
|
int64_t deletes_;
|
2015-03-07 00:38:50 +00:00
|
|
|
double read_random_exp_range_;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t writes_;
|
|
|
|
int64_t readwrites_;
|
|
|
|
int64_t merge_keys_;
|
2014-10-29 21:24:34 +00:00
|
|
|
bool report_file_operations_;
|
2021-02-17 19:08:12 +00:00
|
|
|
bool use_blob_db_; // Stacked BlobDB
|
2022-04-01 04:23:58 +00:00
|
|
|
bool read_operands_; // read via GetMergeOperands()
|
2019-03-01 19:14:28 +00:00
|
|
|
std::vector<std::string> keys_;
|
2014-06-23 17:46:16 +00:00
|
|
|
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
class ErrorHandlerListener : public EventListener {
|
|
|
|
public:
|
2019-02-16 00:10:37 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
ErrorHandlerListener()
|
|
|
|
: mutex_(),
|
|
|
|
cv_(&mutex_),
|
|
|
|
no_auto_recovery_(false),
|
|
|
|
recovery_complete_(false) {}
|
|
|
|
|
2019-02-14 21:52:47 +00:00
|
|
|
~ErrorHandlerListener() override {}
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
|
2021-07-27 14:46:09 +00:00
|
|
|
const char* Name() const override { return kClassName(); }
|
|
|
|
static const char* kClassName() { return "ErrorHandlerListener"; }
|
|
|
|
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
void OnErrorRecoveryBegin(BackgroundErrorReason /*reason*/,
|
2019-02-14 21:52:47 +00:00
|
|
|
Status /*bg_error*/,
|
|
|
|
bool* auto_recovery) override {
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
if (*auto_recovery && no_auto_recovery_) {
|
|
|
|
*auto_recovery = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-02-14 21:52:47 +00:00
|
|
|
void OnErrorRecoveryCompleted(Status /*old_bg_error*/) override {
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
InstrumentedMutexLock l(&mutex_);
|
|
|
|
recovery_complete_ = true;
|
|
|
|
cv_.SignalAll();
|
|
|
|
}
|
|
|
|
|
2019-05-13 18:26:34 +00:00
|
|
|
bool WaitForRecovery(uint64_t abs_time_us) {
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
InstrumentedMutexLock l(&mutex_);
|
|
|
|
if (!recovery_complete_) {
|
2019-05-13 18:26:34 +00:00
|
|
|
cv_.TimedWait(abs_time_us);
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
}
|
|
|
|
if (recovery_complete_) {
|
|
|
|
recovery_complete_ = false;
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
void EnableAutoRecovery(bool enable = true) { no_auto_recovery_ = !enable; }
|
|
|
|
|
|
|
|
private:
|
|
|
|
InstrumentedMutex mutex_;
|
|
|
|
InstrumentedCondVar cv_;
|
|
|
|
bool no_auto_recovery_;
|
|
|
|
bool recovery_complete_;
|
2019-02-16 00:10:37 +00:00
|
|
|
#else // ROCKSDB_LITE
|
|
|
|
bool WaitForRecovery(uint64_t /*abs_time_us*/) { return true; }
|
|
|
|
void EnableAutoRecovery(bool /*enable*/) {}
|
|
|
|
#endif // ROCKSDB_LITE
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
std::shared_ptr<ErrorHandlerListener> listener_;
|
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<TimestampEmulator> mock_app_clock_;
|
|
|
|
|
2014-06-23 17:46:16 +00:00
|
|
|
bool SanityCheck() {
|
|
|
|
if (FLAGS_compression_ratio > 1) {
|
|
|
|
fprintf(stderr, "compression_ratio should be between 0 and 1\n");
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2019-01-19 03:10:17 +00:00
|
|
|
inline bool CompressSlice(const CompressionInfo& compression_info,
|
2018-06-05 19:51:05 +00:00
|
|
|
const Slice& input, std::string* compressed) {
|
2020-09-25 16:00:29 +00:00
|
|
|
constexpr uint32_t compress_format_version = 2;
|
|
|
|
|
|
|
|
return CompressData(input, compression_info, compress_format_version,
|
|
|
|
compressed);
|
2015-08-11 18:46:15 +00:00
|
|
|
}
|
|
|
|
|
2021-09-08 14:45:59 +00:00
|
|
|
void PrintHeader(const Options& options) {
|
2011-03-22 18:32:49 +00:00
|
|
|
PrintEnvironment();
|
2020-09-16 03:04:58 +00:00
|
|
|
fprintf(stdout,
|
|
|
|
"Keys: %d bytes each (+ %d bytes user-defined timestamp)\n",
|
|
|
|
FLAGS_key_size, FLAGS_user_timestamp_size);
|
2020-02-12 22:44:46 +00:00
|
|
|
auto avg_value_size = FLAGS_value_size;
|
|
|
|
if (FLAGS_value_size_distribution_type_e == kFixed) {
|
|
|
|
fprintf(stdout, "Values: %d bytes each (%d bytes after compression)\n",
|
|
|
|
avg_value_size,
|
|
|
|
static_cast<int>(avg_value_size * FLAGS_compression_ratio + 0.5));
|
|
|
|
} else {
|
|
|
|
avg_value_size = (FLAGS_value_size_min + FLAGS_value_size_max) / 2;
|
|
|
|
fprintf(stdout, "Values: %d avg bytes each (%d bytes after compression)\n",
|
|
|
|
avg_value_size,
|
|
|
|
static_cast<int>(avg_value_size * FLAGS_compression_ratio + 0.5));
|
|
|
|
fprintf(stdout, "Values Distribution: %s (min: %d, max: %d)\n",
|
|
|
|
FLAGS_value_size_distribution_type.c_str(),
|
|
|
|
FLAGS_value_size_min, FLAGS_value_size_max);
|
|
|
|
}
|
2014-03-05 01:08:05 +00:00
|
|
|
fprintf(stdout, "Entries: %" PRIu64 "\n", num_);
|
|
|
|
fprintf(stdout, "Prefix: %d bytes\n", FLAGS_prefix_size);
|
|
|
|
fprintf(stdout, "Keys per prefix: %" PRIu64 "\n", keys_per_prefix_);
|
2011-03-22 18:32:49 +00:00
|
|
|
fprintf(stdout, "RawSize: %.1f MB (estimated)\n",
|
2020-02-12 22:44:46 +00:00
|
|
|
((static_cast<int64_t>(FLAGS_key_size + avg_value_size) * num_)
|
2011-04-12 19:38:58 +00:00
|
|
|
/ 1048576.0));
|
2011-03-22 18:32:49 +00:00
|
|
|
fprintf(stdout, "FileSize: %.1f MB (estimated)\n",
|
2020-02-12 22:44:46 +00:00
|
|
|
(((FLAGS_key_size + avg_value_size * FLAGS_compression_ratio)
|
2013-10-24 14:43:14 +00:00
|
|
|
* num_)
|
2011-03-22 18:32:49 +00:00
|
|
|
/ 1048576.0));
|
2016-01-04 20:01:27 +00:00
|
|
|
fprintf(stdout, "Write rate: %" PRIu64 " bytes/second\n",
|
|
|
|
FLAGS_benchmark_write_rate_limit);
|
2016-12-19 20:25:35 +00:00
|
|
|
fprintf(stdout, "Read rate: %" PRIu64 " ops/second\n",
|
|
|
|
FLAGS_benchmark_read_rate_limit);
|
2014-07-07 17:53:31 +00:00
|
|
|
if (FLAGS_enable_numa) {
|
|
|
|
fprintf(stderr, "Running in NUMA enabled mode.\n");
|
|
|
|
#ifndef NUMA
|
|
|
|
fprintf(stderr, "NUMA is not defined in the system.\n");
|
|
|
|
exit(1);
|
|
|
|
#else
|
|
|
|
if (numa_available() == -1) {
|
|
|
|
fprintf(stderr, "NUMA is not supported by the system.\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
}
|
2015-08-11 18:46:15 +00:00
|
|
|
|
2015-12-17 20:22:36 +00:00
|
|
|
auto compression = CompressionTypeToString(FLAGS_compression_type_e);
|
|
|
|
fprintf(stdout, "Compression: %s\n", compression.c_str());
|
2019-03-18 19:07:35 +00:00
|
|
|
fprintf(stdout, "Compression sampling rate: %" PRId64 "\n",
|
|
|
|
FLAGS_sample_for_compression);
|
2021-09-08 14:45:59 +00:00
|
|
|
if (options.memtable_factory != nullptr) {
|
|
|
|
fprintf(stdout, "Memtablerep: %s\n",
|
|
|
|
options.memtable_factory->GetId().c_str());
|
2013-08-23 06:10:02 +00:00
|
|
|
}
|
2013-11-18 19:32:54 +00:00
|
|
|
fprintf(stdout, "Perf Level: %d\n", FLAGS_perf_level);
|
2013-08-23 06:10:02 +00:00
|
|
|
|
2015-12-17 20:22:36 +00:00
|
|
|
PrintWarnings(compression.c_str());
|
2011-03-22 18:32:49 +00:00
|
|
|
fprintf(stdout, "------------------------------------------------\n");
|
|
|
|
}
|
|
|
|
|
2015-08-11 18:46:15 +00:00
|
|
|
void PrintWarnings(const char* compression) {
|
2011-03-22 18:32:49 +00:00
|
|
|
#if defined(__GNUC__) && !defined(__OPTIMIZE__)
|
|
|
|
fprintf(stdout,
|
|
|
|
"WARNING: Optimization is disabled: benchmarks unnecessarily slow\n"
|
|
|
|
);
|
|
|
|
#endif
|
|
|
|
#ifndef NDEBUG
|
|
|
|
fprintf(stdout,
|
|
|
|
"WARNING: Assertions are enabled; benchmarks unnecessarily slow\n");
|
|
|
|
#endif
|
2020-02-20 20:07:53 +00:00
|
|
|
if (FLAGS_compression_type_e != ROCKSDB_NAMESPACE::kNoCompression) {
|
2012-09-14 18:21:54 +00:00
|
|
|
// The test string should not be too small.
|
|
|
|
const int len = FLAGS_block_size;
|
2015-08-11 18:46:15 +00:00
|
|
|
std::string input_str(len, 'y');
|
2012-09-14 18:21:54 +00:00
|
|
|
std::string compressed;
|
2019-01-19 03:10:17 +00:00
|
|
|
CompressionOptions opts;
|
|
|
|
CompressionContext context(FLAGS_compression_type_e);
|
|
|
|
CompressionInfo info(opts, context, CompressionDict::GetEmptyDict(),
|
2019-03-18 19:07:35 +00:00
|
|
|
FLAGS_compression_type_e,
|
|
|
|
FLAGS_sample_for_compression);
|
2019-01-19 03:10:17 +00:00
|
|
|
bool result = CompressSlice(info, Slice(input_str), &compressed);
|
2012-09-14 18:21:54 +00:00
|
|
|
|
|
|
|
if (!result) {
|
2015-08-11 18:46:15 +00:00
|
|
|
fprintf(stdout, "WARNING: %s compression is not enabled\n",
|
|
|
|
compression);
|
|
|
|
} else if (compressed.size() >= input_str.size()) {
|
|
|
|
fprintf(stdout, "WARNING: %s compression is not effective\n",
|
|
|
|
compression);
|
2012-09-14 18:21:54 +00:00
|
|
|
}
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
2011-03-22 18:32:49 +00:00
|
|
|
}
|
|
|
|
|
2013-11-17 07:44:39 +00:00
|
|
|
// Current the following isn't equivalent to OS_LINUX.
|
|
|
|
#if defined(__linux)
|
|
|
|
static Slice TrimSpace(Slice s) {
|
|
|
|
unsigned int start = 0;
|
|
|
|
while (start < s.size() && isspace(s[start])) {
|
|
|
|
start++;
|
|
|
|
}
|
2014-11-21 19:20:42 +00:00
|
|
|
unsigned int limit = static_cast<unsigned int>(s.size());
|
2013-11-17 07:44:39 +00:00
|
|
|
while (limit > start && isspace(s[limit-1])) {
|
|
|
|
limit--;
|
|
|
|
}
|
|
|
|
return Slice(s.data() + start, limit - start);
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
2011-03-22 18:32:49 +00:00
|
|
|
void PrintEnvironment() {
|
2022-07-06 16:58:45 +00:00
|
|
|
fprintf(stderr, "RocksDB: version %s\n",
|
|
|
|
GetRocksVersionAsString(true).c_str());
|
2011-03-22 18:32:49 +00:00
|
|
|
|
2021-04-09 17:34:01 +00:00
|
|
|
#if defined(__linux) || defined(__APPLE__) || defined(__FreeBSD__)
|
2013-02-15 19:53:17 +00:00
|
|
|
time_t now = time(nullptr);
|
2015-12-15 23:26:20 +00:00
|
|
|
char buf[52];
|
|
|
|
// Lint complains about ctime() usage, so replace it with ctime_r(). The
|
|
|
|
// requirement is to provide a buffer which is at least 26 bytes.
|
|
|
|
fprintf(stderr, "Date: %s",
|
|
|
|
ctime_r(&now, buf)); // ctime_r() adds newline
|
2011-03-22 18:32:49 +00:00
|
|
|
|
2021-02-10 20:55:24 +00:00
|
|
|
#if defined(__linux)
|
2011-03-22 18:32:49 +00:00
|
|
|
FILE* cpuinfo = fopen("/proc/cpuinfo", "r");
|
2013-02-15 19:53:17 +00:00
|
|
|
if (cpuinfo != nullptr) {
|
2011-03-22 18:32:49 +00:00
|
|
|
char line[1000];
|
|
|
|
int num_cpus = 0;
|
|
|
|
std::string cpu_type;
|
|
|
|
std::string cache_size;
|
2013-02-15 19:53:17 +00:00
|
|
|
while (fgets(line, sizeof(line), cpuinfo) != nullptr) {
|
2011-03-22 18:32:49 +00:00
|
|
|
const char* sep = strchr(line, ':');
|
2013-02-15 19:53:17 +00:00
|
|
|
if (sep == nullptr) {
|
2011-03-22 18:32:49 +00:00
|
|
|
continue;
|
|
|
|
}
|
|
|
|
Slice key = TrimSpace(Slice(line, sep - 1 - line));
|
|
|
|
Slice val = TrimSpace(Slice(sep + 1));
|
|
|
|
if (key == "model name") {
|
|
|
|
++num_cpus;
|
|
|
|
cpu_type = val.ToString();
|
|
|
|
} else if (key == "cache size") {
|
|
|
|
cache_size = val.ToString();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
fclose(cpuinfo);
|
|
|
|
fprintf(stderr, "CPU: %d * %s\n", num_cpus, cpu_type.c_str());
|
|
|
|
fprintf(stderr, "CPUCache: %s\n", cache_size.c_str());
|
|
|
|
}
|
2021-02-10 20:55:24 +00:00
|
|
|
#elif defined(__APPLE__)
|
|
|
|
struct host_basic_info h;
|
|
|
|
size_t hlen = HOST_BASIC_INFO_COUNT;
|
|
|
|
if (host_info(mach_host_self(), HOST_BASIC_INFO, (host_info_t)&h,
|
|
|
|
(uint32_t*)&hlen) == KERN_SUCCESS) {
|
|
|
|
std::string cpu_type;
|
|
|
|
std::string cache_size;
|
|
|
|
size_t hcache_size;
|
|
|
|
hlen = sizeof(hcache_size);
|
|
|
|
if (sysctlbyname("hw.cachelinesize", &hcache_size, &hlen, NULL, 0) == 0) {
|
|
|
|
cache_size = std::to_string(hcache_size);
|
|
|
|
}
|
|
|
|
switch (h.cpu_type) {
|
|
|
|
case CPU_TYPE_X86_64:
|
|
|
|
cpu_type = "x86_64";
|
|
|
|
break;
|
|
|
|
case CPU_TYPE_ARM64:
|
|
|
|
cpu_type = "arm64";
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
fprintf(stderr, "CPU: %d * %s\n", h.max_cpus, cpu_type.c_str());
|
|
|
|
fprintf(stderr, "CPUCache: %s\n", cache_size.c_str());
|
|
|
|
}
|
2021-04-09 17:34:01 +00:00
|
|
|
#elif defined(__FreeBSD__)
|
|
|
|
int ncpus;
|
|
|
|
size_t len = sizeof(ncpus);
|
|
|
|
int mib[2] = {CTL_HW, HW_NCPU};
|
|
|
|
if (sysctl(mib, 2, &ncpus, &len, nullptr, 0) == 0) {
|
|
|
|
char cpu_type[16];
|
|
|
|
len = sizeof(cpu_type) - 1;
|
|
|
|
mib[1] = HW_MACHINE;
|
|
|
|
if (sysctl(mib, 2, cpu_type, &len, nullptr, 0) == 0) cpu_type[len] = 0;
|
|
|
|
|
|
|
|
fprintf(stderr, "CPU: %d * %s\n", ncpus, cpu_type);
|
|
|
|
// no programmatic way to get the cache line size except on PPC
|
|
|
|
}
|
2021-02-10 20:55:24 +00:00
|
|
|
#endif
|
2011-03-22 18:32:49 +00:00
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
2016-08-01 19:28:51 +00:00
|
|
|
static bool KeyExpired(const TimestampEmulator* timestamp_emulator,
|
|
|
|
const Slice& key) {
|
|
|
|
const char* pos = key.data();
|
|
|
|
pos += 8;
|
|
|
|
uint64_t timestamp = 0;
|
|
|
|
if (port::kLittleEndian) {
|
|
|
|
int bytes_to_fill = 8;
|
|
|
|
for (int i = 0; i < bytes_to_fill; ++i) {
|
|
|
|
timestamp |= (static_cast<uint64_t>(static_cast<unsigned char>(pos[i]))
|
|
|
|
<< ((bytes_to_fill - i - 1) << 3));
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
memcpy(×tamp, pos, sizeof(timestamp));
|
|
|
|
}
|
|
|
|
return timestamp_emulator->Get() - timestamp > FLAGS_time_range;
|
|
|
|
}
|
|
|
|
|
|
|
|
class ExpiredTimeFilter : public CompactionFilter {
|
|
|
|
public:
|
|
|
|
explicit ExpiredTimeFilter(
|
|
|
|
const std::shared_ptr<TimestampEmulator>& timestamp_emulator)
|
|
|
|
: timestamp_emulator_(timestamp_emulator) {}
|
2018-03-05 21:08:17 +00:00
|
|
|
bool Filter(int /*level*/, const Slice& key,
|
|
|
|
const Slice& /*existing_value*/, std::string* /*new_value*/,
|
|
|
|
bool* /*value_changed*/) const override {
|
2016-08-01 19:28:51 +00:00
|
|
|
return KeyExpired(timestamp_emulator_.get(), key);
|
|
|
|
}
|
|
|
|
const char* Name() const override { return "ExpiredTimeFilter"; }
|
|
|
|
|
|
|
|
private:
|
|
|
|
std::shared_ptr<TimestampEmulator> timestamp_emulator_;
|
|
|
|
};
|
|
|
|
|
2018-07-13 02:33:59 +00:00
|
|
|
class KeepFilter : public CompactionFilter {
|
|
|
|
public:
|
2019-02-14 21:52:47 +00:00
|
|
|
bool Filter(int /*level*/, const Slice& /*key*/, const Slice& /*value*/,
|
|
|
|
std::string* /*new_value*/,
|
|
|
|
bool* /*value_changed*/) const override {
|
2018-07-13 02:33:59 +00:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2019-02-14 21:52:47 +00:00
|
|
|
const char* Name() const override { return "KeepFilter"; }
|
2018-07-13 02:33:59 +00:00
|
|
|
};
|
|
|
|
|
2016-08-19 19:28:19 +00:00
|
|
|
std::shared_ptr<Cache> NewCache(int64_t capacity) {
|
|
|
|
if (capacity <= 0) {
|
|
|
|
return nullptr;
|
|
|
|
}
|
2022-06-03 18:16:49 +00:00
|
|
|
if (FLAGS_cache_type == "clock_cache") {
|
2022-07-13 15:45:44 +00:00
|
|
|
auto cache = ExperimentalNewClockCache(
|
|
|
|
static_cast<size_t>(capacity), FLAGS_block_size,
|
|
|
|
FLAGS_cache_numshardbits, false /*strict_capacity_limit*/,
|
|
|
|
kDefaultCacheMetadataChargePolicy);
|
2016-08-19 19:28:19 +00:00
|
|
|
if (!cache) {
|
|
|
|
fprintf(stderr, "Clock cache not supported.");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
return cache;
|
2022-06-03 18:16:49 +00:00
|
|
|
} else if (FLAGS_cache_type == "fast_lru_cache") {
|
2022-06-14 03:29:00 +00:00
|
|
|
return NewFastLRUCache(static_cast<size_t>(capacity), FLAGS_block_size,
|
|
|
|
FLAGS_cache_numshardbits,
|
|
|
|
false /*strict_capacity_limit*/,
|
|
|
|
kDefaultCacheMetadataChargePolicy);
|
2022-06-03 18:16:49 +00:00
|
|
|
} else if (FLAGS_cache_type == "lru_cache") {
|
2021-05-19 22:24:37 +00:00
|
|
|
LRUCacheOptions opts(
|
|
|
|
static_cast<size_t>(capacity), FLAGS_cache_numshardbits,
|
|
|
|
false /*strict_capacity_limit*/, FLAGS_cache_high_pri_pool_ratio,
|
Provide an allocator for new memory type to be used with RocksDB block cache (#6214)
Summary:
New memory technologies are being developed by various hardware vendors (Intel DCPMM is one such technology currently available). These new memory types require different libraries for allocation and management (such as PMDK and memkind). The high capacities available make it possible to provision large caches (up to several TBs in size), beyond what is achievable with DRAM.
The new allocator provided in this PR uses the memkind library to allocate memory on different media.
**Performance**
We tested the new allocator using db_bench.
- For each test, we vary the size of the block cache (relative to the size of the uncompressed data in the database).
- The database is filled sequentially. Throughput is then measured with a readrandom benchmark.
- We use a uniform distribution as a worst-case scenario.
The plot shows throughput (ops/s) relative to a configuration with no block cache and default allocator.
For all tests, p99 latency is below 500 us.
![image](https://user-images.githubusercontent.com/26400080/71108594-42479100-2178-11ea-8231-8a775bbc92db.png)
**Changes**
- Add MemkindKmemAllocator
- Add --use_cache_memkind_kmem_allocator db_bench option (to create an LRU block cache with the new allocator)
- Add detection of memkind library with KMEM DAX support
- Add test for MemkindKmemAllocator
**Minimum Requirements**
- kernel 5.3.12
- ndctl v67 - https://github.com/pmem/ndctl
- memkind v1.10.0 - https://github.com/memkind/memkind
**Memory Configuration**
The allocator uses the MEMKIND_DAX_KMEM memory kind. Follow the instructions on[ memkind’s GitHub page](https://github.com/memkind/memkind) to set up NVDIMM memory accordingly.
Note on memory allocation with NVDIMM memory exposed as system memory.
- The MemkindKmemAllocator will only allocate from NVDIMM memory (using memkind_malloc with MEMKIND_DAX_KMEM kind).
- The default allocator is not restricted to RAM by default. Based on NUMA node latency, the kernel should allocate from local RAM preferentially, but it’s a kernel decision. numactl --preferred/--membind can be used to allocate preferentially/exclusively from the local RAM node.
**Usage**
When creating an LRU cache, pass a MemkindKmemAllocator object as argument.
For example (replace capacity with the desired value in bytes):
```
#include "rocksdb/cache.h"
#include "memory/memkind_kmem_allocator.h"
NewLRUCache(
capacity /*size_t*/,
6 /*cache_numshardbits*/,
false /*strict_capacity_limit*/,
false /*cache_high_pri_pool_ratio*/,
std::make_shared<MemkindKmemAllocator>());
```
Refer to [RocksDB’s block cache documentation](https://github.com/facebook/rocksdb/wiki/Block-Cache) to assign the LRU cache as block cache for a database.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6214
Reviewed By: cheng-chang
Differential Revision: D19292435
fbshipit-source-id: 7202f47b769e7722b539c86c2ffd669f64d7b4e1
2020-04-10 03:45:17 +00:00
|
|
|
#ifdef MEMKIND
|
2021-05-19 22:24:37 +00:00
|
|
|
FLAGS_use_cache_memkind_kmem_allocator
|
|
|
|
? std::make_shared<MemkindKmemAllocator>()
|
2022-08-13 00:59:06 +00:00
|
|
|
: nullptr,
|
Provide an allocator for new memory type to be used with RocksDB block cache (#6214)
Summary:
New memory technologies are being developed by various hardware vendors (Intel DCPMM is one such technology currently available). These new memory types require different libraries for allocation and management (such as PMDK and memkind). The high capacities available make it possible to provision large caches (up to several TBs in size), beyond what is achievable with DRAM.
The new allocator provided in this PR uses the memkind library to allocate memory on different media.
**Performance**
We tested the new allocator using db_bench.
- For each test, we vary the size of the block cache (relative to the size of the uncompressed data in the database).
- The database is filled sequentially. Throughput is then measured with a readrandom benchmark.
- We use a uniform distribution as a worst-case scenario.
The plot shows throughput (ops/s) relative to a configuration with no block cache and default allocator.
For all tests, p99 latency is below 500 us.
![image](https://user-images.githubusercontent.com/26400080/71108594-42479100-2178-11ea-8231-8a775bbc92db.png)
**Changes**
- Add MemkindKmemAllocator
- Add --use_cache_memkind_kmem_allocator db_bench option (to create an LRU block cache with the new allocator)
- Add detection of memkind library with KMEM DAX support
- Add test for MemkindKmemAllocator
**Minimum Requirements**
- kernel 5.3.12
- ndctl v67 - https://github.com/pmem/ndctl
- memkind v1.10.0 - https://github.com/memkind/memkind
**Memory Configuration**
The allocator uses the MEMKIND_DAX_KMEM memory kind. Follow the instructions on[ memkind’s GitHub page](https://github.com/memkind/memkind) to set up NVDIMM memory accordingly.
Note on memory allocation with NVDIMM memory exposed as system memory.
- The MemkindKmemAllocator will only allocate from NVDIMM memory (using memkind_malloc with MEMKIND_DAX_KMEM kind).
- The default allocator is not restricted to RAM by default. Based on NUMA node latency, the kernel should allocate from local RAM preferentially, but it’s a kernel decision. numactl --preferred/--membind can be used to allocate preferentially/exclusively from the local RAM node.
**Usage**
When creating an LRU cache, pass a MemkindKmemAllocator object as argument.
For example (replace capacity with the desired value in bytes):
```
#include "rocksdb/cache.h"
#include "memory/memkind_kmem_allocator.h"
NewLRUCache(
capacity /*size_t*/,
6 /*cache_numshardbits*/,
false /*strict_capacity_limit*/,
false /*cache_high_pri_pool_ratio*/,
std::make_shared<MemkindKmemAllocator>());
```
Refer to [RocksDB’s block cache documentation](https://github.com/facebook/rocksdb/wiki/Block-Cache) to assign the LRU cache as block cache for a database.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6214
Reviewed By: cheng-chang
Differential Revision: D19292435
fbshipit-source-id: 7202f47b769e7722b539c86c2ffd669f64d7b4e1
2020-04-10 03:45:17 +00:00
|
|
|
#else
|
2022-08-13 00:59:06 +00:00
|
|
|
nullptr,
|
2021-05-19 22:24:37 +00:00
|
|
|
#endif
|
2022-08-13 00:59:06 +00:00
|
|
|
kDefaultToAdaptiveMutex, kDefaultCacheMetadataChargePolicy,
|
|
|
|
FLAGS_cache_low_pri_pool_ratio);
|
2021-05-19 22:24:37 +00:00
|
|
|
if (FLAGS_use_cache_memkind_kmem_allocator) {
|
|
|
|
#ifndef MEMKIND
|
Provide an allocator for new memory type to be used with RocksDB block cache (#6214)
Summary:
New memory technologies are being developed by various hardware vendors (Intel DCPMM is one such technology currently available). These new memory types require different libraries for allocation and management (such as PMDK and memkind). The high capacities available make it possible to provision large caches (up to several TBs in size), beyond what is achievable with DRAM.
The new allocator provided in this PR uses the memkind library to allocate memory on different media.
**Performance**
We tested the new allocator using db_bench.
- For each test, we vary the size of the block cache (relative to the size of the uncompressed data in the database).
- The database is filled sequentially. Throughput is then measured with a readrandom benchmark.
- We use a uniform distribution as a worst-case scenario.
The plot shows throughput (ops/s) relative to a configuration with no block cache and default allocator.
For all tests, p99 latency is below 500 us.
![image](https://user-images.githubusercontent.com/26400080/71108594-42479100-2178-11ea-8231-8a775bbc92db.png)
**Changes**
- Add MemkindKmemAllocator
- Add --use_cache_memkind_kmem_allocator db_bench option (to create an LRU block cache with the new allocator)
- Add detection of memkind library with KMEM DAX support
- Add test for MemkindKmemAllocator
**Minimum Requirements**
- kernel 5.3.12
- ndctl v67 - https://github.com/pmem/ndctl
- memkind v1.10.0 - https://github.com/memkind/memkind
**Memory Configuration**
The allocator uses the MEMKIND_DAX_KMEM memory kind. Follow the instructions on[ memkind’s GitHub page](https://github.com/memkind/memkind) to set up NVDIMM memory accordingly.
Note on memory allocation with NVDIMM memory exposed as system memory.
- The MemkindKmemAllocator will only allocate from NVDIMM memory (using memkind_malloc with MEMKIND_DAX_KMEM kind).
- The default allocator is not restricted to RAM by default. Based on NUMA node latency, the kernel should allocate from local RAM preferentially, but it’s a kernel decision. numactl --preferred/--membind can be used to allocate preferentially/exclusively from the local RAM node.
**Usage**
When creating an LRU cache, pass a MemkindKmemAllocator object as argument.
For example (replace capacity with the desired value in bytes):
```
#include "rocksdb/cache.h"
#include "memory/memkind_kmem_allocator.h"
NewLRUCache(
capacity /*size_t*/,
6 /*cache_numshardbits*/,
false /*strict_capacity_limit*/,
false /*cache_high_pri_pool_ratio*/,
std::make_shared<MemkindKmemAllocator>());
```
Refer to [RocksDB’s block cache documentation](https://github.com/facebook/rocksdb/wiki/Block-Cache) to assign the LRU cache as block cache for a database.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6214
Reviewed By: cheng-chang
Differential Revision: D19292435
fbshipit-source-id: 7202f47b769e7722b539c86c2ffd669f64d7b4e1
2020-04-10 03:45:17 +00:00
|
|
|
fprintf(stderr, "Memkind library is not linked with the binary.");
|
|
|
|
exit(1);
|
|
|
|
#endif
|
|
|
|
}
|
2021-05-19 22:24:37 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
if (!FLAGS_secondary_cache_uri.empty()) {
|
2021-07-06 16:17:13 +00:00
|
|
|
Status s = SecondaryCache::CreateFromString(
|
|
|
|
ConfigOptions(), FLAGS_secondary_cache_uri, &secondary_cache);
|
2021-05-19 22:24:37 +00:00
|
|
|
if (secondary_cache == nullptr) {
|
|
|
|
fprintf(
|
|
|
|
stderr,
|
|
|
|
"No secondary cache registered matching string: %s status=%s\n",
|
|
|
|
FLAGS_secondary_cache_uri.c_str(), s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
opts.secondary_cache = secondary_cache;
|
|
|
|
}
|
|
|
|
#endif // ROCKSDB_LITE
|
2022-02-24 00:06:27 +00:00
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
if (FLAGS_use_compressed_secondary_cache) {
|
|
|
|
CompressedSecondaryCacheOptions secondary_cache_opts;
|
|
|
|
secondary_cache_opts.capacity = FLAGS_compressed_secondary_cache_size;
|
2022-02-24 00:06:27 +00:00
|
|
|
secondary_cache_opts.num_shard_bits =
|
2022-04-11 20:28:33 +00:00
|
|
|
FLAGS_compressed_secondary_cache_numshardbits;
|
2022-02-24 00:06:27 +00:00
|
|
|
secondary_cache_opts.high_pri_pool_ratio =
|
2022-04-11 20:28:33 +00:00
|
|
|
FLAGS_compressed_secondary_cache_high_pri_pool_ratio;
|
2022-08-13 00:59:06 +00:00
|
|
|
secondary_cache_opts.low_pri_pool_ratio =
|
|
|
|
FLAGS_compressed_secondary_cache_low_pri_pool_ratio;
|
2022-02-24 00:06:27 +00:00
|
|
|
secondary_cache_opts.compression_type =
|
2022-04-11 20:28:33 +00:00
|
|
|
FLAGS_compressed_secondary_cache_compression_type_e;
|
2022-02-24 00:06:27 +00:00
|
|
|
secondary_cache_opts.compress_format_version =
|
2022-04-11 20:28:33 +00:00
|
|
|
FLAGS_compressed_secondary_cache_compress_format_version;
|
|
|
|
opts.secondary_cache =
|
|
|
|
NewCompressedSecondaryCache(secondary_cache_opts);
|
2022-02-24 00:06:27 +00:00
|
|
|
}
|
|
|
|
|
2021-05-19 22:24:37 +00:00
|
|
|
return NewLRUCache(opts);
|
2022-06-03 18:16:49 +00:00
|
|
|
} else {
|
|
|
|
fprintf(stderr, "Cache type not supported.");
|
|
|
|
exit(1);
|
2016-08-19 19:28:19 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
public:
|
2011-04-12 19:38:58 +00:00
|
|
|
Benchmark()
|
2016-08-19 19:28:19 +00:00
|
|
|
: cache_(NewCache(FLAGS_cache_size)),
|
|
|
|
compressed_cache_(NewCache(FLAGS_compressed_cache_size)),
|
2022-05-19 20:09:03 +00:00
|
|
|
prefix_extractor_(FLAGS_prefix_size != 0
|
|
|
|
? NewFixedPrefixTransform(FLAGS_prefix_size)
|
|
|
|
: nullptr),
|
2015-03-07 00:38:50 +00:00
|
|
|
num_(FLAGS_num),
|
|
|
|
key_size_(FLAGS_key_size),
|
2020-09-16 03:04:58 +00:00
|
|
|
user_timestamp_size_(FLAGS_user_timestamp_size),
|
2015-03-07 00:38:50 +00:00
|
|
|
prefix_size_(FLAGS_prefix_size),
|
2022-03-24 15:57:48 +00:00
|
|
|
total_thread_count_(0),
|
2015-03-07 00:38:50 +00:00
|
|
|
keys_per_prefix_(FLAGS_keys_per_prefix),
|
|
|
|
entries_per_batch_(1),
|
|
|
|
reads_(FLAGS_reads < 0 ? FLAGS_num : FLAGS_reads),
|
|
|
|
read_random_exp_range_(0.0),
|
|
|
|
writes_(FLAGS_writes < 0 ? FLAGS_num : FLAGS_writes),
|
|
|
|
readwrites_(
|
|
|
|
(FLAGS_writes < 0 && FLAGS_reads < 0)
|
|
|
|
? FLAGS_num
|
|
|
|
: ((FLAGS_writes > FLAGS_reads) ? FLAGS_writes : FLAGS_reads)),
|
|
|
|
merge_keys_(FLAGS_merge_keys < 0 ? FLAGS_num : FLAGS_merge_keys),
|
2017-05-25 21:08:16 +00:00
|
|
|
report_file_operations_(FLAGS_report_file_operations),
|
|
|
|
#ifndef ROCKSDB_LITE
|
2022-04-01 04:23:58 +00:00
|
|
|
use_blob_db_(FLAGS_use_blob_db), // Stacked BlobDB
|
2017-05-25 21:08:16 +00:00
|
|
|
#else
|
2022-04-01 04:23:58 +00:00
|
|
|
use_blob_db_(false), // Stacked BlobDB
|
2017-05-25 21:08:16 +00:00
|
|
|
#endif // !ROCKSDB_LITE
|
2022-04-01 04:23:58 +00:00
|
|
|
read_operands_(false) {
|
2016-05-24 06:35:23 +00:00
|
|
|
// use simcache instead of cache
|
|
|
|
if (FLAGS_simcache_size >= 0) {
|
|
|
|
if (FLAGS_cache_numshardbits >= 1) {
|
|
|
|
cache_ =
|
|
|
|
NewSimCache(cache_, FLAGS_simcache_size, FLAGS_cache_numshardbits);
|
|
|
|
} else {
|
|
|
|
cache_ = NewSimCache(cache_, FLAGS_simcache_size, 0);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-10-29 21:24:34 +00:00
|
|
|
if (report_file_operations_) {
|
2022-02-03 23:00:03 +00:00
|
|
|
FLAGS_env = new CompositeEnvWrapper(
|
|
|
|
FLAGS_env,
|
|
|
|
std::make_shared<CountedFileSystem>(FLAGS_env->GetFileSystem()));
|
2014-10-29 21:24:34 +00:00
|
|
|
}
|
|
|
|
|
2014-03-05 01:08:05 +00:00
|
|
|
if (FLAGS_prefix_size > FLAGS_key_size) {
|
|
|
|
fprintf(stderr, "prefix size is larger than key size");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
std::vector<std::string> files;
|
2012-06-08 08:11:14 +00:00
|
|
|
FLAGS_env->GetChildren(FLAGS_db, &files);
|
2015-12-15 23:26:20 +00:00
|
|
|
for (size_t i = 0; i < files.size(); i++) {
|
2011-03-18 22:37:00 +00:00
|
|
|
if (Slice(files[i]).starts_with("heap-")) {
|
2013-10-24 14:43:14 +00:00
|
|
|
FLAGS_env->DeleteFile(FLAGS_db + "/" + files[i]);
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
}
|
2011-05-21 02:17:43 +00:00
|
|
|
if (!FLAGS_use_existing_db) {
|
benchmark.sh won't run through all tests properly if one specifies wal_dir to be different than db directory.
Summary:
A command line like this to run all the tests:
source benchmark.config.sh && nohup ./benchmark.sh 'bulkload,fillseq,overwrite,filluniquerandom,readrandom,readwhilewriting'
where
benchmark.config.sh is:
export DB_DIR=/data/mysql/rocksdata
export WAL_DIR=/txlogs/rockswal
export OUTPUT_DIR=/root/rocks_benchmarking/output
Will fail for the tests that need a new DB .
Also 1) set disable_data_sync=0 and 2) add debug mode to run through all the tests more quickly
Test Plan: run ./benchmark.sh 'debug,bulkload,fillseq,overwrite,filluniquerandom,readrandom,readwhilewriting' and verify that there are no complaints about WAL dir not being empty.
Reviewers: sdong, yhchiang, rven, igor
Reviewed By: igor
Subscribers: dhruba
Differential Revision: https://reviews.facebook.net/D30909
2015-01-05 23:36:47 +00:00
|
|
|
Options options;
|
2019-10-22 18:42:00 +00:00
|
|
|
options.env = FLAGS_env;
|
benchmark.sh won't run through all tests properly if one specifies wal_dir to be different than db directory.
Summary:
A command line like this to run all the tests:
source benchmark.config.sh && nohup ./benchmark.sh 'bulkload,fillseq,overwrite,filluniquerandom,readrandom,readwhilewriting'
where
benchmark.config.sh is:
export DB_DIR=/data/mysql/rocksdata
export WAL_DIR=/txlogs/rockswal
export OUTPUT_DIR=/root/rocks_benchmarking/output
Will fail for the tests that need a new DB .
Also 1) set disable_data_sync=0 and 2) add debug mode to run through all the tests more quickly
Test Plan: run ./benchmark.sh 'debug,bulkload,fillseq,overwrite,filluniquerandom,readrandom,readwhilewriting' and verify that there are no complaints about WAL dir not being empty.
Reviewers: sdong, yhchiang, rven, igor
Reviewed By: igor
Subscribers: dhruba
Differential Revision: https://reviews.facebook.net/D30909
2015-01-05 23:36:47 +00:00
|
|
|
if (!FLAGS_wal_dir.empty()) {
|
|
|
|
options.wal_dir = FLAGS_wal_dir;
|
|
|
|
}
|
2017-07-11 21:05:39 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
if (use_blob_db_) {
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB
|
2017-07-11 21:05:39 +00:00
|
|
|
blob_db::DestroyBlobDB(FLAGS_db, options, blob_db::BlobDBOptions());
|
|
|
|
}
|
|
|
|
#endif // !ROCKSDB_LITE
|
benchmark.sh won't run through all tests properly if one specifies wal_dir to be different than db directory.
Summary:
A command line like this to run all the tests:
source benchmark.config.sh && nohup ./benchmark.sh 'bulkload,fillseq,overwrite,filluniquerandom,readrandom,readwhilewriting'
where
benchmark.config.sh is:
export DB_DIR=/data/mysql/rocksdata
export WAL_DIR=/txlogs/rockswal
export OUTPUT_DIR=/root/rocks_benchmarking/output
Will fail for the tests that need a new DB .
Also 1) set disable_data_sync=0 and 2) add debug mode to run through all the tests more quickly
Test Plan: run ./benchmark.sh 'debug,bulkload,fillseq,overwrite,filluniquerandom,readrandom,readwhilewriting' and verify that there are no complaints about WAL dir not being empty.
Reviewers: sdong, yhchiang, rven, igor
Reviewed By: igor
Subscribers: dhruba
Differential Revision: https://reviews.facebook.net/D30909
2015-01-05 23:36:47 +00:00
|
|
|
DestroyDB(FLAGS_db, options);
|
2016-10-18 23:30:57 +00:00
|
|
|
if (!FLAGS_wal_dir.empty()) {
|
|
|
|
FLAGS_env->DeleteDir(FLAGS_wal_dir);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (FLAGS_num_multi_db > 1) {
|
|
|
|
FLAGS_env->CreateDir(FLAGS_db);
|
|
|
|
if (!FLAGS_wal_dir.empty()) {
|
|
|
|
FLAGS_env->CreateDir(FLAGS_wal_dir);
|
|
|
|
}
|
|
|
|
}
|
2011-05-21 02:17:43 +00:00
|
|
|
}
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
|
|
|
|
listener_.reset(new ErrorHandlerListener());
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
mock_app_clock_.reset(new TimestampEmulator());
|
|
|
|
}
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
|
2021-07-16 19:27:00 +00:00
|
|
|
void DeleteDBs() {
|
2015-05-29 21:36:35 +00:00
|
|
|
db_.DeleteDBs();
|
2021-07-16 19:27:00 +00:00
|
|
|
for (const DBWithColumnFamilies& dbwcf : multi_dbs_) {
|
|
|
|
delete dbwcf.db;
|
2021-01-26 19:10:16 +00:00
|
|
|
}
|
2021-07-16 19:27:00 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
~Benchmark() {
|
|
|
|
DeleteDBs();
|
2015-03-13 23:41:00 +00:00
|
|
|
if (cache_.get() != nullptr) {
|
Use deleters to label cache entries and collect stats (#8297)
Summary:
This change gathers and publishes statistics about the
kinds of items in block cache. This is especially important for
profiling relative usage of cache by index vs. filter vs. data blocks.
It works by iterating over the cache during periodic stats dump
(InternalStats, stats_dump_period_sec) or on demand when
DB::Get(Map)Property(kBlockCacheEntryStats), except that for
efficiency and sharing among column families, saved data from
the last scan is used when the data is not considered too old.
The new information can be seen in info LOG, for example:
Block cache LRUCache@0x7fca62229330 capacity: 95.37 MB collections: 8 last_copies: 0 last_secs: 0.00178 secs_since: 0
Block cache entry stats(count,size,portion): DataBlock(7092,28.24 MB,29.6136%) FilterBlock(215,867.90 KB,0.888728%) FilterMetaBlock(2,5.31 KB,0.00544%) IndexBlock(217,180.11 KB,0.184432%) WriteBuffer(1,256.00 KB,0.262144%) Misc(1,0.00 KB,0%)
And also through DB::GetProperty and GetMapProperty (here using
ldb just for demonstration):
$ ./ldb --db=/dev/shm/dbbench/ get_property rocksdb.block-cache-entry-stats
rocksdb.block-cache-entry-stats.bytes.data-block: 0
rocksdb.block-cache-entry-stats.bytes.deprecated-filter-block: 0
rocksdb.block-cache-entry-stats.bytes.filter-block: 0
rocksdb.block-cache-entry-stats.bytes.filter-meta-block: 0
rocksdb.block-cache-entry-stats.bytes.index-block: 178992
rocksdb.block-cache-entry-stats.bytes.misc: 0
rocksdb.block-cache-entry-stats.bytes.other-block: 0
rocksdb.block-cache-entry-stats.bytes.write-buffer: 0
rocksdb.block-cache-entry-stats.capacity: 8388608
rocksdb.block-cache-entry-stats.count.data-block: 0
rocksdb.block-cache-entry-stats.count.deprecated-filter-block: 0
rocksdb.block-cache-entry-stats.count.filter-block: 0
rocksdb.block-cache-entry-stats.count.filter-meta-block: 0
rocksdb.block-cache-entry-stats.count.index-block: 215
rocksdb.block-cache-entry-stats.count.misc: 1
rocksdb.block-cache-entry-stats.count.other-block: 0
rocksdb.block-cache-entry-stats.count.write-buffer: 0
rocksdb.block-cache-entry-stats.id: LRUCache@0x7f3636661290
rocksdb.block-cache-entry-stats.percent.data-block: 0.000000
rocksdb.block-cache-entry-stats.percent.deprecated-filter-block: 0.000000
rocksdb.block-cache-entry-stats.percent.filter-block: 0.000000
rocksdb.block-cache-entry-stats.percent.filter-meta-block: 0.000000
rocksdb.block-cache-entry-stats.percent.index-block: 2.133751
rocksdb.block-cache-entry-stats.percent.misc: 0.000000
rocksdb.block-cache-entry-stats.percent.other-block: 0.000000
rocksdb.block-cache-entry-stats.percent.write-buffer: 0.000000
rocksdb.block-cache-entry-stats.secs_for_last_collection: 0.000052
rocksdb.block-cache-entry-stats.secs_since_last_collection: 0
Solution detail - We need some way to flag what kind of blocks each
entry belongs to, preferably without changing the Cache API.
One of the complications is that Cache is a general interface that could
have other users that don't adhere to whichever convention we decide
on for keys and values. Or we would pay for an extra field in the Handle
that would only be used for this purpose.
This change uses a back-door approach, the deleter, to indicate the
"role" of a Cache entry (in addition to the value type, implicitly).
This has the added benefit of ensuring proper code origin whenever we
recognize a particular role for a cache entry; if the entry came from
some other part of the code, it will use an unrecognized deleter, which
we simply attribute to the "Misc" role.
An internal API makes for simple instantiation and automatic
registration of Cache deleters for a given value type and "role".
Another internal API, CacheEntryStatsCollector, solves the problem of
caching the results of a scan and sharing them, to ensure scans are
neither excessive nor redundant so as not to harm Cache performance.
Because code is added to BlocklikeTraits, it is pulled out of
block_based_table_reader.cc into its own file.
This is a reformulation of https://github.com/facebook/rocksdb/issues/8276, without the type checking option
(could still be added), and with actual stat gathering.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8297
Test Plan: manual testing with db_bench, and a couple of basic unit tests
Reviewed By: ltamasi
Differential Revision: D28488721
Pulled By: pdillinger
fbshipit-source-id: 472f524a9691b5afb107934be2d41d84f2b129fb
2021-05-19 23:45:51 +00:00
|
|
|
// Clear cache reference first
|
|
|
|
open_options_.write_buffer_manager.reset();
|
2015-03-13 23:41:00 +00:00
|
|
|
// this will leak, but we're shutting down so nobody cares
|
|
|
|
cache_->DisownData();
|
|
|
|
}
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
Slice AllocateKey(std::unique_ptr<const char[]>* key_guard) {
|
2015-03-26 08:53:42 +00:00
|
|
|
char* data = new char[key_size_];
|
|
|
|
const char* const_data = data;
|
|
|
|
key_guard->reset(const_data);
|
2015-02-19 22:27:48 +00:00
|
|
|
return Slice(key_guard->get(), key_size_);
|
2014-04-08 18:21:09 +00:00
|
|
|
}
|
|
|
|
|
2014-03-05 01:08:05 +00:00
|
|
|
// Generate key according to the given specification and random number.
|
2020-09-16 03:04:58 +00:00
|
|
|
// The resulting key will have the following format:
|
|
|
|
// - If keys_per_prefix_ is positive, extra trailing bytes are either cut
|
|
|
|
// off or padded with '0'.
|
|
|
|
// The prefix value is derived from key value.
|
|
|
|
// ----------------------------
|
|
|
|
// | prefix 00000 | key 00000 |
|
|
|
|
// ----------------------------
|
|
|
|
//
|
|
|
|
// - If keys_per_prefix_ is 0, the key is simply a binary representation of
|
|
|
|
// random number followed by trailing '0's
|
|
|
|
// ----------------------------
|
|
|
|
// | key 00000 |
|
|
|
|
// ----------------------------
|
2014-04-08 18:21:09 +00:00
|
|
|
void GenerateKeyFromInt(uint64_t v, int64_t num_keys, Slice* key) {
|
2019-03-01 19:14:28 +00:00
|
|
|
if (!keys_.empty()) {
|
|
|
|
assert(FLAGS_use_existing_keys);
|
|
|
|
assert(keys_.size() == static_cast<size_t>(num_keys));
|
|
|
|
assert(v < static_cast<uint64_t>(num_keys));
|
|
|
|
*key = keys_[v];
|
|
|
|
return;
|
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
char* start = const_cast<char*>(key->data());
|
2014-03-05 01:08:05 +00:00
|
|
|
char* pos = start;
|
|
|
|
if (keys_per_prefix_ > 0) {
|
|
|
|
int64_t num_prefix = num_keys / keys_per_prefix_;
|
|
|
|
int64_t prefix = v % num_prefix;
|
|
|
|
int bytes_to_fill = std::min(prefix_size_, 8);
|
|
|
|
if (port::kLittleEndian) {
|
|
|
|
for (int i = 0; i < bytes_to_fill; ++i) {
|
|
|
|
pos[i] = (prefix >> ((bytes_to_fill - i - 1) << 3)) & 0xFF;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
memcpy(pos, static_cast<void*>(&prefix), bytes_to_fill);
|
|
|
|
}
|
|
|
|
if (prefix_size_ > 8) {
|
|
|
|
// fill the rest with 0s
|
|
|
|
memset(pos + 8, '0', prefix_size_ - 8);
|
|
|
|
}
|
|
|
|
pos += prefix_size_;
|
|
|
|
}
|
|
|
|
|
|
|
|
int bytes_to_fill = std::min(key_size_ - static_cast<int>(pos - start), 8);
|
|
|
|
if (port::kLittleEndian) {
|
|
|
|
for (int i = 0; i < bytes_to_fill; ++i) {
|
|
|
|
pos[i] = (v >> ((bytes_to_fill - i - 1) << 3)) & 0xFF;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
memcpy(pos, static_cast<void*>(&v), bytes_to_fill);
|
|
|
|
}
|
|
|
|
pos += bytes_to_fill;
|
|
|
|
if (key_size_ > pos - start) {
|
|
|
|
memset(pos, '0', key_size_ - (pos - start));
|
|
|
|
}
|
2013-08-13 20:58:02 +00:00
|
|
|
}
|
|
|
|
|
2019-04-15 17:49:47 +00:00
|
|
|
void GenerateKeyFromIntForSeek(uint64_t v, int64_t num_keys, Slice* key) {
|
|
|
|
GenerateKeyFromInt(v, num_keys, key);
|
|
|
|
if (FLAGS_seek_missing_prefix) {
|
|
|
|
assert(prefix_size_ > 8);
|
|
|
|
char* key_ptr = const_cast<char*>(key->data());
|
|
|
|
// This rely on GenerateKeyFromInt filling paddings with '0's.
|
|
|
|
// Putting a '1' will create a non-existing prefix.
|
|
|
|
key_ptr[8] = '1';
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-10-18 23:30:57 +00:00
|
|
|
std::string GetPathForMultiple(std::string base_name, size_t id) {
|
|
|
|
if (!base_name.empty()) {
|
|
|
|
#ifndef OS_WIN
|
|
|
|
if (base_name.back() != '/') {
|
|
|
|
base_name += '/';
|
|
|
|
}
|
|
|
|
#else
|
|
|
|
if (base_name.back() != '\\') {
|
|
|
|
base_name += '\\';
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
}
|
2022-05-06 20:03:58 +00:00
|
|
|
return base_name + std::to_string(id);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
|
2019-05-31 02:29:34 +00:00
|
|
|
void VerifyDBFromDB(std::string& truth_db_name) {
|
|
|
|
DBWithColumnFamilies truth_db;
|
|
|
|
auto s = DB::OpenForReadOnly(open_options_, truth_db_name, &truth_db.db);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "open error: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
ReadOptions ro;
|
|
|
|
ro.total_order_seek = true;
|
|
|
|
std::unique_ptr<Iterator> truth_iter(truth_db.db->NewIterator(ro));
|
|
|
|
std::unique_ptr<Iterator> db_iter(db_.db->NewIterator(ro));
|
|
|
|
// Verify that all the key/values in truth_db are retrivable in db with
|
|
|
|
// ::Get
|
|
|
|
fprintf(stderr, "Verifying db >= truth_db with ::Get...\n");
|
|
|
|
for (truth_iter->SeekToFirst(); truth_iter->Valid(); truth_iter->Next()) {
|
2017-04-07 18:25:42 +00:00
|
|
|
std::string value;
|
|
|
|
s = db_.db->Get(ro, truth_iter->key(), &value);
|
|
|
|
assert(s.ok());
|
|
|
|
// TODO(myabandeh): provide debugging hints
|
|
|
|
assert(Slice(value) == truth_iter->value());
|
2019-05-31 02:29:34 +00:00
|
|
|
}
|
|
|
|
// Verify that the db iterator does not give any extra key/value
|
|
|
|
fprintf(stderr, "Verifying db == truth_db...\n");
|
|
|
|
for (db_iter->SeekToFirst(), truth_iter->SeekToFirst(); db_iter->Valid();
|
|
|
|
db_iter->Next(), truth_iter->Next()) {
|
|
|
|
assert(truth_iter->Valid());
|
|
|
|
assert(truth_iter->value() == db_iter->value());
|
|
|
|
}
|
|
|
|
// No more key should be left unchecked in truth_db
|
|
|
|
assert(!truth_iter->Valid());
|
|
|
|
fprintf(stderr, "...Verified\n");
|
2017-04-07 18:25:42 +00:00
|
|
|
}
|
|
|
|
|
2020-09-03 21:34:42 +00:00
|
|
|
void ErrorExit() {
|
2021-07-16 19:27:00 +00:00
|
|
|
DeleteDBs();
|
2020-09-03 21:34:42 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
void Run() {
|
2014-06-23 17:46:16 +00:00
|
|
|
if (!SanityCheck()) {
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2014-06-23 17:46:16 +00:00
|
|
|
}
|
2014-12-23 02:39:28 +00:00
|
|
|
Open(&open_options_);
|
2021-09-08 14:45:59 +00:00
|
|
|
PrintHeader(open_options_);
|
2015-08-11 18:46:15 +00:00
|
|
|
std::stringstream benchmark_stream(FLAGS_benchmarks);
|
|
|
|
std::string name;
|
2016-08-01 19:28:51 +00:00
|
|
|
std::unique_ptr<ExpiredTimeFilter> filter;
|
2015-08-11 18:46:15 +00:00
|
|
|
while (std::getline(benchmark_stream, name, ',')) {
|
2013-08-13 20:58:02 +00:00
|
|
|
// Sanitize parameters
|
2011-08-22 21:08:51 +00:00
|
|
|
num_ = FLAGS_num;
|
2011-09-01 19:08:02 +00:00
|
|
|
reads_ = (FLAGS_reads < 0 ? FLAGS_num : FLAGS_reads);
|
2012-05-31 00:04:35 +00:00
|
|
|
writes_ = (FLAGS_writes < 0 ? FLAGS_num : FLAGS_writes);
|
2016-06-28 21:10:24 +00:00
|
|
|
deletes_ = (FLAGS_deletes < 0 ? FLAGS_num : FLAGS_deletes);
|
2020-02-12 22:44:46 +00:00
|
|
|
value_size = FLAGS_value_size;
|
2013-03-01 22:10:09 +00:00
|
|
|
key_size_ = FLAGS_key_size;
|
2014-10-23 01:43:27 +00:00
|
|
|
entries_per_batch_ = FLAGS_batch_size;
|
2018-10-19 00:16:36 +00:00
|
|
|
writes_before_delete_range_ = FLAGS_writes_before_delete_range;
|
2016-11-16 01:33:27 +00:00
|
|
|
writes_per_range_tombstone_ = FLAGS_writes_per_range_tombstone;
|
|
|
|
range_tombstone_width_ = FLAGS_range_tombstone_width;
|
|
|
|
max_num_range_tombstones_ = FLAGS_max_num_range_tombstones;
|
2011-08-22 21:08:51 +00:00
|
|
|
write_options_ = WriteOptions();
|
2015-03-07 00:38:50 +00:00
|
|
|
read_random_exp_range_ = FLAGS_read_random_exp_range;
|
2012-05-31 00:04:35 +00:00
|
|
|
if (FLAGS_sync) {
|
|
|
|
write_options_.sync = true;
|
|
|
|
}
|
2012-08-19 23:05:02 +00:00
|
|
|
write_options_.disableWAL = FLAGS_disable_wal;
|
Rate-limit automatic WAL flush after each user write (#9607)
Summary:
**Context:**
WAL flush is currently not rate-limited by `Options::rate_limiter`. This PR is to provide rate-limiting to auto WAL flush, the one that automatically happen after each user write operation (i.e, `Options::manual_wal_flush == false`), by adding `WriteOptions::rate_limiter_options`.
Note that we are NOT rate-limiting WAL flush that do NOT automatically happen after each user write, such as `Options::manual_wal_flush == true + manual FlushWAL()` (rate-limiting multiple WAL flushes), for the benefits of:
- being consistent with [ReadOptions::rate_limiter_priority](https://github.com/facebook/rocksdb/blob/7.0.fb/include/rocksdb/options.h#L515)
- being able to turn off some WAL flush's rate-limiting but not all (e.g, turn off specific the WAL flush of a critical user write like a service's heartbeat)
`WriteOptions::rate_limiter_options` only accept `Env::IO_USER` and `Env::IO_TOTAL` currently due to an implementation constraint.
- The constraint is that we currently queue parallel writes (including WAL writes) based on FIFO policy which does not factor rate limiter priority into this layer's scheduling. If we allow lower priorities such as `Env::IO_HIGH/MID/LOW` and such writes specified with lower priorities occurs before ones specified with higher priorities (even just by a tiny bit in arrival time), the former would have blocked the latter, leading to a "priority inversion" issue and contradictory to what we promise for rate-limiting priority. Therefore we only allow `Env::IO_USER` and `Env::IO_TOTAL` right now before improving that scheduling.
A pre-requisite to this feature is to support operation-level rate limiting in `WritableFileWriter`, which is also included in this PR.
**Summary:**
- Renamed test suite `DBRateLimiterTest to DBRateLimiterOnReadTest` for adding a new test suite
- Accept `rate_limiter_priority` in `WritableFileWriter`'s private and public write functions
- Passed `WriteOptions::rate_limiter_options` to `WritableFileWriter` in the path of automatic WAL flush.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9607
Test Plan:
- Added new unit test to verify existing flush/compaction rate-limiting does not break, since `DBTest, RateLimitingTest` is disabled and current db-level rate-limiting tests focus on read only (e.g, `db_rate_limiter_test`, `DBTest2, RateLimitedCompactionReads`).
- Added new unit test `DBRateLimiterOnWriteWALTest, AutoWalFlush`
- `strace -ftt -e trace=write ./db_bench -benchmarks=fillseq -db=/dev/shm/testdb -rate_limit_auto_wal_flush=1 -rate_limiter_bytes_per_sec=15 -rate_limiter_refill_period_us=1000000 -write_buffer_size=100000000 -disable_auto_compactions=1 -num=100`
- verified that WAL flush(i.e, system-call _write_) were chunked into 15 bytes and each _write_ was roughly 1 second apart
- verified the chunking disappeared when `-rate_limit_auto_wal_flush=0`
- crash test: `python3 tools/db_crashtest.py blackbox --disable_wal=0 --rate_limit_auto_wal_flush=1 --rate_limiter_bytes_per_sec=10485760 --interval=10` killed as normal
**Benchmarked on flush/compaction to ensure no performance regression:**
- compaction with rate-limiting (see table 1, avg over 1280-run): pre-change: **915635 micros/op**; post-change:
**907350 micros/op (improved by 0.106%)**
```
#!/bin/bash
TEST_TMPDIR=/dev/shm/testdb
START=1
NUM_DATA_ENTRY=8
N=10
rm -f compact_bmk_output.txt compact_bmk_output_2.txt dont_care_output.txt
for i in $(eval echo "{$START..$NUM_DATA_ENTRY}")
do
NUM_RUN=$(($N*(2**($i-1))))
for j in $(eval echo "{$START..$NUM_RUN}")
do
./db_bench --benchmarks=fillrandom -db=$TEST_TMPDIR -disable_auto_compactions=1 -write_buffer_size=6710886 > dont_care_output.txt && ./db_bench --benchmarks=compact -use_existing_db=1 -db=$TEST_TMPDIR -level0_file_num_compaction_trigger=1 -rate_limiter_bytes_per_sec=100000000 | egrep 'compact'
done > compact_bmk_output.txt && awk -v NUM_RUN=$NUM_RUN '{sum+=$3;sum_sqrt+=$3^2}END{print sum/NUM_RUN, sqrt(sum_sqrt/NUM_RUN-(sum/NUM_RUN)^2)}' compact_bmk_output.txt >> compact_bmk_output_2.txt
done
```
- compaction w/o rate-limiting (see table 2, avg over 640-run): pre-change: **822197 micros/op**; post-change: **823148 micros/op (regressed by 0.12%)**
```
Same as above script, except that -rate_limiter_bytes_per_sec=0
```
- flush with rate-limiting (see table 3, avg over 320-run, run on the [patch](https://github.com/hx235/rocksdb/commit/ee5c6023a9f6533fab9afdc681568daa21da4953) to augment current db_bench ): pre-change: **745752 micros/op**; post-change: **745331 micros/op (regressed by 0.06 %)**
```
#!/bin/bash
TEST_TMPDIR=/dev/shm/testdb
START=1
NUM_DATA_ENTRY=8
N=10
rm -f flush_bmk_output.txt flush_bmk_output_2.txt
for i in $(eval echo "{$START..$NUM_DATA_ENTRY}")
do
NUM_RUN=$(($N*(2**($i-1))))
for j in $(eval echo "{$START..$NUM_RUN}")
do
./db_bench -db=$TEST_TMPDIR -write_buffer_size=1048576000 -num=1000000 -rate_limiter_bytes_per_sec=100000000 -benchmarks=fillseq,flush | egrep 'flush'
done > flush_bmk_output.txt && awk -v NUM_RUN=$NUM_RUN '{sum+=$3;sum_sqrt+=$3^2}END{print sum/NUM_RUN, sqrt(sum_sqrt/NUM_RUN-(sum/NUM_RUN)^2)}' flush_bmk_output.txt >> flush_bmk_output_2.txt
done
```
- flush w/o rate-limiting (see table 4, avg over 320-run, run on the [patch](https://github.com/hx235/rocksdb/commit/ee5c6023a9f6533fab9afdc681568daa21da4953) to augment current db_bench): pre-change: **487512 micros/op**, post-change: **485856 micors/ops (improved by 0.34%)**
```
Same as above script, except that -rate_limiter_bytes_per_sec=0
```
| table 1 - compact with rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 896978 | 16046.9 | 901242 | 15670.9 | 0.475373978
20 | 893718 | 15813 | 886505 | 17544.7 | -0.8070778478
40 | 900426 | 23882.2 | 894958 | 15104.5 | -0.6072681153
80 | 906635 | 21761.5 | 903332 | 23948.3 | -0.3643141948
160 | 898632 | 21098.9 | 907583 | 21145 | 0.9960695813
3.20E+02 | 905252 | 22785.5 | 908106 | 25325.5 | 0.3152713278
6.40E+02 | 905213 | 23598.6 | 906741 | 21370.5 | 0.1688000504
**1.28E+03** | **908316** | **23533.1** | **907350** | **24626.8** | **-0.1063506533**
average over #-run | 901896.25 | 21064.9625 | 901977.125 | 20592.025 | 0.008967217682
| table 2 - compact w/o rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 811211 | 26996.7 | 807586 | 28456.4 | -0.4468627768
20 | 815465 | 14803.7 | 814608 | 28719.7 | -0.105093413
40 | 809203 | 26187.1 | 797835 | 25492.1 | -1.404839082
80 | 822088 | 28765.3 | 822192 | 32840.4 | 0.01265071379
160 | 821719 | 36344.7 | 821664 | 29544.9 | -0.006693285661
3.20E+02 | 820921 | 27756.4 | 821403 | 28347.7 | 0.05871454135
**6.40E+02** | **822197** | **28960.6** | **823148** | **30055.1** | **0.1156657103**
average over #-run | 8.18E+05 | 2.71E+04 | 8.15E+05 | 2.91E+04 | -0.25
| table 3 - flush with rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 741721 | 11770.8 | 740345 | 5949.76 | -0.1855144994
20 | 735169 | 3561.83 | 743199 | 9755.77 | 1.09226586
40 | 743368 | 8891.03 | 742102 | 8683.22 | -0.1703059588
80 | 742129 | 8148.51 | 743417 | 9631.58| 0.1735547324
160 | 749045 | 9757.21 | 746256 | 9191.86 | -0.3723407806
**3.20E+02** | **745752** | **9819.65** | **745331** | **9840.62** | **-0.0564530836**
6.40E+02 | 749006 | 11080.5 | 748173 | 10578.7 | -0.1112140624
average over #-run | 743741.4286 | 9004.218571 | 744117.5714 | 9090.215714 | 0.05057441238
| table 4 - flush w/o rate-limiting|
#-run | (pre-change) avg micros/op | std micros/op | (post-change) avg micros/op | std micros/op | change in avg micros/op (%)
-- | -- | -- | -- | -- | --
10 | 477283 | 24719.6 | 473864 | 12379 | -0.7163464863
20 | 486743 | 20175.2 | 502296 | 23931.3 | 3.195320734
40 | 482846 | 15309.2 | 489820 | 22259.5 | 1.444352858
80 | 491490 | 21883.1 | 490071 | 23085.7 | -0.2887139108
160 | 493347 | 28074.3 | 483609 | 21211.7 | -1.973864238
**3.20E+02** | **487512** | **21401.5** | **485856** | **22195.2** | **-0.3396839462**
6.40E+02 | 490307 | 25418.6 | 485435 | 22405.2 | -0.9936631539
average over #-run | 4.87E+05 | 2.24E+04 | 4.87E+05 | 2.11E+04 | 0.00E+00
Reviewed By: ajkr
Differential Revision: D34442441
Pulled By: hx235
fbshipit-source-id: 4790f13e1e5c0a95ae1d1cc93ffcf69dc6e78bdd
2022-03-08 21:19:39 +00:00
|
|
|
write_options_.rate_limiter_priority =
|
|
|
|
FLAGS_rate_limit_auto_wal_flush ? Env::IO_USER : Env::IO_TOTAL;
|
2022-02-01 03:45:17 +00:00
|
|
|
read_options_ = ReadOptions(FLAGS_verify_checksum, true);
|
|
|
|
read_options_.total_order_seek = FLAGS_total_order_seek;
|
|
|
|
read_options_.prefix_same_as_start = FLAGS_prefix_same_as_start;
|
2022-02-17 07:17:03 +00:00
|
|
|
read_options_.rate_limiter_priority =
|
|
|
|
FLAGS_rate_limit_user_ops ? Env::IO_USER : Env::IO_TOTAL;
|
2022-02-01 03:45:17 +00:00
|
|
|
read_options_.tailing = FLAGS_use_tailing_iterator;
|
|
|
|
read_options_.readahead_size = FLAGS_readahead_size;
|
|
|
|
read_options_.adaptive_readahead = FLAGS_adaptive_readahead;
|
2022-03-23 00:21:35 +00:00
|
|
|
read_options_.async_io = FLAGS_async_io;
|
2012-08-19 23:05:02 +00:00
|
|
|
|
2013-02-15 19:53:17 +00:00
|
|
|
void (Benchmark::*method)(ThreadState*) = nullptr;
|
2015-05-29 21:36:35 +00:00
|
|
|
void (Benchmark::*post_process_method)() = nullptr;
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
bool fresh_db = false;
|
2011-09-01 19:08:02 +00:00
|
|
|
int num_threads = FLAGS_threads;
|
2011-03-22 18:32:49 +00:00
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
int num_repeat = 1;
|
|
|
|
int num_warmup = 0;
|
|
|
|
if (!name.empty() && *name.rbegin() == ']') {
|
|
|
|
auto it = name.find('[');
|
|
|
|
if (it == std::string::npos) {
|
|
|
|
fprintf(stderr, "unknown benchmark arguments '%s'\n", name.c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2016-08-25 19:57:35 +00:00
|
|
|
}
|
|
|
|
std::string args = name.substr(it + 1);
|
|
|
|
args.resize(args.size() - 1);
|
|
|
|
name.resize(it);
|
|
|
|
|
|
|
|
std::string bench_arg;
|
|
|
|
std::stringstream args_stream(args);
|
|
|
|
while (std::getline(args_stream, bench_arg, '-')) {
|
|
|
|
if (bench_arg.empty()) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
if (bench_arg[0] == 'X') {
|
|
|
|
// Repeat the benchmark n times
|
|
|
|
std::string num_str = bench_arg.substr(1);
|
|
|
|
num_repeat = std::stoi(num_str);
|
|
|
|
} else if (bench_arg[0] == 'W') {
|
|
|
|
// Warm up the benchmark for n times
|
|
|
|
std::string num_str = bench_arg.substr(1);
|
|
|
|
num_warmup = std::stoi(num_str);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-10-18 23:30:57 +00:00
|
|
|
// Both fillseqdeterministic and filluniquerandomdeterministic
|
|
|
|
// fill the levels except the max level with UNIQUE_RANDOM
|
|
|
|
// and fill the max level with fillseq and filluniquerandom, respectively
|
|
|
|
if (name == "fillseqdeterministic" ||
|
|
|
|
name == "filluniquerandomdeterministic") {
|
|
|
|
if (!FLAGS_disable_auto_compactions) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Please disable_auto_compactions in FillDeterministic "
|
|
|
|
"benchmark\n");
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2016-10-18 23:30:57 +00:00
|
|
|
}
|
|
|
|
if (num_threads > 1) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"filldeterministic multithreaded not supported"
|
|
|
|
", use 1 thread\n");
|
|
|
|
num_threads = 1;
|
|
|
|
}
|
|
|
|
fresh_db = true;
|
|
|
|
if (name == "fillseqdeterministic") {
|
|
|
|
method = &Benchmark::WriteSeqDeterministic;
|
|
|
|
} else {
|
|
|
|
method = &Benchmark::WriteUniqueRandomDeterministic;
|
|
|
|
}
|
|
|
|
} else if (name == "fillseq") {
|
2011-08-22 21:08:51 +00:00
|
|
|
fresh_db = true;
|
|
|
|
method = &Benchmark::WriteSeq;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "fillbatch") {
|
2011-08-22 21:08:51 +00:00
|
|
|
fresh_db = true;
|
|
|
|
entries_per_batch_ = 1000;
|
|
|
|
method = &Benchmark::WriteSeq;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "fillrandom") {
|
2011-08-22 21:08:51 +00:00
|
|
|
fresh_db = true;
|
|
|
|
method = &Benchmark::WriteRandom;
|
2021-07-29 21:57:03 +00:00
|
|
|
} else if (name == "filluniquerandom" ||
|
|
|
|
name == "fillanddeleteuniquerandom") {
|
2013-06-14 23:17:56 +00:00
|
|
|
fresh_db = true;
|
|
|
|
if (num_threads > 1) {
|
2015-08-11 18:46:15 +00:00
|
|
|
fprintf(stderr,
|
2021-07-29 21:57:03 +00:00
|
|
|
"filluniquerandom and fillanddeleteuniquerandom "
|
|
|
|
"multithreaded not supported, use 1 thread");
|
2014-04-04 22:37:28 +00:00
|
|
|
num_threads = 1;
|
2013-06-14 23:17:56 +00:00
|
|
|
}
|
|
|
|
method = &Benchmark::WriteUniqueRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "overwrite") {
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::WriteRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "fillsync") {
|
2011-08-22 21:08:51 +00:00
|
|
|
fresh_db = true;
|
|
|
|
num_ /= 1000;
|
|
|
|
write_options_.sync = true;
|
|
|
|
method = &Benchmark::WriteRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "fill100K") {
|
2011-08-22 21:08:51 +00:00
|
|
|
fresh_db = true;
|
|
|
|
num_ /= 1000;
|
2020-02-12 22:44:46 +00:00
|
|
|
value_size = 100 * 1000;
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::WriteRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readseq") {
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::ReadSequential;
|
2019-09-10 18:03:31 +00:00
|
|
|
} else if (name == "readtorowcache") {
|
|
|
|
if (!FLAGS_use_existing_keys || !FLAGS_row_cache_size) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Please set use_existing_keys to true and specify a "
|
|
|
|
"row cache size in readtorowcache benchmark\n");
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2019-09-10 18:03:31 +00:00
|
|
|
}
|
|
|
|
method = &Benchmark::ReadToRowCache;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readtocache") {
|
2013-12-19 00:50:48 +00:00
|
|
|
method = &Benchmark::ReadSequential;
|
|
|
|
num_threads = 1;
|
|
|
|
reads_ = num_;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readreverse") {
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::ReadReverse;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readrandom") {
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
if (FLAGS_multiread_stride) {
|
|
|
|
fprintf(stderr, "entries_per_batch = %" PRIi64 "\n",
|
|
|
|
entries_per_batch_);
|
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::ReadRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readrandomfast") {
|
2014-09-25 18:14:01 +00:00
|
|
|
method = &Benchmark::ReadRandomFast;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "multireadrandom") {
|
2014-09-29 23:05:25 +00:00
|
|
|
fprintf(stderr, "entries_per_batch = %" PRIi64 "\n",
|
|
|
|
entries_per_batch_);
|
2014-04-08 18:21:09 +00:00
|
|
|
method = &Benchmark::MultiReadRandom;
|
For ApproximateSizes, pro-rate table metadata size over data blocks (#6784)
Summary:
The implementation of GetApproximateSizes was inconsistent in
its treatment of the size of non-data blocks of SST files, sometimes
including and sometimes now. This was at its worst with large portion
of table file used by filters and querying a small range that crossed
a table boundary: the size estimate would include large filter size.
It's conceivable that someone might want only to know the size in terms
of data blocks, but I believe that's unlikely enough to ignore for now.
Similarly, there's no evidence the internal function AppoximateOffsetOf
is used for anything other than a one-sided ApproximateSize, so I intend
to refactor to remove redundancy in a follow-up commit.
So to fix this, GetApproximateSizes (and implementation details
ApproximateSize and ApproximateOffsetOf) now consistently include in
their returned sizes a portion of table file metadata (incl filters
and indexes) based on the size portion of the data blocks in range. In
other words, if a key range covers data blocks that are X% by size of all
the table's data blocks, returned approximate size is X% of the total
file size. It would technically be more accurate to attribute metadata
based on number of keys, but that's not computationally efficient with
data available and rarely a meaningful difference.
Also includes miscellaneous comment improvements / clarifications.
Also included is a new approximatesizerandom benchmark for db_bench.
No significant performance difference seen with this change, whether ~700 ops/sec with cache_index_and_filter_blocks and small cache or ~150k ops/sec without cache_index_and_filter_blocks.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6784
Test Plan:
Test added to DBTest.ApproximateSizesFilesWithErrorMargin.
Old code running new test...
[ RUN ] DBTest.ApproximateSizesFilesWithErrorMargin
db/db_test.cc:1562: Failure
Expected: (size) <= (11 * 100), actual: 9478 vs 1100
Other tests updated to reflect consistent accounting of metadata.
Reviewed By: siying
Differential Revision: D21334706
Pulled By: pdillinger
fbshipit-source-id: 6f86870e45213334fedbe9c73b4ebb1d8d611185
2020-06-02 19:27:59 +00:00
|
|
|
} else if (name == "approximatesizerandom") {
|
|
|
|
fprintf(stderr, "entries_per_batch = %" PRIi64 "\n",
|
|
|
|
entries_per_batch_);
|
|
|
|
method = &Benchmark::ApproximateSizeRandom;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
} else if (name == "mixgraph") {
|
|
|
|
method = &Benchmark::MixGraph;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readmissing") {
|
2014-04-08 18:21:09 +00:00
|
|
|
++key_size_;
|
|
|
|
method = &Benchmark::ReadRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "newiterator") {
|
2014-02-03 21:13:36 +00:00
|
|
|
method = &Benchmark::IteratorCreation;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "newiteratorwhilewriting") {
|
2014-04-10 17:15:59 +00:00
|
|
|
num_threads++; // Add extra thread for writing
|
|
|
|
method = &Benchmark::IteratorCreationWhileWriting;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "seekrandom") {
|
2012-04-17 15:36:46 +00:00
|
|
|
method = &Benchmark::SeekRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "seekrandomwhilewriting") {
|
2014-04-11 16:47:20 +00:00
|
|
|
num_threads++; // Add extra thread for writing
|
|
|
|
method = &Benchmark::SeekRandomWhileWriting;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "seekrandomwhilemerging") {
|
2015-03-30 18:28:25 +00:00
|
|
|
num_threads++; // Add extra thread for merging
|
|
|
|
method = &Benchmark::SeekRandomWhileMerging;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readrandomsmall") {
|
2011-05-21 02:17:43 +00:00
|
|
|
reads_ /= 1000;
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::ReadRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "deleteseq") {
|
2012-04-17 15:36:46 +00:00
|
|
|
method = &Benchmark::DeleteSeq;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "deleterandom") {
|
2012-04-17 15:36:46 +00:00
|
|
|
method = &Benchmark::DeleteRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readwhilewriting") {
|
2011-09-01 19:08:02 +00:00
|
|
|
num_threads++; // Add extra thread for writing
|
|
|
|
method = &Benchmark::ReadWhileWriting;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readwhilemerging") {
|
2015-03-18 20:50:52 +00:00
|
|
|
num_threads++; // Add extra thread for writing
|
|
|
|
method = &Benchmark::ReadWhileMerging;
|
2018-05-24 22:45:49 +00:00
|
|
|
} else if (name == "readwhilescanning") {
|
|
|
|
num_threads++; // Add extra thread for scaning
|
|
|
|
method = &Benchmark::ReadWhileScanning;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readrandomwriterandom") {
|
2012-08-31 06:06:17 +00:00
|
|
|
method = &Benchmark::ReadRandomWriteRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "readrandommergerandom") {
|
2014-01-11 01:33:56 +00:00
|
|
|
if (FLAGS_merge_operator.empty()) {
|
|
|
|
fprintf(stdout, "%-12s : skipped (--merge_operator is unknown)\n",
|
2015-08-11 18:46:15 +00:00
|
|
|
name.c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2014-01-11 01:33:56 +00:00
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
method = &Benchmark::ReadRandomMergeRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "updaterandom") {
|
2013-03-01 19:25:13 +00:00
|
|
|
method = &Benchmark::UpdateRandom;
|
2018-03-06 18:20:52 +00:00
|
|
|
} else if (name == "xorupdaterandom") {
|
|
|
|
method = &Benchmark::XORUpdateRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "appendrandom") {
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
method = &Benchmark::AppendRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "mergerandom") {
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
if (FLAGS_merge_operator.empty()) {
|
|
|
|
fprintf(stdout, "%-12s : skipped (--merge_operator is unknown)\n",
|
2015-08-11 18:46:15 +00:00
|
|
|
name.c_str());
|
2014-04-08 18:21:09 +00:00
|
|
|
exit(1);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
method = &Benchmark::MergeRandom;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "randomwithverify") {
|
2013-02-20 01:51:06 +00:00
|
|
|
method = &Benchmark::RandomWithVerify;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "fillseekseq") {
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
method = &Benchmark::WriteSeqSeekSeq;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "compact") {
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::Compact;
|
2017-05-30 23:33:26 +00:00
|
|
|
} else if (name == "compactall") {
|
|
|
|
CompactAll();
|
2021-03-17 16:10:24 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
} else if (name == "compact0") {
|
|
|
|
CompactLevel(0);
|
|
|
|
} else if (name == "compact1") {
|
|
|
|
CompactLevel(1);
|
|
|
|
} else if (name == "waitforcompaction") {
|
|
|
|
WaitForCompaction();
|
|
|
|
#endif
|
|
|
|
} else if (name == "flush") {
|
|
|
|
Flush();
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "crc32c") {
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::Crc32c;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "xxhash") {
|
2014-05-01 18:09:32 +00:00
|
|
|
method = &Benchmark::xxHash;
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
} else if (name == "xxhash64") {
|
|
|
|
method = &Benchmark::xxHash64;
|
|
|
|
} else if (name == "xxh3") {
|
|
|
|
method = &Benchmark::xxh3;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "acquireload") {
|
2011-08-22 21:08:51 +00:00
|
|
|
method = &Benchmark::AcquireLoad;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "compress") {
|
2014-02-08 02:12:30 +00:00
|
|
|
method = &Benchmark::Compress;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "uncompress") {
|
2014-02-08 02:12:30 +00:00
|
|
|
method = &Benchmark::Uncompress;
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "randomtransaction") {
|
2015-05-29 21:36:35 +00:00
|
|
|
method = &Benchmark::RandomTransaction;
|
|
|
|
post_process_method = &Benchmark::RandomTransactionVerify;
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
} else if (name == "randomreplacekeys") {
|
|
|
|
fresh_db = true;
|
|
|
|
method = &Benchmark::RandomReplaceKeys;
|
2016-08-01 19:28:51 +00:00
|
|
|
} else if (name == "timeseries") {
|
|
|
|
timestamp_emulator_.reset(new TimestampEmulator());
|
|
|
|
if (FLAGS_expire_style == "compaction_filter") {
|
|
|
|
filter.reset(new ExpiredTimeFilter(timestamp_emulator_));
|
|
|
|
fprintf(stdout, "Compaction filter is used to remove expired data");
|
|
|
|
open_options_.compaction_filter = filter.get();
|
|
|
|
}
|
|
|
|
fresh_db = true;
|
|
|
|
method = &Benchmark::TimeSeries;
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "stats") {
|
2013-10-05 05:32:05 +00:00
|
|
|
PrintStats("rocksdb.stats");
|
2017-04-18 23:30:51 +00:00
|
|
|
} else if (name == "resetstats") {
|
|
|
|
ResetStats();
|
2017-04-07 18:25:42 +00:00
|
|
|
} else if (name == "verify") {
|
|
|
|
VerifyDBFromDB(FLAGS_truth_db);
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "levelstats") {
|
2013-10-05 05:32:05 +00:00
|
|
|
PrintStats("rocksdb.levelstats");
|
2021-03-17 16:10:24 +00:00
|
|
|
} else if (name == "memstats") {
|
|
|
|
std::vector<std::string> keys{"rocksdb.num-immutable-mem-table",
|
|
|
|
"rocksdb.cur-size-active-mem-table",
|
|
|
|
"rocksdb.cur-size-all-mem-tables",
|
|
|
|
"rocksdb.size-all-mem-tables",
|
|
|
|
"rocksdb.num-entries-active-mem-table",
|
|
|
|
"rocksdb.num-entries-imm-mem-tables"};
|
|
|
|
PrintStats(keys);
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (name == "sstables") {
|
2013-10-05 05:32:05 +00:00
|
|
|
PrintStats("rocksdb.sstables");
|
2019-07-04 02:03:29 +00:00
|
|
|
} else if (name == "stats_history") {
|
|
|
|
PrintStatsHistory();
|
2021-08-12 02:31:44 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2018-08-01 07:14:43 +00:00
|
|
|
} else if (name == "replay") {
|
|
|
|
if (num_threads > 1) {
|
|
|
|
fprintf(stderr, "Multi-threaded replay is not yet supported\n");
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2018-08-01 07:14:43 +00:00
|
|
|
}
|
|
|
|
if (FLAGS_trace_file == "") {
|
|
|
|
fprintf(stderr, "Please set --trace_file to be replayed from\n");
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2018-08-01 07:14:43 +00:00
|
|
|
}
|
|
|
|
method = &Benchmark::Replay;
|
2021-08-12 02:31:44 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
New API to get all merge operands for a Key (#5604)
Summary:
This is a new API added to db.h to allow for fetching all merge operands associated with a Key. The main motivation for this API is to support use cases where doing a full online merge is not necessary as it is performance sensitive. Example use-cases:
1. Update subset of columns and read subset of columns -
Imagine a SQL Table, a row is encoded as a K/V pair (as it is done in MyRocks). If there are many columns and users only updated one of them, we can use merge operator to reduce write amplification. While users only read one or two columns in the read query, this feature can avoid a full merging of the whole row, and save some CPU.
2. Updating very few attributes in a value which is a JSON-like document -
Updating one attribute can be done efficiently using merge operator, while reading back one attribute can be done more efficiently if we don't need to do a full merge.
----------------------------------------------------------------------------------------------------
API :
Status GetMergeOperands(
const ReadOptions& options, ColumnFamilyHandle* column_family,
const Slice& key, PinnableSlice* merge_operands,
GetMergeOperandsOptions* get_merge_operands_options,
int* number_of_operands)
Example usage :
int size = 100;
int number_of_operands = 0;
std::vector<PinnableSlice> values(size);
GetMergeOperandsOptions merge_operands_info;
db_->GetMergeOperands(ReadOptions(), db_->DefaultColumnFamily(), "k1", values.data(), merge_operands_info, &number_of_operands);
Description :
Returns all the merge operands corresponding to the key. If the number of merge operands in DB is greater than merge_operands_options.expected_max_number_of_operands no merge operands are returned and status is Incomplete. Merge operands returned are in the order of insertion.
merge_operands-> Points to an array of at-least merge_operands_options.expected_max_number_of_operands and the caller is responsible for allocating it. If the status returned is Incomplete then number_of_operands will contain the total number of merge operands found in DB for key.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5604
Test Plan:
Added unit test and perf test in db_bench that can be run using the command:
./db_bench -benchmarks=getmergeoperands --merge_operator=sortlist
Differential Revision: D16657366
Pulled By: vjnadimpalli
fbshipit-source-id: 0faadd752351745224ee12d4ae9ef3cb529951bf
2019-08-06 21:22:34 +00:00
|
|
|
} else if (name == "getmergeoperands") {
|
|
|
|
method = &Benchmark::GetMergeOperands;
|
2022-02-17 07:17:03 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
} else if (name == "verifychecksum") {
|
|
|
|
method = &Benchmark::VerifyChecksum;
|
|
|
|
} else if (name == "verifyfilechecksums") {
|
|
|
|
method = &Benchmark::VerifyFileChecksums;
|
|
|
|
#endif // ROCKSDB_LITE
|
2022-04-01 04:23:58 +00:00
|
|
|
} else if (name == "readrandomoperands") {
|
|
|
|
read_operands_ = true;
|
|
|
|
method = &Benchmark::ReadRandom;
|
2022-05-24 17:28:57 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
} else if (name == "backup") {
|
|
|
|
method = &Benchmark::Backup;
|
|
|
|
} else if (name == "restore") {
|
|
|
|
method = &Benchmark::Restore;
|
|
|
|
#endif
|
2015-08-11 18:46:15 +00:00
|
|
|
} else if (!name.empty()) { // No error message for empty name
|
|
|
|
fprintf(stderr, "unknown benchmark '%s'\n", name.c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
|
|
|
|
if (fresh_db) {
|
|
|
|
if (FLAGS_use_existing_db) {
|
|
|
|
fprintf(stdout, "%-12s : skipped (--use_existing_db is true)\n",
|
2015-08-11 18:46:15 +00:00
|
|
|
name.c_str());
|
2013-02-15 19:53:17 +00:00
|
|
|
method = nullptr;
|
2011-08-22 21:08:51 +00:00
|
|
|
} else {
|
2014-08-19 01:15:01 +00:00
|
|
|
if (db_.db != nullptr) {
|
2015-05-29 21:36:35 +00:00
|
|
|
db_.DeleteDBs();
|
2014-12-23 02:39:28 +00:00
|
|
|
DestroyDB(FLAGS_db, open_options_);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
2016-10-18 23:30:57 +00:00
|
|
|
Options options = open_options_;
|
2014-04-11 19:15:09 +00:00
|
|
|
for (size_t i = 0; i < multi_dbs_.size(); i++) {
|
2014-08-19 01:15:01 +00:00
|
|
|
delete multi_dbs_[i].db;
|
2016-10-18 23:30:57 +00:00
|
|
|
if (!open_options_.wal_dir.empty()) {
|
|
|
|
options.wal_dir = GetPathForMultiple(open_options_.wal_dir, i);
|
|
|
|
}
|
|
|
|
DestroyDB(GetPathForMultiple(FLAGS_db, i), options);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
multi_dbs_.clear();
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
2014-12-23 02:39:28 +00:00
|
|
|
Open(&open_options_); // use open_options for the last accessed
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
|
|
|
|
2013-02-15 19:53:17 +00:00
|
|
|
if (method != nullptr) {
|
2013-10-24 14:43:14 +00:00
|
|
|
fprintf(stdout, "DB path: [%s]\n", FLAGS_db.c_str());
|
2018-08-01 07:14:43 +00:00
|
|
|
|
2018-08-03 18:56:23 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2022-05-24 17:28:57 +00:00
|
|
|
if (name == "backup") {
|
|
|
|
std::cout << "Backup path: [" << FLAGS_backup_dir << "]" << std::endl;
|
|
|
|
} else if (name == "restore") {
|
|
|
|
std::cout << "Backup path: [" << FLAGS_backup_dir << "]" << std::endl;
|
|
|
|
std::cout << "Restore path: [" << FLAGS_restore_dir << "]"
|
|
|
|
<< std::endl;
|
|
|
|
}
|
2018-08-01 07:14:43 +00:00
|
|
|
// A trace_file option can be provided both for trace and replay
|
|
|
|
// operations. But db_bench does not support tracing and replaying at
|
|
|
|
// the same time, for now. So, start tracing only when it is not a
|
|
|
|
// replay.
|
|
|
|
if (FLAGS_trace_file != "" && name != "replay") {
|
|
|
|
std::unique_ptr<TraceWriter> trace_writer;
|
|
|
|
Status s = NewFileTraceWriter(FLAGS_env, EnvOptions(),
|
|
|
|
FLAGS_trace_file, &trace_writer);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Encountered an error starting a trace, %s\n",
|
|
|
|
s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2018-08-01 07:14:43 +00:00
|
|
|
}
|
|
|
|
s = db_.db->StartTrace(trace_options_, std::move(trace_writer));
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Encountered an error starting a trace, %s\n",
|
|
|
|
s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2018-08-01 07:14:43 +00:00
|
|
|
}
|
|
|
|
fprintf(stdout, "Tracing the workload to: [%s]\n",
|
|
|
|
FLAGS_trace_file.c_str());
|
|
|
|
}
|
2019-06-17 18:03:47 +00:00
|
|
|
// Start block cache tracing.
|
|
|
|
if (!FLAGS_block_cache_trace_file.empty()) {
|
|
|
|
// Sanity checks.
|
|
|
|
if (FLAGS_block_cache_trace_sampling_frequency <= 0) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Block cache trace sampling frequency must be higher than "
|
|
|
|
"0.\n");
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2019-06-17 18:03:47 +00:00
|
|
|
}
|
|
|
|
if (FLAGS_block_cache_trace_max_trace_file_size_in_bytes <= 0) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"The maximum file size for block cache tracing must be "
|
|
|
|
"higher than 0.\n");
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2019-06-17 18:03:47 +00:00
|
|
|
}
|
|
|
|
block_cache_trace_options_.max_trace_file_size =
|
|
|
|
FLAGS_block_cache_trace_max_trace_file_size_in_bytes;
|
|
|
|
block_cache_trace_options_.sampling_frequency =
|
|
|
|
FLAGS_block_cache_trace_sampling_frequency;
|
|
|
|
std::unique_ptr<TraceWriter> block_cache_trace_writer;
|
|
|
|
Status s = NewFileTraceWriter(FLAGS_env, EnvOptions(),
|
|
|
|
FLAGS_block_cache_trace_file,
|
|
|
|
&block_cache_trace_writer);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Encountered an error when creating trace writer, %s\n",
|
|
|
|
s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2019-06-17 18:03:47 +00:00
|
|
|
}
|
|
|
|
s = db_.db->StartBlockCacheTrace(block_cache_trace_options_,
|
|
|
|
std::move(block_cache_trace_writer));
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(
|
|
|
|
stderr,
|
|
|
|
"Encountered an error when starting block cache tracing, %s\n",
|
|
|
|
s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2019-06-17 18:03:47 +00:00
|
|
|
}
|
|
|
|
fprintf(stdout, "Tracing block cache accesses to: [%s]\n",
|
|
|
|
FLAGS_block_cache_trace_file.c_str());
|
|
|
|
}
|
2018-08-03 18:56:23 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2018-08-01 07:14:43 +00:00
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
if (num_warmup > 0) {
|
|
|
|
printf("Warming up benchmark by running %d times\n", num_warmup);
|
|
|
|
}
|
|
|
|
|
|
|
|
for (int i = 0; i < num_warmup; i++) {
|
|
|
|
RunBenchmark(num_threads, name, method);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (num_repeat > 1) {
|
|
|
|
printf("Running benchmark for %d times\n", num_repeat);
|
|
|
|
}
|
|
|
|
|
|
|
|
CombinedStats combined_stats;
|
|
|
|
for (int i = 0; i < num_repeat; i++) {
|
|
|
|
Stats stats = RunBenchmark(num_threads, name, method);
|
|
|
|
combined_stats.AddStats(stats);
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
if (FLAGS_confidence_interval_only) {
|
|
|
|
combined_stats.ReportWithConfidenceIntervals(name);
|
|
|
|
} else {
|
|
|
|
combined_stats.Report(name);
|
|
|
|
}
|
2016-08-25 19:57:35 +00:00
|
|
|
}
|
|
|
|
if (num_repeat > 1) {
|
Add 95% confidence intervals to db_bench output (#9882)
Summary:
Enhancing `db_bench` output with 95% statistical confidence intervals for better performance evaluation. The goal is to unambiguously separate random variance when running benchmark over multiple iterations.
Output enhanced with confidence intervals exposed in brackets:
```
$ ./db_bench --benchmarks=fillseq[-X10]
Running benchmark for 10 times
fillseq : 4.961 micros/op 201578 ops/sec; 22.3 MB/s
fillseq : 5.030 micros/op 198824 ops/sec; 22.0 MB/s
fillseq [AVG 2 runs] : 200201 (± 2698) ops/sec; 22.1 (± 0.3) MB/sec
fillseq : 4.963 micros/op 201471 ops/sec; 22.3 MB/s
fillseq [AVG 3 runs] : 200624 (± 1765) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 5.035 micros/op 198625 ops/sec; 22.0 MB/s
fillseq [AVG 4 runs] : 200124 (± 1586) ops/sec; 22.1 (± 0.2) MB/sec
fillseq : 4.979 micros/op 200861 ops/sec; 22.2 MB/s
fillseq [AVG 5 runs] : 200272 (± 1262) ops/sec; 22.2 (± 0.1) MB/sec
fillseq : 4.893 micros/op 204367 ops/sec; 22.6 MB/s
fillseq [AVG 6 runs] : 200954 (± 1688) ops/sec; 22.2 (± 0.2) MB/sec
fillseq : 4.914 micros/op 203502 ops/sec; 22.5 MB/s
fillseq [AVG 7 runs] : 201318 (± 1595) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.998 micros/op 200074 ops/sec; 22.1 MB/s
fillseq [AVG 8 runs] : 201163 (± 1415) ops/sec; 22.3 (± 0.2) MB/sec
fillseq : 4.946 micros/op 202188 ops/sec; 22.4 MB/s
fillseq [AVG 9 runs] : 201277 (± 1267) ops/sec; 22.3 (± 0.1) MB/sec
fillseq : 5.093 micros/op 196331 ops/sec; 21.7 MB/s
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [AVG 10 runs] : 200782 (± 1491) ops/sec; 22.2 (± 0.2) MB/sec
fillseq [MEDIAN 10 runs] : 201166 ops/sec; 22.3 MB/s
```
For more explicit interval representation, use `--confidence_interval_only` flag:
```
$ ./db_bench --benchmarks=fillseq[-X10] --confidence_interval_only
Running benchmark for 10 times
fillseq : 4.935 micros/op 202648 ops/sec; 22.4 MB/s
fillseq : 5.078 micros/op 196943 ops/sec; 21.8 MB/s
fillseq [CI95 2 runs] : (194205, 205385) ops/sec; (21.5, 22.7) MB/sec
fillseq : 5.159 micros/op 193816 ops/sec; 21.4 MB/s
fillseq [CI95 3 runs] : (192735, 202869) ops/sec; (21.3, 22.4) MB/sec
fillseq : 4.947 micros/op 202158 ops/sec; 22.4 MB/s
fillseq [CI95 4 runs] : (194721, 203061) ops/sec; (21.5, 22.5) MB/sec
fillseq : 4.908 micros/op 203756 ops/sec; 22.5 MB/s
fillseq [CI95 5 runs] : (196113, 203615) ops/sec; (21.7, 22.5) MB/sec
fillseq : 5.063 micros/op 197528 ops/sec; 21.9 MB/s
fillseq [CI95 6 runs] : (196319, 202631) ops/sec; (21.7, 22.4) MB/sec
fillseq : 5.214 micros/op 191799 ops/sec; 21.2 MB/s
fillseq [CI95 7 runs] : (194953, 201803) ops/sec; (21.6, 22.3) MB/sec
fillseq : 5.260 micros/op 190095 ops/sec; 21.0 MB/s
fillseq [CI95 8 runs] : (193749, 200937) ops/sec; (21.4, 22.2) MB/sec
fillseq : 5.076 micros/op 196992 ops/sec; 21.8 MB/s
fillseq [CI95 9 runs] : (194134, 200474) ops/sec; (21.5, 22.2) MB/sec
fillseq : 5.388 micros/op 185603 ops/sec; 20.5 MB/s
fillseq [CI95 10 runs] : (192487, 199781) ops/sec; (21.3, 22.1) MB/sec
fillseq [AVG 10 runs] : 196134 (± 3647) ops/sec; 21.7 (± 0.4) MB/sec
fillseq [MEDIAN 10 runs] : 196968 ops/sec; 21.8 MB/sec
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9882
Reviewed By: pdillinger
Differential Revision: D35796148
Pulled By: vanekjar
fbshipit-source-id: 8313712d16728ff982b8aff28195ee56622385b8
2022-04-25 21:49:54 +00:00
|
|
|
combined_stats.ReportFinal(name);
|
2016-08-25 19:57:35 +00:00
|
|
|
}
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
2015-05-29 21:36:35 +00:00
|
|
|
if (post_process_method != nullptr) {
|
|
|
|
(this->*post_process_method)();
|
|
|
|
}
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
2018-08-01 07:14:43 +00:00
|
|
|
|
2019-05-31 02:29:34 +00:00
|
|
|
if (secondary_update_thread_) {
|
|
|
|
secondary_update_stopped_.store(1, std::memory_order_relaxed);
|
|
|
|
secondary_update_thread_->join();
|
|
|
|
secondary_update_thread_.reset();
|
|
|
|
}
|
|
|
|
|
2018-08-03 18:56:23 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2018-08-01 07:14:43 +00:00
|
|
|
if (name != "replay" && FLAGS_trace_file != "") {
|
|
|
|
Status s = db_.db->EndTrace();
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Encountered an error ending the trace, %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
}
|
|
|
|
}
|
2019-06-17 18:03:47 +00:00
|
|
|
if (!FLAGS_block_cache_trace_file.empty()) {
|
|
|
|
Status s = db_.db->EndBlockCacheTrace();
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Encountered an error ending the block cache tracing, %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
}
|
|
|
|
}
|
2018-08-03 18:56:23 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2018-08-01 07:14:43 +00:00
|
|
|
|
2013-06-19 03:28:41 +00:00
|
|
|
if (FLAGS_statistics) {
|
2015-12-16 02:20:10 +00:00
|
|
|
fprintf(stdout, "STATISTICS:\n%s\n", dbstats->ToString().c_str());
|
2013-06-19 03:28:41 +00:00
|
|
|
}
|
2016-05-25 00:27:44 +00:00
|
|
|
if (FLAGS_simcache_size >= 0) {
|
2020-04-29 20:06:27 +00:00
|
|
|
fprintf(
|
|
|
|
stdout, "SIMULATOR CACHE STATISTICS:\n%s\n",
|
|
|
|
static_cast_with_check<SimCache>(cache_.get())->ToString().c_str());
|
2016-05-24 06:35:23 +00:00
|
|
|
}
|
2019-05-31 15:24:05 +00:00
|
|
|
|
|
|
|
#ifndef ROCKSDB_LITE
|
2019-05-31 02:29:34 +00:00
|
|
|
if (FLAGS_use_secondary_db) {
|
|
|
|
fprintf(stdout, "Secondary instance updated %" PRIu64 " times.\n",
|
|
|
|
secondary_db_updates_);
|
|
|
|
}
|
2019-05-31 15:24:05 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
|
2011-03-22 18:32:49 +00:00
|
|
|
private:
|
2016-08-01 19:28:51 +00:00
|
|
|
std::shared_ptr<TimestampEmulator> timestamp_emulator_;
|
2019-05-31 02:29:34 +00:00
|
|
|
std::unique_ptr<port::Thread> secondary_update_thread_;
|
|
|
|
std::atomic<int> secondary_update_stopped_{0};
|
2019-07-24 00:08:26 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2019-05-31 02:29:34 +00:00
|
|
|
uint64_t secondary_db_updates_ = 0;
|
2019-07-24 00:08:26 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2011-08-22 21:08:51 +00:00
|
|
|
struct ThreadArg {
|
|
|
|
Benchmark* bm;
|
|
|
|
SharedState* shared;
|
|
|
|
ThreadState* thread;
|
|
|
|
void (Benchmark::*method)(ThreadState*);
|
|
|
|
};
|
|
|
|
|
|
|
|
static void ThreadBody(void* v) {
|
|
|
|
ThreadArg* arg = reinterpret_cast<ThreadArg*>(v);
|
|
|
|
SharedState* shared = arg->shared;
|
|
|
|
ThreadState* thread = arg->thread;
|
|
|
|
{
|
|
|
|
MutexLock l(&shared->mu);
|
|
|
|
shared->num_initialized++;
|
|
|
|
if (shared->num_initialized >= shared->total) {
|
|
|
|
shared->cv.SignalAll();
|
|
|
|
}
|
|
|
|
while (!shared->start) {
|
|
|
|
shared->cv.Wait();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2013-11-18 19:32:54 +00:00
|
|
|
SetPerfLevel(static_cast<PerfLevel> (shared->perf_level));
|
2018-10-17 18:18:00 +00:00
|
|
|
perf_context.EnablePerLevelPerfContext();
|
2012-10-03 13:51:11 +00:00
|
|
|
thread->stats.Start(thread->tid);
|
2011-08-22 21:08:51 +00:00
|
|
|
(arg->bm->*(arg->method))(thread);
|
2022-07-22 16:19:25 +00:00
|
|
|
if (FLAGS_perf_level > ROCKSDB_NAMESPACE::PerfLevel::kDisable) {
|
|
|
|
thread->stats.AddMessage(std::string("PERF_CONTEXT:\n") +
|
|
|
|
get_perf_context()->ToString());
|
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.Stop();
|
|
|
|
|
|
|
|
{
|
|
|
|
MutexLock l(&shared->mu);
|
|
|
|
shared->num_done++;
|
|
|
|
if (shared->num_done >= shared->total) {
|
|
|
|
shared->cv.SignalAll();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
Stats RunBenchmark(int n, Slice name,
|
|
|
|
void (Benchmark::*method)(ThreadState*)) {
|
2011-08-22 21:08:51 +00:00
|
|
|
SharedState shared;
|
|
|
|
shared.total = n;
|
|
|
|
shared.num_initialized = 0;
|
|
|
|
shared.num_done = 0;
|
|
|
|
shared.start = false;
|
2015-06-17 23:44:52 +00:00
|
|
|
if (FLAGS_benchmark_write_rate_limit > 0) {
|
|
|
|
shared.write_rate_limiter.reset(
|
|
|
|
NewGenericRateLimiter(FLAGS_benchmark_write_rate_limit));
|
|
|
|
}
|
2016-12-19 20:25:35 +00:00
|
|
|
if (FLAGS_benchmark_read_rate_limit > 0) {
|
2017-06-13 21:51:22 +00:00
|
|
|
shared.read_rate_limiter.reset(NewGenericRateLimiter(
|
|
|
|
FLAGS_benchmark_read_rate_limit, 100000 /* refill_period_us */,
|
|
|
|
10 /* fairness */, RateLimiter::Mode::kReadsOnly));
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
std::unique_ptr<ReporterAgent> reporter_agent;
|
|
|
|
if (FLAGS_report_interval_seconds > 0) {
|
|
|
|
reporter_agent.reset(new ReporterAgent(FLAGS_env, FLAGS_report_file,
|
|
|
|
FLAGS_report_interval_seconds));
|
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
ThreadArg* arg = new ThreadArg[n];
|
2014-07-07 17:53:31 +00:00
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
for (int i = 0; i < n; i++) {
|
2014-07-07 17:53:31 +00:00
|
|
|
#ifdef NUMA
|
|
|
|
if (FLAGS_enable_numa) {
|
|
|
|
// Performs a local allocation of memory to threads in numa node.
|
|
|
|
int n_nodes = numa_num_task_nodes(); // Number of nodes in NUMA.
|
|
|
|
numa_exit_on_error = 1;
|
|
|
|
int numa_node = i % n_nodes;
|
|
|
|
bitmask* nodes = numa_allocate_nodemask();
|
|
|
|
numa_bitmask_clearall(nodes);
|
|
|
|
numa_bitmask_setbit(nodes, numa_node);
|
|
|
|
// numa_bind() call binds the process to the node and these
|
|
|
|
// properties are passed on to the thread that is created in
|
|
|
|
// StartThread method called later in the loop.
|
|
|
|
numa_bind(nodes);
|
|
|
|
numa_set_strict(1);
|
|
|
|
numa_free_nodemask(nodes);
|
|
|
|
}
|
|
|
|
#endif
|
2011-08-22 21:08:51 +00:00
|
|
|
arg[i].bm = this;
|
|
|
|
arg[i].method = method;
|
|
|
|
arg[i].shared = &shared;
|
2022-03-24 15:57:48 +00:00
|
|
|
total_thread_count_++;
|
2022-03-25 22:30:28 +00:00
|
|
|
arg[i].thread = new ThreadState(i, total_thread_count_);
|
db_bench periodically writes QPS to CSV file
Summary:
This is part of an effort to better understand and optimize RocksDB stalls under high load. I added a feature to db_bench to periodically write QPS to CSV files. That way we can nicely see how our QPS changes in time (especially when DB is stalled) and can do a better job of evaluating our stall system (i.e. we want the QPS to be as constant as possible, as opposed to having bunch of stalls)
Cool part of CSV files is that we can easily graph them -- there are a bunch of tools available.
Test Plan:
Ran ./db_bench --report_interval_seconds=10 --benchmarks=fillrandom --num=10000000
and observed this in report.csv:
secs_elapsed,interval_qps
10,2725860
20,1980480
30,1863456
40,1454359
50,1460389
Reviewers: sdong, MarkCallaghan, rven, yhchiang
Reviewed By: yhchiang
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D40047
2015-06-12 21:31:53 +00:00
|
|
|
arg[i].thread->stats.SetReporterAgent(reporter_agent.get());
|
2011-09-01 19:08:02 +00:00
|
|
|
arg[i].thread->shared = &shared;
|
2012-06-08 08:11:14 +00:00
|
|
|
FLAGS_env->StartThread(ThreadBody, &arg[i]);
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
shared.mu.Lock();
|
|
|
|
while (shared.num_initialized < n) {
|
|
|
|
shared.cv.Wait();
|
|
|
|
}
|
|
|
|
|
|
|
|
shared.start = true;
|
|
|
|
shared.cv.SignalAll();
|
|
|
|
while (shared.num_done < n) {
|
|
|
|
shared.cv.Wait();
|
|
|
|
}
|
|
|
|
shared.mu.Unlock();
|
|
|
|
|
2013-03-19 13:36:03 +00:00
|
|
|
// Stats for some threads can be excluded.
|
|
|
|
Stats merge_stats;
|
|
|
|
for (int i = 0; i < n; i++) {
|
|
|
|
merge_stats.Merge(arg[i].thread->stats);
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
2013-03-19 13:36:03 +00:00
|
|
|
merge_stats.Report(name);
|
2011-08-22 21:08:51 +00:00
|
|
|
|
2016-09-02 17:58:08 +00:00
|
|
|
for (int i = 0; i < n; i++) {
|
|
|
|
delete arg[i].thread;
|
|
|
|
}
|
|
|
|
delete[] arg;
|
|
|
|
|
2016-08-25 19:57:35 +00:00
|
|
|
return merge_stats;
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
|
|
|
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
template <OperationType kOpType, typename FnType, typename... Args>
|
|
|
|
static inline void ChecksumBenchmark(FnType fn, ThreadState* thread,
|
|
|
|
Args... args) {
|
Port 3 way SSE4.2 crc32c implementation from Folly
Summary:
**# Summary**
RocksDB uses SSE crc32 intrinsics to calculate the crc32 values but it does it in single way fashion (not pipelined on single CPU core). Intel's whitepaper () published an algorithm that uses 3-way pipelining for the crc32 intrinsics, then use pclmulqdq intrinsic to combine the values. Because pclmulqdq has overhead on its own, this algorithm will show perf gains on buffers larger than 216 bytes, which makes RocksDB a perfect user, since most of the buffers RocksDB call crc32c on is over 4KB. Initial db_bench show tremendous CPU gain.
This change uses the 3-way SSE algorithm by default. The old SSE algorithm is now behind a compiler tag NO_THREEWAY_CRC32C. If user compiles the code with NO_THREEWAY_CRC32C=1 then the old SSE Crc32c algorithm would be used. If the server does not have SSE4.2 at the run time the slow way (Non SSE) will be used.
**# Performance Test Results**
We ran the FillRandom and ReadRandom benchmarks in db_bench. ReadRandom is the point of interest here since it calculates the CRC32 for the in-mem buffers. We did 3 runs for each algorithm.
Before this change the CRC32 value computation takes about 11.5% of total CPU cost, and with the new 3-way algorithm it reduced to around 4.5%. The overall throughput also improved from 25.53MB/s to 27.63MB/s.
1) ReadRandom in db_bench overall metrics
PER RUN
Algorithm | run | micros/op | ops/sec |Throughput (MB/s)
3-way | 1 | 4.143 | 241387 | 26.7
3-way | 2 | 3.775 | 264872 | 29.3
3-way | 3 | 4.116 | 242929 | 26.9
FastCrc32c|1 | 4.037 | 247727 | 27.4
FastCrc32c|2 | 4.648 | 215166 | 23.8
FastCrc32c|3 | 4.352 | 229799 | 25.4
AVG
Algorithm | Average of micros/op | Average of ops/sec | Average of Throughput (MB/s)
3-way | 4.01 | 249,729 | 27.63
FastCrc32c | 4.35 | 230,897 | 25.53
2) Crc32c computation CPU cost (inclusive samples percentage)
PER RUN
Implementation | run | TotalSamples | Crc32c percentage
3-way | 1 | 4,572,250,000 | 4.37%
3-way | 2 | 3,779,250,000 | 4.62%
3-way | 3 | 4,129,500,000 | 4.48%
FastCrc32c | 1 | 4,663,500,000 | 11.24%
FastCrc32c | 2 | 4,047,500,000 | 12.34%
FastCrc32c | 3 | 4,366,750,000 | 11.68%
**# Test Plan**
make -j64 corruption_test && ./corruption_test
By default it uses 3-way SSE algorithm
NO_THREEWAY_CRC32C=1 make -j64 corruption_test && ./corruption_test
make clean && DEBUG_LEVEL=0 make -j64 db_bench
make clean && DEBUG_LEVEL=0 NO_THREEWAY_CRC32C=1 make -j64 db_bench
Closes https://github.com/facebook/rocksdb/pull/3173
Differential Revision: D6330882
Pulled By: yingsu00
fbshipit-source-id: 8ec3d89719533b63b536a736663ca6f0dd4482e9
2017-12-20 02:20:50 +00:00
|
|
|
const int size = FLAGS_block_size; // use --block_size option for db_bench
|
2022-05-06 20:03:58 +00:00
|
|
|
std::string labels = "(" + std::to_string(FLAGS_block_size) + " per op)";
|
Port 3 way SSE4.2 crc32c implementation from Folly
Summary:
**# Summary**
RocksDB uses SSE crc32 intrinsics to calculate the crc32 values but it does it in single way fashion (not pipelined on single CPU core). Intel's whitepaper () published an algorithm that uses 3-way pipelining for the crc32 intrinsics, then use pclmulqdq intrinsic to combine the values. Because pclmulqdq has overhead on its own, this algorithm will show perf gains on buffers larger than 216 bytes, which makes RocksDB a perfect user, since most of the buffers RocksDB call crc32c on is over 4KB. Initial db_bench show tremendous CPU gain.
This change uses the 3-way SSE algorithm by default. The old SSE algorithm is now behind a compiler tag NO_THREEWAY_CRC32C. If user compiles the code with NO_THREEWAY_CRC32C=1 then the old SSE Crc32c algorithm would be used. If the server does not have SSE4.2 at the run time the slow way (Non SSE) will be used.
**# Performance Test Results**
We ran the FillRandom and ReadRandom benchmarks in db_bench. ReadRandom is the point of interest here since it calculates the CRC32 for the in-mem buffers. We did 3 runs for each algorithm.
Before this change the CRC32 value computation takes about 11.5% of total CPU cost, and with the new 3-way algorithm it reduced to around 4.5%. The overall throughput also improved from 25.53MB/s to 27.63MB/s.
1) ReadRandom in db_bench overall metrics
PER RUN
Algorithm | run | micros/op | ops/sec |Throughput (MB/s)
3-way | 1 | 4.143 | 241387 | 26.7
3-way | 2 | 3.775 | 264872 | 29.3
3-way | 3 | 4.116 | 242929 | 26.9
FastCrc32c|1 | 4.037 | 247727 | 27.4
FastCrc32c|2 | 4.648 | 215166 | 23.8
FastCrc32c|3 | 4.352 | 229799 | 25.4
AVG
Algorithm | Average of micros/op | Average of ops/sec | Average of Throughput (MB/s)
3-way | 4.01 | 249,729 | 27.63
FastCrc32c | 4.35 | 230,897 | 25.53
2) Crc32c computation CPU cost (inclusive samples percentage)
PER RUN
Implementation | run | TotalSamples | Crc32c percentage
3-way | 1 | 4,572,250,000 | 4.37%
3-way | 2 | 3,779,250,000 | 4.62%
3-way | 3 | 4,129,500,000 | 4.48%
FastCrc32c | 1 | 4,663,500,000 | 11.24%
FastCrc32c | 2 | 4,047,500,000 | 12.34%
FastCrc32c | 3 | 4,366,750,000 | 11.68%
**# Test Plan**
make -j64 corruption_test && ./corruption_test
By default it uses 3-way SSE algorithm
NO_THREEWAY_CRC32C=1 make -j64 corruption_test && ./corruption_test
make clean && DEBUG_LEVEL=0 make -j64 db_bench
make clean && DEBUG_LEVEL=0 NO_THREEWAY_CRC32C=1 make -j64 db_bench
Closes https://github.com/facebook/rocksdb/pull/3173
Differential Revision: D6330882
Pulled By: yingsu00
fbshipit-source-id: 8ec3d89719533b63b536a736663ca6f0dd4482e9
2017-12-20 02:20:50 +00:00
|
|
|
const char* label = labels.c_str();
|
|
|
|
|
2011-03-28 20:43:44 +00:00
|
|
|
std::string data(size, 'x');
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
uint64_t bytes = 0;
|
|
|
|
uint32_t val = 0;
|
|
|
|
while (bytes < 5000U * uint64_t{1048576}) { // ~5GB
|
|
|
|
val += static_cast<uint32_t>(fn(data.data(), size, args...));
|
|
|
|
thread->stats.FinishedOps(nullptr, nullptr, 1, kOpType);
|
2011-03-25 20:27:43 +00:00
|
|
|
bytes += size;
|
|
|
|
}
|
|
|
|
// Print so result is not dead
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
fprintf(stderr, "... val=0x%x\r", static_cast<unsigned int>(val));
|
2011-03-25 20:27:43 +00:00
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
|
|
|
thread->stats.AddMessage(label);
|
2011-03-25 20:27:43 +00:00
|
|
|
}
|
|
|
|
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
void Crc32c(ThreadState* thread) {
|
|
|
|
ChecksumBenchmark<kCrc>(crc32c::Value, thread);
|
|
|
|
}
|
|
|
|
|
2014-05-01 18:09:32 +00:00
|
|
|
void xxHash(ThreadState* thread) {
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
ChecksumBenchmark<kHash>(XXH32, thread, /*seed*/ 0);
|
|
|
|
}
|
2014-05-01 18:09:32 +00:00
|
|
|
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
void xxHash64(ThreadState* thread) {
|
|
|
|
ChecksumBenchmark<kHash>(XXH64, thread, /*seed*/ 0);
|
|
|
|
}
|
|
|
|
|
|
|
|
void xxh3(ThreadState* thread) {
|
|
|
|
ChecksumBenchmark<kHash>(XXH3_64bits, thread);
|
2014-05-01 18:09:32 +00:00
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void AcquireLoad(ThreadState* thread) {
|
2011-05-28 00:53:58 +00:00
|
|
|
int dummy;
|
2014-10-27 22:41:05 +00:00
|
|
|
std::atomic<void*> ap(&dummy);
|
2011-05-28 00:53:58 +00:00
|
|
|
int count = 0;
|
2013-02-15 19:53:17 +00:00
|
|
|
void *ptr = nullptr;
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddMessage("(each op is 1000 loads)");
|
2011-05-28 00:53:58 +00:00
|
|
|
while (count < 100000) {
|
|
|
|
for (int i = 0; i < 1000; i++) {
|
2014-10-27 21:50:21 +00:00
|
|
|
ptr = ap.load(std::memory_order_acquire);
|
2011-05-28 00:53:58 +00:00
|
|
|
}
|
|
|
|
count++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, nullptr, 1, kOthers);
|
2011-05-28 00:53:58 +00:00
|
|
|
}
|
2016-02-16 14:17:31 +00:00
|
|
|
if (ptr == nullptr) exit(1); // Disable unused variable warning.
|
2011-05-28 00:53:58 +00:00
|
|
|
}
|
|
|
|
|
2014-02-08 02:12:30 +00:00
|
|
|
void Compress(ThreadState *thread) {
|
2011-08-22 21:08:51 +00:00
|
|
|
RandomGenerator gen;
|
2014-08-25 21:22:05 +00:00
|
|
|
Slice input = gen.Generate(FLAGS_block_size);
|
2011-04-12 19:38:58 +00:00
|
|
|
int64_t bytes = 0;
|
|
|
|
int64_t produced = 0;
|
|
|
|
bool ok = true;
|
|
|
|
std::string compressed;
|
2019-01-19 03:10:17 +00:00
|
|
|
CompressionOptions opts;
|
|
|
|
CompressionContext context(FLAGS_compression_type_e);
|
|
|
|
CompressionInfo info(opts, context, CompressionDict::GetEmptyDict(),
|
2019-03-18 19:07:35 +00:00
|
|
|
FLAGS_compression_type_e,
|
|
|
|
FLAGS_sample_for_compression);
|
2014-02-08 02:12:30 +00:00
|
|
|
// Compress 1G
|
|
|
|
while (ok && bytes < int64_t(1) << 30) {
|
2016-01-15 22:13:08 +00:00
|
|
|
compressed.clear();
|
2019-01-19 03:10:17 +00:00
|
|
|
ok = CompressSlice(info, input, &compressed);
|
2011-04-12 19:38:58 +00:00
|
|
|
produced += compressed.size();
|
|
|
|
bytes += input.size();
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, nullptr, 1, kCompress);
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (!ok) {
|
2014-02-08 02:12:30 +00:00
|
|
|
thread->stats.AddMessage("(compression failure)");
|
2011-04-12 19:38:58 +00:00
|
|
|
} else {
|
2016-12-15 03:20:42 +00:00
|
|
|
char buf[340];
|
2011-04-12 19:38:58 +00:00
|
|
|
snprintf(buf, sizeof(buf), "(output: %.1f%%)",
|
|
|
|
(produced * 100.0) / bytes);
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddMessage(buf);
|
|
|
|
thread->stats.AddBytes(bytes);
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-02-08 02:12:30 +00:00
|
|
|
void Uncompress(ThreadState *thread) {
|
2011-08-22 21:08:51 +00:00
|
|
|
RandomGenerator gen;
|
2014-08-25 21:22:05 +00:00
|
|
|
Slice input = gen.Generate(FLAGS_block_size);
|
2011-04-12 19:38:58 +00:00
|
|
|
std::string compressed;
|
2014-02-08 02:12:30 +00:00
|
|
|
|
2019-01-19 03:10:17 +00:00
|
|
|
CompressionContext compression_ctx(FLAGS_compression_type_e);
|
|
|
|
CompressionOptions compression_opts;
|
2019-03-18 19:07:35 +00:00
|
|
|
CompressionInfo compression_info(
|
|
|
|
compression_opts, compression_ctx, CompressionDict::GetEmptyDict(),
|
|
|
|
FLAGS_compression_type_e, FLAGS_sample_for_compression);
|
2018-06-04 19:04:52 +00:00
|
|
|
UncompressionContext uncompression_ctx(FLAGS_compression_type_e);
|
2019-01-19 03:10:17 +00:00
|
|
|
UncompressionInfo uncompression_info(uncompression_ctx,
|
|
|
|
UncompressionDict::GetEmptyDict(),
|
|
|
|
FLAGS_compression_type_e);
|
2018-06-04 19:04:52 +00:00
|
|
|
|
2019-01-19 03:10:17 +00:00
|
|
|
bool ok = CompressSlice(compression_info, input, &compressed);
|
2011-04-12 19:38:58 +00:00
|
|
|
int64_t bytes = 0;
|
2020-09-25 16:00:29 +00:00
|
|
|
size_t uncompressed_size = 0;
|
2014-02-08 02:12:30 +00:00
|
|
|
while (ok && bytes < 1024 * 1048576) {
|
2020-09-25 16:00:29 +00:00
|
|
|
constexpr uint32_t compress_format_version = 2;
|
|
|
|
|
|
|
|
CacheAllocationPtr uncompressed = UncompressData(
|
|
|
|
uncompression_info, compressed.data(), compressed.size(),
|
|
|
|
&uncompressed_size, compress_format_version);
|
|
|
|
|
|
|
|
ok = uncompressed.get() != nullptr;
|
2011-07-21 02:40:18 +00:00
|
|
|
bytes += input.size();
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, nullptr, 1, kUncompress);
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (!ok) {
|
2014-02-08 02:12:30 +00:00
|
|
|
thread->stats.AddMessage("(compression failure)");
|
2011-04-12 19:38:58 +00:00
|
|
|
} else {
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-06-02 23:24:14 +00:00
|
|
|
// Returns true if the options is initialized from the specified
|
|
|
|
// options file.
|
|
|
|
bool InitializeOptionsFromFile(Options* opts) {
|
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
printf("Initializing RocksDB Options from the specified file\n");
|
|
|
|
DBOptions db_opts;
|
|
|
|
std::vector<ColumnFamilyDescriptor> cf_descs;
|
|
|
|
if (FLAGS_options_file != "") {
|
2019-10-22 18:42:00 +00:00
|
|
|
auto s = LoadOptionsFromFile(FLAGS_options_file, FLAGS_env, &db_opts,
|
2016-06-02 23:24:14 +00:00
|
|
|
&cf_descs);
|
2019-10-22 18:42:00 +00:00
|
|
|
db_opts.env = FLAGS_env;
|
2016-06-02 23:24:14 +00:00
|
|
|
if (s.ok()) {
|
|
|
|
*opts = Options(db_opts, cf_descs[0].options);
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
fprintf(stderr, "Unable to load options file %s --- %s\n",
|
|
|
|
FLAGS_options_file.c_str(), s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
2018-04-16 00:19:57 +00:00
|
|
|
#else
|
|
|
|
(void)opts;
|
2016-06-02 23:24:14 +00:00
|
|
|
#endif
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
void InitializeOptionsFromFlags(Options* opts) {
|
|
|
|
printf("Initializing RocksDB Options from command-line flags\n");
|
2014-12-08 20:53:24 +00:00
|
|
|
Options& options = *opts;
|
2021-08-06 15:26:23 +00:00
|
|
|
ConfigOptions config_options(options);
|
2021-09-08 14:45:59 +00:00
|
|
|
config_options.ignore_unsupported_options = false;
|
2014-12-08 20:53:24 +00:00
|
|
|
|
2014-08-19 01:15:01 +00:00
|
|
|
assert(db_.db == nullptr);
|
2014-12-08 20:53:24 +00:00
|
|
|
|
2019-10-22 18:42:00 +00:00
|
|
|
options.env = FLAGS_env;
|
2022-04-19 06:46:16 +00:00
|
|
|
options.wal_dir = FLAGS_wal_dir;
|
|
|
|
options.dump_malloc_stats = FLAGS_dump_malloc_stats;
|
|
|
|
options.stats_dump_period_sec =
|
|
|
|
static_cast<unsigned int>(FLAGS_stats_dump_period_sec);
|
|
|
|
options.stats_persist_period_sec =
|
|
|
|
static_cast<unsigned int>(FLAGS_stats_persist_period_sec);
|
|
|
|
options.persist_stats_to_disk = FLAGS_persist_stats_to_disk;
|
|
|
|
options.stats_history_buffer_size =
|
|
|
|
static_cast<size_t>(FLAGS_stats_history_buffer_size);
|
|
|
|
options.avoid_flush_during_recovery = FLAGS_avoid_flush_during_recovery;
|
|
|
|
|
|
|
|
options.compression_opts.level = FLAGS_compression_level;
|
|
|
|
options.compression_opts.max_dict_bytes = FLAGS_compression_max_dict_bytes;
|
|
|
|
options.compression_opts.zstd_max_train_bytes =
|
|
|
|
FLAGS_compression_zstd_max_train_bytes;
|
|
|
|
options.compression_opts.parallel_threads =
|
|
|
|
FLAGS_compression_parallel_threads;
|
|
|
|
options.compression_opts.max_dict_buffer_bytes =
|
|
|
|
FLAGS_compression_max_dict_buffer_bytes;
|
Support using ZDICT_finalizeDictionary to generate zstd dictionary (#9857)
Summary:
An untrained dictionary is currently simply the concatenation of several samples. The ZSTD API, ZDICT_finalizeDictionary(), can improve such a dictionary's effectiveness at low cost. This PR changes how dictionary is created by calling the ZSTD ZDICT_finalizeDictionary() API instead of creating raw content dictionary (when max_dict_buffer_bytes > 0), and pass in all buffered uncompressed data blocks as samples.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9857
Test Plan:
#### db_bench test for cpu/memory of compression+decompression and space saving on synthetic data:
Set up: change the parameter [here](https://github.com/facebook/rocksdb/blob/fb9a167a55e0970b1ef6f67c1600c8d9c4c6114f/tools/db_bench_tool.cc#L1766) to 16384 to make synthetic data more compressible.
```
# linked local ZSTD with version 1.5.2
# DEBUG_LEVEL=0 ROCKSDB_NO_FBCODE=1 ROCKSDB_DISABLE_ZSTD=1 EXTRA_CXXFLAGS="-DZSTD_STATIC_LINKING_ONLY -DZSTD -I/data/users/changyubi/install/include/" EXTRA_LDFLAGS="-L/data/users/changyubi/install/lib/ -l:libzstd.a" make -j32 db_bench
dict_bytes=16384
train_bytes=1048576
echo "========== No Dictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=0 -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=0 -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
echo "========== Raw Content Dictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench_main -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench_main -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
echo "========== FinalizeDictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
echo "========== TrainDictionary =========="
TEST_TMPDIR=/dev/shm ./db_bench -benchmarks=filluniquerandom,compact -num=10000000 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -block_size=4096 -max_background_jobs=24 -memtablerep=vector -allow_concurrent_memtable_write=false -disable_wal=true -max_write_buffer_number=8 >/dev/null 2>&1
TEST_TMPDIR=/dev/shm /usr/bin/time ./db_bench -use_existing_db=true -benchmarks=compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -block_size=4096 2>&1 | grep elapsed
du -hc /dev/shm/dbbench/*sst | grep total
# Result: TrainDictionary is much better on space saving, but FinalizeDictionary seems to use less memory.
# before compression data size: 1.2GB
dict_bytes=16384
max_dict_buffer_bytes = 1048576
space cpu/memory
No Dictionary 468M 14.93user 1.00system 0:15.92elapsed 100%CPU (0avgtext+0avgdata 23904maxresident)k
Raw Dictionary 251M 15.81user 0.80system 0:16.56elapsed 100%CPU (0avgtext+0avgdata 156808maxresident)k
FinalizeDictionary 236M 11.93user 0.64system 0:12.56elapsed 100%CPU (0avgtext+0avgdata 89548maxresident)k
TrainDictionary 84M 7.29user 0.45system 0:07.75elapsed 100%CPU (0avgtext+0avgdata 97288maxresident)k
```
#### Benchmark on 10 sample SST files for spacing saving and CPU time on compression:
FinalizeDictionary is comparable to TrainDictionary in terms of space saving, and takes less time in compression.
```
dict_bytes=16384
train_bytes=1048576
for sst_file in `ls ../temp/myrock-sst/`
do
echo "********** $sst_file **********"
echo "========== No Dictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD
echo "========== Raw Content Dictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD --compression_max_dict_bytes=$dict_bytes
echo "========== FinalizeDictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD --compression_max_dict_bytes=$dict_bytes --compression_zstd_max_train_bytes=$train_bytes --compression_use_zstd_finalize_dict
echo "========== TrainDictionary =========="
./sst_dump --file="../temp/myrock-sst/$sst_file" --command=recompress --compression_level_from=6 --compression_level_to=6 --compression_types=kZSTD --compression_max_dict_bytes=$dict_bytes --compression_zstd_max_train_bytes=$train_bytes
done
010240.sst (Size/Time) 011029.sst 013184.sst 021552.sst 185054.sst 185137.sst 191666.sst 7560381.sst 7604174.sst 7635312.sst
No Dictionary 28165569 / 2614419 32899411 / 2976832 32977848 / 3055542 31966329 / 2004590 33614351 / 1755877 33429029 / 1717042 33611933 / 1776936 33634045 / 2771417 33789721 / 2205414 33592194 / 388254
Raw Content Dictionary 28019950 / 2697961 33748665 / 3572422 33896373 / 3534701 26418431 / 2259658 28560825 / 1839168 28455030 / 1846039 28494319 / 1861349 32391599 / 3095649 33772142 / 2407843 33592230 / 474523
FinalizeDictionary 27896012 / 2650029 33763886 / 3719427 33904283 / 3552793 26008225 / 2198033 28111872 / 1869530 28014374 / 1789771 28047706 / 1848300 32296254 / 3204027 33698698 / 2381468 33592344 / 517433
TrainDictionary 28046089 / 2740037 33706480 / 3679019 33885741 / 3629351 25087123 / 2204558 27194353 / 1970207 27234229 / 1896811 27166710 / 1903119 32011041 / 3322315 32730692 / 2406146 33608631 / 570593
```
#### Decompression/Read test:
With FinalizeDictionary/TrainDictionary, some data structure used for decompression are in stored in dictionary, so they are expected to be faster in terms of decompression/reads.
```
dict_bytes=16384
train_bytes=1048576
echo "No Dictionary"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=0 > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=0 2>&1 | grep MB/s
echo "Raw Dictionary"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes 2>&1 | grep MB/s
echo "FinalizeDict"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes -compression_use_zstd_dict_trainer=false 2>&1 | grep MB/s
echo "Train Dictionary"
TEST_TMPDIR=/dev/shm/ ./db_bench -benchmarks=filluniquerandom,compact -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes > /dev/null 2>&1
TEST_TMPDIR=/dev/shm/ ./db_bench -use_existing_db=true -benchmarks=readrandom -cache_size=0 -compression_type=zstd -compression_max_dict_bytes=$dict_bytes -compression_zstd_max_train_bytes=$train_bytes 2>&1 | grep MB/s
No Dictionary
readrandom : 12.183 micros/op 82082 ops/sec 12.183 seconds 1000000 operations; 9.1 MB/s (1000000 of 1000000 found)
Raw Dictionary
readrandom : 12.314 micros/op 81205 ops/sec 12.314 seconds 1000000 operations; 9.0 MB/s (1000000 of 1000000 found)
FinalizeDict
readrandom : 9.787 micros/op 102180 ops/sec 9.787 seconds 1000000 operations; 11.3 MB/s (1000000 of 1000000 found)
Train Dictionary
readrandom : 9.698 micros/op 103108 ops/sec 9.699 seconds 1000000 operations; 11.4 MB/s (1000000 of 1000000 found)
```
Reviewed By: ajkr
Differential Revision: D35720026
Pulled By: cbi42
fbshipit-source-id: 24d230fdff0fd28a1bb650658798f00dfcfb2a1f
2022-05-20 19:09:09 +00:00
|
|
|
options.compression_opts.use_zstd_dict_trainer =
|
|
|
|
FLAGS_compression_use_zstd_dict_trainer;
|
2022-04-19 06:46:16 +00:00
|
|
|
|
2016-06-02 23:24:14 +00:00
|
|
|
options.max_open_files = FLAGS_open_files;
|
2017-06-02 21:13:59 +00:00
|
|
|
if (FLAGS_cost_write_buffer_to_cache || FLAGS_db_write_buffer_size != 0) {
|
|
|
|
options.write_buffer_manager.reset(
|
|
|
|
new WriteBufferManager(FLAGS_db_write_buffer_size, cache_));
|
|
|
|
}
|
2020-11-16 21:05:21 +00:00
|
|
|
options.arena_block_size = FLAGS_arena_block_size;
|
2011-03-22 18:32:49 +00:00
|
|
|
options.write_buffer_size = FLAGS_write_buffer_size;
|
2012-10-19 21:00:53 +00:00
|
|
|
options.max_write_buffer_number = FLAGS_max_write_buffer_number;
|
2013-06-11 21:23:58 +00:00
|
|
|
options.min_write_buffer_number_to_merge =
|
|
|
|
FLAGS_min_write_buffer_number_to_merge;
|
Support saving history in memtable_list
Summary:
For transactions, we are using the memtables to validate that there are no write conflicts. But after flushing, we don't have any memtables, and transactions could fail to commit. So we want to someone keep around some extra history to use for conflict checking. In addition, we want to provide a way to increase the size of this history if too many transactions fail to commit.
After chatting with people, it seems like everyone prefers just using Memtables to store this history (instead of a separate history structure). It seems like the best place for this is abstracted inside the memtable_list. I decide to create a separate list in MemtableListVersion as using the same list complicated the flush/installalflushresults logic too much.
This diff adds a new parameter to control how much memtable history to keep around after flushing. However, it sounds like people aren't too fond of adding new parameters. So I am making the default size of flushed+not-flushed memtables be set to max_write_buffers. This should not change the maximum amount of memory used, but make it more likely we're using closer the the limit. (We are now postponing deleting flushed memtables until the max_write_buffer limit is reached). So while we might use more memory on average, we are still obeying the limit set (and you could argue it's better to go ahead and use up memory now instead of waiting for a write stall to happen to test this limit).
However, if people are opposed to this default behavior, we can easily set it to 0 and require this parameter be set in order to use transactions.
Test Plan: Added a xfunc test to play around with setting different values of this parameter in all tests. Added testing in memtablelist_test and planning on adding more testing here.
Reviewers: sdong, rven, igor
Reviewed By: igor
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D37443
2015-05-28 23:34:24 +00:00
|
|
|
options.max_write_buffer_number_to_maintain =
|
|
|
|
FLAGS_max_write_buffer_number_to_maintain;
|
Refactor trimming logic for immutable memtables (#5022)
Summary:
MyRocks currently sets `max_write_buffer_number_to_maintain` in order to maintain enough history for transaction conflict checking. The effectiveness of this approach depends on the size of memtables. When memtables are small, it may not keep enough history; when memtables are large, this may consume too much memory.
We are proposing a new way to configure memtable list history: by limiting the memory usage of immutable memtables. The new option is `max_write_buffer_size_to_maintain` and it will take precedence over the old `max_write_buffer_number_to_maintain` if they are both set to non-zero values. The new option accounts for the total memory usage of flushed immutable memtables and mutable memtable. When the total usage exceeds the limit, RocksDB may start dropping immutable memtables (which is also called trimming history), starting from the oldest one.
The semantics of the old option actually works both as an upper bound and lower bound. History trimming will start if number of immutable memtables exceeds the limit, but it will never go below (limit-1) due to history trimming.
In order the mimic the behavior with the new option, history trimming will stop if dropping the next immutable memtable causes the total memory usage go below the size limit. For example, assuming the size limit is set to 64MB, and there are 3 immutable memtables with sizes of 20, 30, 30. Although the total memory usage is 80MB > 64MB, dropping the oldest memtable will reduce the memory usage to 60MB < 64MB, so in this case no memtable will be dropped.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5022
Differential Revision: D14394062
Pulled By: miasantreble
fbshipit-source-id: 60457a509c6af89d0993f988c9b5c2aa9e45f5c5
2019-08-23 20:54:09 +00:00
|
|
|
options.max_write_buffer_size_to_maintain =
|
|
|
|
FLAGS_max_write_buffer_size_to_maintain;
|
2017-07-08 01:11:53 +00:00
|
|
|
options.max_background_jobs = FLAGS_max_background_jobs;
|
2012-10-19 21:00:53 +00:00
|
|
|
options.max_background_compactions = FLAGS_max_background_compactions;
|
2015-08-21 21:25:34 +00:00
|
|
|
options.max_subcompactions = static_cast<uint32_t>(FLAGS_subcompactions);
|
2014-03-05 18:27:17 +00:00
|
|
|
options.max_background_flushes = FLAGS_max_background_flushes;
|
2013-10-24 14:43:14 +00:00
|
|
|
options.compaction_style = FLAGS_compaction_style_e;
|
2015-09-22 00:16:31 +00:00
|
|
|
options.compaction_pri = FLAGS_compaction_pri_e;
|
2016-10-28 17:36:05 +00:00
|
|
|
options.allow_mmap_reads = FLAGS_mmap_read;
|
|
|
|
options.allow_mmap_writes = FLAGS_mmap_write;
|
|
|
|
options.use_direct_reads = FLAGS_use_direct_reads;
|
2017-04-13 20:07:33 +00:00
|
|
|
options.use_direct_io_for_flush_and_compaction =
|
|
|
|
FLAGS_use_direct_io_for_flush_and_compaction;
|
2021-11-04 23:02:17 +00:00
|
|
|
options.manual_wal_flush = FLAGS_manual_wal_flush;
|
2022-01-26 21:57:30 +00:00
|
|
|
options.wal_compression = FLAGS_wal_compression_e;
|
2017-03-28 20:26:53 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2019-02-15 17:48:44 +00:00
|
|
|
options.ttl = FLAGS_fifo_compaction_ttl;
|
2017-03-24 23:58:51 +00:00
|
|
|
options.compaction_options_fifo = CompactionOptionsFIFO(
|
2017-05-05 01:14:29 +00:00
|
|
|
FLAGS_fifo_compaction_max_table_files_size_mb * 1024 * 1024,
|
2019-02-15 17:48:44 +00:00
|
|
|
FLAGS_fifo_compaction_allow_compaction);
|
2021-08-09 19:50:19 +00:00
|
|
|
options.compaction_options_fifo.age_for_warm = FLAGS_fifo_age_for_warm;
|
2017-03-28 20:26:53 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2022-05-19 20:09:03 +00:00
|
|
|
options.prefix_extractor = prefix_extractor_;
|
2014-08-27 17:39:31 +00:00
|
|
|
if (FLAGS_use_uint64_comparator) {
|
|
|
|
options.comparator = test::Uint64Comparator();
|
|
|
|
if (FLAGS_key_size != 8) {
|
|
|
|
fprintf(stderr, "Using Uint64 comparator but key size is not 8.\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
2016-12-10 00:36:43 +00:00
|
|
|
if (FLAGS_use_stderr_info_logger) {
|
|
|
|
options.info_log.reset(new StderrLogger());
|
|
|
|
}
|
2016-07-27 01:05:30 +00:00
|
|
|
options.memtable_huge_page_size = FLAGS_memtable_use_huge_page ? 2048 : 0;
|
2016-06-04 00:02:10 +00:00
|
|
|
options.memtable_prefix_bloom_size_ratio = FLAGS_memtable_bloom_size_ratio;
|
2019-02-19 20:12:25 +00:00
|
|
|
options.memtable_whole_key_filtering = FLAGS_memtable_whole_key_filtering;
|
2016-12-02 00:50:59 +00:00
|
|
|
if (FLAGS_memtable_insert_with_hint_prefix_size > 0) {
|
|
|
|
options.memtable_insert_with_hint_prefix_extractor.reset(
|
|
|
|
NewCappedPrefixTransform(
|
|
|
|
FLAGS_memtable_insert_with_hint_prefix_size));
|
|
|
|
}
|
2014-03-28 16:21:20 +00:00
|
|
|
options.bloom_locality = FLAGS_bloom_locality;
|
2015-09-30 16:51:31 +00:00
|
|
|
options.max_file_opening_threads = FLAGS_file_opening_threads;
|
2015-08-26 22:25:59 +00:00
|
|
|
options.compaction_readahead_size = FLAGS_compaction_readahead_size;
|
2020-02-07 23:16:29 +00:00
|
|
|
options.log_readahead_size = FLAGS_log_readahead_size;
|
2015-10-27 21:44:16 +00:00
|
|
|
options.random_access_max_buffer_size = FLAGS_random_access_max_buffer_size;
|
2015-10-30 05:10:25 +00:00
|
|
|
options.writable_file_max_buffer_size = FLAGS_writable_file_max_buffer_size;
|
2012-08-27 19:10:26 +00:00
|
|
|
options.use_fsync = FLAGS_use_fsync;
|
2012-10-15 17:10:56 +00:00
|
|
|
options.num_levels = FLAGS_num_levels;
|
2012-08-15 22:44:23 +00:00
|
|
|
options.target_file_size_base = FLAGS_target_file_size_base;
|
|
|
|
options.target_file_size_multiplier = FLAGS_target_file_size_multiplier;
|
|
|
|
options.max_bytes_for_level_base = FLAGS_max_bytes_for_level_base;
|
options.level_compaction_dynamic_level_bytes to allow RocksDB to pick size bases of levels dynamically.
Summary:
When having fixed max_bytes_for_level_base, the ratio of size of largest level and the second one can range from 0 to the multiplier. This makes LSM tree frequently irregular and unpredictable. It can also cause poor space amplification in some cases.
In this improvement (proposed by Igor Kabiljo), we introduce a parameter option.level_compaction_use_dynamic_max_bytes. When turning it on, RocksDB is free to pick a level base in the range of (options.max_bytes_for_level_base/options.max_bytes_for_level_multiplier, options.max_bytes_for_level_base] so that real level ratios are close to options.max_bytes_for_level_multiplier.
Test Plan: New unit tests and pass tests suites including valgrind.
Reviewers: MarkCallaghan, rven, yhchiang, igor, ikabiljo
Reviewed By: ikabiljo
Subscribers: yoshinorim, ikabiljo, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D31437
2015-02-05 19:44:17 +00:00
|
|
|
options.level_compaction_dynamic_level_bytes =
|
|
|
|
FLAGS_level_compaction_dynamic_level_bytes;
|
2012-08-15 22:44:23 +00:00
|
|
|
options.max_bytes_for_level_multiplier =
|
|
|
|
FLAGS_max_bytes_for_level_multiplier;
|
2021-09-08 14:45:59 +00:00
|
|
|
Status s =
|
|
|
|
CreateMemTableRepFactory(config_options, &options.memtable_factory);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Could not create memtable factory: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
} else if ((FLAGS_prefix_size == 0) &&
|
|
|
|
(options.memtable_factory->IsInstanceOf("prefix_hash") ||
|
|
|
|
options.memtable_factory->IsInstanceOf("hash_linkedlist"))) {
|
2014-03-05 18:27:17 +00:00
|
|
|
fprintf(stderr, "prefix_size should be non-zero if PrefixHash or "
|
|
|
|
"HashLinkedList memtablerep is used\n");
|
2013-08-23 06:10:02 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
2014-02-12 18:41:55 +00:00
|
|
|
if (FLAGS_use_plain_table) {
|
2014-11-12 21:05:12 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2021-09-08 14:45:59 +00:00
|
|
|
if (!options.memtable_factory->IsInstanceOf("prefix_hash") &&
|
|
|
|
!options.memtable_factory->IsInstanceOf("hash_linkedlist")) {
|
|
|
|
fprintf(stderr, "Warning: plain table is used with %s\n",
|
|
|
|
options.memtable_factory->Name());
|
2014-02-12 18:41:55 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
int bloom_bits_per_key = FLAGS_bloom_bits;
|
|
|
|
if (bloom_bits_per_key < 0) {
|
2021-06-17 19:28:00 +00:00
|
|
|
bloom_bits_per_key = PlainTableOptions().bloom_bits_per_key;
|
2014-02-12 18:41:55 +00:00
|
|
|
}
|
2014-07-18 07:08:38 +00:00
|
|
|
|
|
|
|
PlainTableOptions plain_table_options;
|
|
|
|
plain_table_options.user_key_len = FLAGS_key_size;
|
|
|
|
plain_table_options.bloom_bits_per_key = bloom_bits_per_key;
|
|
|
|
plain_table_options.hash_table_ratio = 0.75;
|
|
|
|
options.table_factory = std::shared_ptr<TableFactory>(
|
|
|
|
NewPlainTableFactory(plain_table_options));
|
2014-11-12 21:05:12 +00:00
|
|
|
#else
|
|
|
|
fprintf(stderr, "Plain table is not supported in lite mode\n");
|
|
|
|
exit(1);
|
|
|
|
#endif // ROCKSDB_LITE
|
2014-08-18 18:59:38 +00:00
|
|
|
} else if (FLAGS_use_cuckoo_table) {
|
2014-11-12 21:05:12 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2014-08-18 18:59:38 +00:00
|
|
|
if (FLAGS_cuckoo_hash_ratio > 1 || FLAGS_cuckoo_hash_ratio < 0) {
|
|
|
|
fprintf(stderr, "Invalid cuckoo_hash_ratio\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
2018-01-29 22:13:05 +00:00
|
|
|
|
|
|
|
if (!FLAGS_mmap_read) {
|
|
|
|
fprintf(stderr, "cuckoo table format requires mmap read to operate\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::CuckooTableOptions table_options;
|
CuckooTable: add one option to allow identity function for the first hash function
Summary:
MurmurHash becomes expensive when we do millions Get() a second in one
thread. Add this option to allow the first hash function to use identity
function as hash function. It results in QPS increase from 3.7M/s to
~4.3M/s. I did not observe improvement for end to end RocksDB
performance. This may be caused by other bottlenecks that I will address
in a separate diff.
Test Plan:
```
[ljin@dev1964 rocksdb] ./cuckoo_table_reader_test --enable_perf --file_dir=/dev/shm --write --identity_as_first_hash=0
==== Test CuckooReaderTest.WhenKeyExists
==== Test CuckooReaderTest.WhenKeyExistsWithUint64Comparator
==== Test CuckooReaderTest.CheckIterator
==== Test CuckooReaderTest.CheckIteratorUint64
==== Test CuckooReaderTest.WhenKeyNotFound
==== Test CuckooReaderTest.TestReadPerformance
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.272us (3.7 Mqps) with batch size of 0, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.138us (7.2 Mqps) with batch size of 10, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.142us (7.1 Mqps) with batch size of 25, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.142us (7.0 Mqps) with batch size of 50, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.144us (6.9 Mqps) with batch size of 100, # of found keys 125829120
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.201us (5.0 Mqps) with batch size of 0, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.121us (8.3 Mqps) with batch size of 10, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.123us (8.1 Mqps) with batch size of 25, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.121us (8.3 Mqps) with batch size of 50, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.112us (8.9 Mqps) with batch size of 100, # of found keys 104857600
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.251us (4.0 Mqps) with batch size of 0, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.107us (9.4 Mqps) with batch size of 10, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.099us (10.1 Mqps) with batch size of 25, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.100us (10.0 Mqps) with batch size of 50, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.116us (8.6 Mqps) with batch size of 100, # of found keys 83886080
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.189us (5.3 Mqps) with batch size of 0, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.095us (10.5 Mqps) with batch size of 10, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.096us (10.4 Mqps) with batch size of 25, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.098us (10.2 Mqps) with batch size of 50, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.105us (9.5 Mqps) with batch size of 100, # of found keys 73400320
[ljin@dev1964 rocksdb] ./cuckoo_table_reader_test --enable_perf --file_dir=/dev/shm --write --identity_as_first_hash=1
==== Test CuckooReaderTest.WhenKeyExists
==== Test CuckooReaderTest.WhenKeyExistsWithUint64Comparator
==== Test CuckooReaderTest.CheckIterator
==== Test CuckooReaderTest.CheckIteratorUint64
==== Test CuckooReaderTest.WhenKeyNotFound
==== Test CuckooReaderTest.TestReadPerformance
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.230us (4.3 Mqps) with batch size of 0, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.086us (11.7 Mqps) with batch size of 10, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.088us (11.3 Mqps) with batch size of 25, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.083us (12.1 Mqps) with batch size of 50, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.083us (12.1 Mqps) with batch size of 100, # of found keys 125829120
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.159us (6.3 Mqps) with batch size of 0, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 10, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.080us (12.6 Mqps) with batch size of 25, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.080us (12.5 Mqps) with batch size of 50, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.082us (12.2 Mqps) with batch size of 100, # of found keys 104857600
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.154us (6.5 Mqps) with batch size of 0, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.077us (13.0 Mqps) with batch size of 10, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.077us (12.9 Mqps) with batch size of 25, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 50, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.079us (12.6 Mqps) with batch size of 100, # of found keys 83886080
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.218us (4.6 Mqps) with batch size of 0, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.083us (12.0 Mqps) with batch size of 10, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.085us (11.7 Mqps) with batch size of 25, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.086us (11.6 Mqps) with batch size of 50, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 100, # of found keys 73400320
```
Reviewers: sdong, igor, yhchiang
Reviewed By: igor
Subscribers: leveldb
Differential Revision: https://reviews.facebook.net/D23451
2014-09-18 18:00:48 +00:00
|
|
|
table_options.hash_table_ratio = FLAGS_cuckoo_hash_ratio;
|
|
|
|
table_options.identity_as_first_hash = FLAGS_identity_as_first_hash;
|
2014-08-18 18:59:38 +00:00
|
|
|
options.table_factory = std::shared_ptr<TableFactory>(
|
CuckooTable: add one option to allow identity function for the first hash function
Summary:
MurmurHash becomes expensive when we do millions Get() a second in one
thread. Add this option to allow the first hash function to use identity
function as hash function. It results in QPS increase from 3.7M/s to
~4.3M/s. I did not observe improvement for end to end RocksDB
performance. This may be caused by other bottlenecks that I will address
in a separate diff.
Test Plan:
```
[ljin@dev1964 rocksdb] ./cuckoo_table_reader_test --enable_perf --file_dir=/dev/shm --write --identity_as_first_hash=0
==== Test CuckooReaderTest.WhenKeyExists
==== Test CuckooReaderTest.WhenKeyExistsWithUint64Comparator
==== Test CuckooReaderTest.CheckIterator
==== Test CuckooReaderTest.CheckIteratorUint64
==== Test CuckooReaderTest.WhenKeyNotFound
==== Test CuckooReaderTest.TestReadPerformance
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.272us (3.7 Mqps) with batch size of 0, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.138us (7.2 Mqps) with batch size of 10, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.142us (7.1 Mqps) with batch size of 25, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.142us (7.0 Mqps) with batch size of 50, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.144us (6.9 Mqps) with batch size of 100, # of found keys 125829120
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.201us (5.0 Mqps) with batch size of 0, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.121us (8.3 Mqps) with batch size of 10, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.123us (8.1 Mqps) with batch size of 25, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.121us (8.3 Mqps) with batch size of 50, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.112us (8.9 Mqps) with batch size of 100, # of found keys 104857600
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.251us (4.0 Mqps) with batch size of 0, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.107us (9.4 Mqps) with batch size of 10, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.099us (10.1 Mqps) with batch size of 25, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.100us (10.0 Mqps) with batch size of 50, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.116us (8.6 Mqps) with batch size of 100, # of found keys 83886080
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.189us (5.3 Mqps) with batch size of 0, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.095us (10.5 Mqps) with batch size of 10, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.096us (10.4 Mqps) with batch size of 25, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.098us (10.2 Mqps) with batch size of 50, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.105us (9.5 Mqps) with batch size of 100, # of found keys 73400320
[ljin@dev1964 rocksdb] ./cuckoo_table_reader_test --enable_perf --file_dir=/dev/shm --write --identity_as_first_hash=1
==== Test CuckooReaderTest.WhenKeyExists
==== Test CuckooReaderTest.WhenKeyExistsWithUint64Comparator
==== Test CuckooReaderTest.CheckIterator
==== Test CuckooReaderTest.CheckIteratorUint64
==== Test CuckooReaderTest.WhenKeyNotFound
==== Test CuckooReaderTest.TestReadPerformance
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.230us (4.3 Mqps) with batch size of 0, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.086us (11.7 Mqps) with batch size of 10, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.088us (11.3 Mqps) with batch size of 25, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.083us (12.1 Mqps) with batch size of 50, # of found keys 125829120
With 125829120 items, utilization is 93.75%, number of hash functions: 2.
Time taken per op is 0.083us (12.1 Mqps) with batch size of 100, # of found keys 125829120
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.159us (6.3 Mqps) with batch size of 0, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 10, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.080us (12.6 Mqps) with batch size of 25, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.080us (12.5 Mqps) with batch size of 50, # of found keys 104857600
With 104857600 items, utilization is 78.12%, number of hash functions: 2.
Time taken per op is 0.082us (12.2 Mqps) with batch size of 100, # of found keys 104857600
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.154us (6.5 Mqps) with batch size of 0, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.077us (13.0 Mqps) with batch size of 10, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.077us (12.9 Mqps) with batch size of 25, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 50, # of found keys 83886080
With 83886080 items, utilization is 62.50%, number of hash functions: 2.
Time taken per op is 0.079us (12.6 Mqps) with batch size of 100, # of found keys 83886080
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.218us (4.6 Mqps) with batch size of 0, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.083us (12.0 Mqps) with batch size of 10, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.085us (11.7 Mqps) with batch size of 25, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.086us (11.6 Mqps) with batch size of 50, # of found keys 73400320
With 73400320 items, utilization is 54.69%, number of hash functions: 2.
Time taken per op is 0.078us (12.8 Mqps) with batch size of 100, # of found keys 73400320
```
Reviewers: sdong, igor, yhchiang
Reviewed By: igor
Subscribers: leveldb
Differential Revision: https://reviews.facebook.net/D23451
2014-09-18 18:00:48 +00:00
|
|
|
NewCuckooTableFactory(table_options));
|
2014-11-12 21:05:12 +00:00
|
|
|
#else
|
|
|
|
fprintf(stderr, "Cuckoo table is not supported in lite mode\n");
|
|
|
|
exit(1);
|
|
|
|
#endif // ROCKSDB_LITE
|
2014-07-17 00:32:30 +00:00
|
|
|
} else {
|
|
|
|
BlockBasedTableOptions block_based_options;
|
Implement XXH3 block checksum type (#9069)
Summary:
XXH3 - latest hash function that is extremely fast on large
data, easily faster than crc32c on most any x86_64 hardware. In
integrating this hash function, I have handled the compression type byte
in a non-standard way to avoid using the streaming API (extra data
movement and active code size because of hash function complexity). This
approach got a thumbs-up from Yann Collet.
Existing functionality change:
* reject bad ChecksumType in options with InvalidArgument
This change split off from https://github.com/facebook/rocksdb/issues/9058 because context-aware checksum is
likely to be handled through different configuration than ChecksumType.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9069
Test Plan:
tests updated, and substantially expanded. Unit tests now check
that we don't accidentally change the values generated by the checksum
algorithms ("schema test") and that we properly handle
invalid/unrecognized checksum types in options or in file footer.
DBTestBase::ChangeOptions (etc.) updated from two to one configuration
changing from default CRC32c ChecksumType. The point of this test code
is to detect possible interactions among features, and the likelihood of
some bad interaction being detected by including configurations other
than XXH3 and CRC32c--and then not detected by stress/crash test--is
extremely low.
Stress/crash test also updated (manual run long enough to see it accepts
new checksum type). db_bench also updated for microbenchmarking
checksums.
### Performance microbenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
./db_bench -benchmarks=crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3,crc32c,xxhash,xxhash64,xxh3
crc32c : 0.200 micros/op 5005220 ops/sec; 19551.6 MB/s (4096 per op)
xxhash : 0.807 micros/op 1238408 ops/sec; 4837.5 MB/s (4096 per op)
xxhash64 : 0.421 micros/op 2376514 ops/sec; 9283.3 MB/s (4096 per op)
xxh3 : 0.171 micros/op 5858391 ops/sec; 22884.3 MB/s (4096 per op)
crc32c : 0.206 micros/op 4859566 ops/sec; 18982.7 MB/s (4096 per op)
xxhash : 0.793 micros/op 1260850 ops/sec; 4925.2 MB/s (4096 per op)
xxhash64 : 0.410 micros/op 2439182 ops/sec; 9528.1 MB/s (4096 per op)
xxh3 : 0.161 micros/op 6202872 ops/sec; 24230.0 MB/s (4096 per op)
crc32c : 0.203 micros/op 4924686 ops/sec; 19237.1 MB/s (4096 per op)
xxhash : 0.839 micros/op 1192388 ops/sec; 4657.8 MB/s (4096 per op)
xxhash64 : 0.424 micros/op 2357391 ops/sec; 9208.6 MB/s (4096 per op)
xxh3 : 0.162 micros/op 6182678 ops/sec; 24151.1 MB/s (4096 per op)
As you can see, especially once warmed up, xxh3 is fastest.
### Performance macrobenchmark (PORTABLE=0 DEBUG_LEVEL=0, Broadwell processor)
Test
for I in `seq 1 50`; do for CHK in 0 1 2 3 4; do TEST_TMPDIR=/dev/shm/rocksdb$CHK ./db_bench -benchmarks=fillseq -memtablerep=vector -allow_concurrent_memtable_write=false -num=30000000 -checksum_type=$CHK 2>&1 | grep 'micros/op' | tee -a results-$CHK & done; wait; done
Results (ops/sec)
for FILE in results*; do echo -n "$FILE "; awk '{ s += $5; c++; } END { print 1.0 * s / c; }' < $FILE; done
results-0 252118 # kNoChecksum
results-1 251588 # kCRC32c
results-2 251863 # kxxHash
results-3 252016 # kxxHash64
results-4 252038 # kXXH3
Reviewed By: mrambacher
Differential Revision: D31905249
Pulled By: pdillinger
fbshipit-source-id: cb9b998ebe2523fc7c400eedf62124a78bf4b4d1
2021-10-29 05:13:47 +00:00
|
|
|
block_based_options.checksum =
|
|
|
|
static_cast<ChecksumType>(FLAGS_checksum_type);
|
2014-07-17 00:32:30 +00:00
|
|
|
if (FLAGS_use_hash_search) {
|
2014-08-11 17:47:52 +00:00
|
|
|
if (FLAGS_prefix_size == 0) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"prefix_size not assigned when enable use_hash_search \n");
|
|
|
|
exit(1);
|
|
|
|
}
|
2014-07-17 00:32:30 +00:00
|
|
|
block_based_options.index_type = BlockBasedTableOptions::kHashSearch;
|
|
|
|
} else {
|
|
|
|
block_based_options.index_type = BlockBasedTableOptions::kBinarySearch;
|
|
|
|
}
|
2018-02-12 22:54:50 +00:00
|
|
|
if (FLAGS_partition_index_and_filters || FLAGS_partition_index) {
|
2020-03-02 19:52:36 +00:00
|
|
|
if (FLAGS_index_with_first_key) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"--index_with_first_key is not compatible with"
|
|
|
|
" partition index.");
|
|
|
|
}
|
2017-06-15 23:06:22 +00:00
|
|
|
if (FLAGS_use_hash_search) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"use_hash_search is incompatible with "
|
2018-02-12 22:54:50 +00:00
|
|
|
"partition index and is ignored");
|
2017-06-15 23:06:22 +00:00
|
|
|
}
|
|
|
|
block_based_options.index_type =
|
|
|
|
BlockBasedTableOptions::kTwoLevelIndexSearch;
|
|
|
|
block_based_options.metadata_block_size = FLAGS_metadata_block_size;
|
2018-02-12 22:54:50 +00:00
|
|
|
if (FLAGS_partition_index_and_filters) {
|
|
|
|
block_based_options.partition_filters = true;
|
|
|
|
}
|
2020-03-02 19:52:36 +00:00
|
|
|
} else if (FLAGS_index_with_first_key) {
|
|
|
|
block_based_options.index_type =
|
|
|
|
BlockBasedTableOptions::kBinarySearchWithFirstKey;
|
|
|
|
}
|
|
|
|
BlockBasedTableOptions::IndexShorteningMode index_shortening =
|
|
|
|
block_based_options.index_shortening;
|
|
|
|
switch (FLAGS_index_shortening_mode) {
|
|
|
|
case 0:
|
|
|
|
index_shortening =
|
|
|
|
BlockBasedTableOptions::IndexShorteningMode::kNoShortening;
|
|
|
|
break;
|
|
|
|
case 1:
|
|
|
|
index_shortening =
|
|
|
|
BlockBasedTableOptions::IndexShorteningMode::kShortenSeparators;
|
|
|
|
break;
|
|
|
|
case 2:
|
|
|
|
index_shortening = BlockBasedTableOptions::IndexShorteningMode::
|
|
|
|
kShortenSeparatorsAndSuccessor;
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
fprintf(stderr, "Unknown key shortening mode\n");
|
2017-06-15 23:06:22 +00:00
|
|
|
}
|
Minimize memory internal fragmentation for Bloom filters (#6427)
Summary:
New experimental option BBTO::optimize_filters_for_memory builds
filters that maximize their use of "usable size" from malloc_usable_size,
which is also used to compute block cache charges.
Rather than always "rounding up," we track state in the
BloomFilterPolicy object to mix essentially "rounding down" and
"rounding up" so that the average FP rate of all generated filters is
the same as without the option. (YMMV as heavily accessed filters might
be unluckily lower accuracy.)
Thus, the option near-minimizes what the block cache considers as
"memory used" for a given target Bloom filter false positive rate and
Bloom filter implementation. There are no forward or backward
compatibility issues with this change, though it only works on the
format_version=5 Bloom filter.
With Jemalloc, we see about 10% reduction in memory footprint (and block
cache charge) for Bloom filters, but 1-2% increase in storage footprint,
due to encoding efficiency losses (FP rate is non-linear with bits/key).
Why not weighted random round up/down rather than state tracking? By
only requiring malloc_usable_size, we don't actually know what the next
larger and next smaller usable sizes for the allocator are. We pick a
requested size, accept and use whatever usable size it has, and use the
difference to inform our next choice. This allows us to narrow in on the
right balance without tracking/predicting usable sizes.
Why not weight history of generated filter false positive rates by
number of keys? This could lead to excess skew in small filters after
generating a large filter.
Results from filter_bench with jemalloc (irrelevant details omitted):
(normal keys/filter, but high variance)
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=30000 -vary_key_count_ratio=0.9
Build avg ns/key: 29.6278
Number of filters: 5516
Total size (MB): 200.046
Reported total allocated memory (MB): 220.597
Reported internal fragmentation: 10.2732%
Bits/key stored: 10.0097
Average FP rate %: 0.965228
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=30000 -vary_key_count_ratio=0.9 -optimize_filters_for_memory
Build avg ns/key: 30.5104
Number of filters: 5464
Total size (MB): 200.015
Reported total allocated memory (MB): 200.322
Reported internal fragmentation: 0.153709%
Bits/key stored: 10.1011
Average FP rate %: 0.966313
(very few keys / filter, optimization not as effective due to ~59 byte
internal fragmentation in blocked Bloom filter representation)
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000 -vary_key_count_ratio=0.9
Build avg ns/key: 29.5649
Number of filters: 162950
Total size (MB): 200.001
Reported total allocated memory (MB): 224.624
Reported internal fragmentation: 12.3117%
Bits/key stored: 10.2951
Average FP rate %: 0.821534
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000 -vary_key_count_ratio=0.9 -optimize_filters_for_memory
Build avg ns/key: 31.8057
Number of filters: 159849
Total size (MB): 200
Reported total allocated memory (MB): 208.846
Reported internal fragmentation: 4.42297%
Bits/key stored: 10.4948
Average FP rate %: 0.811006
(high keys/filter)
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000000 -vary_key_count_ratio=0.9
Build avg ns/key: 29.7017
Number of filters: 164
Total size (MB): 200.352
Reported total allocated memory (MB): 221.5
Reported internal fragmentation: 10.5552%
Bits/key stored: 10.0003
Average FP rate %: 0.969358
$ ./filter_bench -quick -impl=2 -average_keys_per_filter=1000000 -vary_key_count_ratio=0.9 -optimize_filters_for_memory
Build avg ns/key: 30.7131
Number of filters: 160
Total size (MB): 200.928
Reported total allocated memory (MB): 200.938
Reported internal fragmentation: 0.00448054%
Bits/key stored: 10.1852
Average FP rate %: 0.963387
And from db_bench (block cache) with jemalloc:
$ ./db_bench -db=/dev/shm/dbbench.no_optimize -benchmarks=fillrandom -format_version=5 -value_size=90 -bloom_bits=10 -num=2000000 -threads=8 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false
$ ./db_bench -db=/dev/shm/dbbench -benchmarks=fillrandom -format_version=5 -value_size=90 -bloom_bits=10 -num=2000000 -threads=8 -optimize_filters_for_memory -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false
$ (for FILE in /dev/shm/dbbench.no_optimize/*.sst; do ./sst_dump --file=$FILE --show_properties | grep 'filter block' ; done) | awk '{ t += $4; } END { print t; }'
17063835
$ (for FILE in /dev/shm/dbbench/*.sst; do ./sst_dump --file=$FILE --show_properties | grep 'filter block' ; done) | awk '{ t += $4; } END { print t; }'
17430747
$ #^ 2.1% additional filter storage
$ ./db_bench -db=/dev/shm/dbbench.no_optimize -use_existing_db -benchmarks=readrandom,stats -statistics -bloom_bits=10 -num=2000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false -duration=10 -cache_index_and_filter_blocks -cache_size=1000000000
rocksdb.block.cache.index.add COUNT : 33
rocksdb.block.cache.index.bytes.insert COUNT : 8440400
rocksdb.block.cache.filter.add COUNT : 33
rocksdb.block.cache.filter.bytes.insert COUNT : 21087528
rocksdb.bloom.filter.useful COUNT : 4963889
rocksdb.bloom.filter.full.positive COUNT : 1214081
rocksdb.bloom.filter.full.true.positive COUNT : 1161999
$ #^ 1.04 % observed FP rate
$ ./db_bench -db=/dev/shm/dbbench -use_existing_db -benchmarks=readrandom,stats -statistics -bloom_bits=10 -num=2000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=false -optimize_filters_for_memory -duration=10 -cache_index_and_filter_blocks -cache_size=1000000000
rocksdb.block.cache.index.add COUNT : 33
rocksdb.block.cache.index.bytes.insert COUNT : 8448592
rocksdb.block.cache.filter.add COUNT : 33
rocksdb.block.cache.filter.bytes.insert COUNT : 18220328
rocksdb.bloom.filter.useful COUNT : 5360933
rocksdb.bloom.filter.full.positive COUNT : 1321315
rocksdb.bloom.filter.full.true.positive COUNT : 1262999
$ #^ 1.08 % observed FP rate, 13.6% less memory usage for filters
(Due to specific key density, this example tends to generate filters that are "worse than average" for internal fragmentation. "Better than average" cases can show little or no improvement.)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6427
Test Plan: unit test added, 'make check' with gcc, clang and valgrind
Reviewed By: siying
Differential Revision: D22124374
Pulled By: pdillinger
fbshipit-source-id: f3e3aa152f9043ddf4fae25799e76341d0d8714e
2020-06-22 20:30:57 +00:00
|
|
|
block_based_options.optimize_filters_for_memory =
|
|
|
|
FLAGS_optimize_filters_for_memory;
|
2020-03-02 19:52:36 +00:00
|
|
|
block_based_options.index_shortening = index_shortening;
|
2014-08-25 21:22:05 +00:00
|
|
|
if (cache_ == nullptr) {
|
|
|
|
block_based_options.no_block_cache = true;
|
|
|
|
}
|
2015-07-09 20:36:16 +00:00
|
|
|
block_based_options.cache_index_and_filter_blocks =
|
|
|
|
FLAGS_cache_index_and_filter_blocks;
|
Adding pin_l0_filter_and_index_blocks_in_cache feature and related fixes.
Summary:
When a block based table file is opened, if prefetch_index_and_filter is true, it will prefetch the index and filter blocks, putting them into the block cache.
What this feature adds: when a L0 block based table file is opened, if pin_l0_filter_and_index_blocks_in_cache is true in the options (and prefetch_index_and_filter is true), then the filter and index blocks aren't released back to the block cache at the end of BlockBasedTableReader::Open(). Instead the table reader takes ownership of them, hence pinning them, ie. the LRU cache will never push them out. Meanwhile in the table reader, further accesses will not hit the block cache, thus avoiding lock contention.
Test Plan:
'export TEST_TMPDIR=/dev/shm/ && DISABLE_JEMALLOC=1 OPT=-g make all valgrind_check -j32' is OK.
I didn't run the Java tests, I don't have Java set up on my devserver.
Reviewers: sdong
Reviewed By: sdong
Subscribers: andrewkr, dhruba
Differential Revision: https://reviews.facebook.net/D56133
2016-04-01 17:42:39 +00:00
|
|
|
block_based_options.pin_l0_filter_and_index_blocks_in_cache =
|
|
|
|
FLAGS_pin_l0_filter_and_index_blocks_in_cache;
|
2018-06-22 22:14:05 +00:00
|
|
|
block_based_options.pin_top_level_index_and_filter =
|
|
|
|
FLAGS_pin_top_level_index_and_filter;
|
2017-01-04 02:24:15 +00:00
|
|
|
if (FLAGS_cache_high_pri_pool_ratio > 1e-6) { // > 0.0 + eps
|
|
|
|
block_based_options.cache_index_and_filter_blocks_with_high_priority =
|
|
|
|
true;
|
|
|
|
}
|
2022-08-13 00:59:06 +00:00
|
|
|
if (FLAGS_cache_high_pri_pool_ratio + FLAGS_cache_low_pri_pool_ratio >
|
|
|
|
1.0) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Sum of high_pri_pool_ratio and low_pri_pool_ratio "
|
|
|
|
"cannot exceed 1.0.\n");
|
|
|
|
}
|
2014-08-25 21:22:05 +00:00
|
|
|
block_based_options.block_cache = cache_;
|
2022-05-17 22:01:51 +00:00
|
|
|
block_based_options.cache_usage_options.options_overrides.insert(
|
|
|
|
{CacheEntryRole::kCompressionDictionaryBuildingBuffer,
|
|
|
|
{/*.charged = */ FLAGS_charge_compression_dictionary_building_buffer
|
|
|
|
? CacheEntryRoleOptions::Decision::kEnabled
|
|
|
|
: CacheEntryRoleOptions::Decision::kDisabled}});
|
|
|
|
block_based_options.cache_usage_options.options_overrides.insert(
|
|
|
|
{CacheEntryRole::kFilterConstruction,
|
|
|
|
{/*.charged = */ FLAGS_charge_filter_construction
|
|
|
|
? CacheEntryRoleOptions::Decision::kEnabled
|
|
|
|
: CacheEntryRoleOptions::Decision::kDisabled}});
|
|
|
|
block_based_options.cache_usage_options.options_overrides.insert(
|
|
|
|
{CacheEntryRole::kBlockBasedTableReader,
|
|
|
|
{/*.charged = */ FLAGS_charge_table_reader
|
|
|
|
? CacheEntryRoleOptions::Decision::kEnabled
|
|
|
|
: CacheEntryRoleOptions::Decision::kDisabled}});
|
Account memory of FileMetaData in global memory limit (#9924)
Summary:
**Context/Summary:**
As revealed by heap profiling, allocation of `FileMetaData` for [newly created file added to a Version](https://github.com/facebook/rocksdb/pull/9924/files#diff-a6aa385940793f95a2c5b39cc670bd440c4547fa54fd44622f756382d5e47e43R774) can consume significant heap memory. This PR is to account that toward our global memory limit based on block cache capacity.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9924
Test Plan:
- Previous `make check` verified there are only 2 places where the memory of the allocated `FileMetaData` can be released
- New unit test `TEST_P(ChargeFileMetadataTestWithParam, Basic)`
- db bench (CPU cost of `charge_file_metadata` in write and compact)
- **write micros/op: -0.24%** : `TEST_TMPDIR=/dev/shm/testdb ./db_bench -benchmarks=fillseq -db=$TEST_TMPDIR -charge_file_metadata=1 (remove this option for pre-PR) -disable_auto_compactions=1 -write_buffer_size=100000 -num=4000000 | egrep 'fillseq'`
- **compact micros/op -0.87%** : `TEST_TMPDIR=/dev/shm/testdb ./db_bench -benchmarks=fillseq -db=$TEST_TMPDIR -charge_file_metadata=1 -disable_auto_compactions=1 -write_buffer_size=100000 -num=4000000 -numdistinct=1000 && ./db_bench -benchmarks=compact -db=$TEST_TMPDIR -use_existing_db=1 -charge_file_metadata=1 -disable_auto_compactions=1 | egrep 'compact'`
table 1 - write
#-run | (pre-PR) avg micros/op | std micros/op | (post-PR) micros/op | std micros/op | change (%)
-- | -- | -- | -- | -- | --
10 | 3.9711 | 0.264408 | 3.9914 | 0.254563 | 0.5111933721
20 | 3.83905 | 0.0664488 | 3.8251 | 0.0695456 | -0.3633711465
40 | 3.86625 | 0.136669 | 3.8867 | 0.143765 | 0.5289363078
80 | 3.87828 | 0.119007 | 3.86791 | 0.115674 | **-0.2673865734**
160 | 3.87677 | 0.162231 | 3.86739 | 0.16663 | **-0.2419539978**
table 2 - compact
#-run | (pre-PR) avg micros/op | std micros/op | (post-PR) micros/op | std micros/op | change (%)
-- | -- | -- | -- | -- | --
10 | 2,399,650.00 | 96,375.80 | 2,359,537.00 | 53,243.60 | -1.67
20 | 2,410,480.00 | 89,988.00 | 2,433,580.00 | 91,121.20 | 0.96
40 | 2.41E+06 | 121811 | 2.39E+06 | 131525 | **-0.96**
80 | 2.40E+06 | 134503 | 2.39E+06 | 108799 | **-0.78**
- stress test: `python3 tools/db_crashtest.py blackbox --charge_file_metadata=1 --cache_size=1` killed as normal
Reviewed By: ajkr
Differential Revision: D36055583
Pulled By: hx235
fbshipit-source-id: b60eab94707103cb1322cf815f05810ef0232625
2022-06-14 20:06:40 +00:00
|
|
|
block_based_options.cache_usage_options.options_overrides.insert(
|
|
|
|
{CacheEntryRole::kFileMetadata,
|
|
|
|
{/*.charged = */ FLAGS_charge_file_metadata
|
|
|
|
? CacheEntryRoleOptions::Decision::kEnabled
|
|
|
|
: CacheEntryRoleOptions::Decision::kDisabled}});
|
2022-07-19 06:26:57 +00:00
|
|
|
block_based_options.cache_usage_options.options_overrides.insert(
|
|
|
|
{CacheEntryRole::kBlobCache,
|
|
|
|
{/*.charged = */ FLAGS_charge_blob_cache
|
|
|
|
? CacheEntryRoleOptions::Decision::kEnabled
|
|
|
|
: CacheEntryRoleOptions::Decision::kDisabled}});
|
2014-08-25 21:22:05 +00:00
|
|
|
block_based_options.block_cache_compressed = compressed_cache_;
|
|
|
|
block_based_options.block_size = FLAGS_block_size;
|
|
|
|
block_based_options.block_restart_interval = FLAGS_block_restart_interval;
|
2016-05-09 19:09:05 +00:00
|
|
|
block_based_options.index_block_restart_interval =
|
|
|
|
FLAGS_index_block_restart_interval;
|
2018-06-05 02:59:44 +00:00
|
|
|
block_based_options.format_version =
|
|
|
|
static_cast<uint32_t>(FLAGS_format_version);
|
2016-08-27 01:55:58 +00:00
|
|
|
block_based_options.read_amp_bytes_per_bit = FLAGS_read_amp_bytes_per_bit;
|
2018-01-10 23:06:29 +00:00
|
|
|
block_based_options.enable_index_compression =
|
|
|
|
FLAGS_enable_index_compression;
|
2018-03-27 03:14:24 +00:00
|
|
|
block_based_options.block_align = FLAGS_block_align;
|
2022-02-01 03:45:17 +00:00
|
|
|
block_based_options.whole_key_filtering = FLAGS_whole_key_filtering;
|
2022-08-19 01:03:44 +00:00
|
|
|
block_based_options.max_auto_readahead_size =
|
|
|
|
FLAGS_max_auto_readahead_size;
|
|
|
|
block_based_options.initial_auto_readahead_size =
|
|
|
|
FLAGS_initial_auto_readahead_size;
|
2021-06-18 04:55:42 +00:00
|
|
|
BlockBasedTableOptions::PrepopulateBlockCache prepopulate_block_cache =
|
|
|
|
block_based_options.prepopulate_block_cache;
|
|
|
|
switch (FLAGS_prepopulate_block_cache) {
|
|
|
|
case 0:
|
|
|
|
prepopulate_block_cache =
|
|
|
|
BlockBasedTableOptions::PrepopulateBlockCache::kDisable;
|
|
|
|
break;
|
|
|
|
case 1:
|
|
|
|
prepopulate_block_cache =
|
|
|
|
BlockBasedTableOptions::PrepopulateBlockCache::kFlushOnly;
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
fprintf(stderr, "Unknown prepopulate block cache mode\n");
|
|
|
|
}
|
|
|
|
block_based_options.prepopulate_block_cache = prepopulate_block_cache;
|
2018-08-17 01:29:13 +00:00
|
|
|
if (FLAGS_use_data_block_hash_index) {
|
|
|
|
block_based_options.data_block_index_type =
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions::kDataBlockBinaryAndHash;
|
2018-08-17 01:29:13 +00:00
|
|
|
} else {
|
|
|
|
block_based_options.data_block_index_type =
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::BlockBasedTableOptions::kDataBlockBinarySearch;
|
2018-08-17 01:29:13 +00:00
|
|
|
}
|
|
|
|
block_based_options.data_block_hash_table_util_ratio =
|
|
|
|
FLAGS_data_block_hash_table_util_ratio;
|
2017-02-27 20:59:34 +00:00
|
|
|
if (FLAGS_read_cache_path != "") {
|
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
Status rc_status;
|
|
|
|
|
|
|
|
// Read cache need to be provided with a the Logger, we will put all
|
|
|
|
// reac cache logs in the read cache path in a file named rc_LOG
|
|
|
|
rc_status = FLAGS_env->CreateDirIfMissing(FLAGS_read_cache_path);
|
|
|
|
std::shared_ptr<Logger> read_cache_logger;
|
|
|
|
if (rc_status.ok()) {
|
|
|
|
rc_status = FLAGS_env->NewLogger(FLAGS_read_cache_path + "/rc_LOG",
|
|
|
|
&read_cache_logger);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (rc_status.ok()) {
|
|
|
|
PersistentCacheConfig rc_cfg(FLAGS_env, FLAGS_read_cache_path,
|
|
|
|
FLAGS_read_cache_size,
|
|
|
|
read_cache_logger);
|
|
|
|
|
|
|
|
rc_cfg.enable_direct_reads = FLAGS_read_cache_direct_read;
|
|
|
|
rc_cfg.enable_direct_writes = FLAGS_read_cache_direct_write;
|
|
|
|
rc_cfg.writer_qdepth = 4;
|
|
|
|
rc_cfg.writer_dispatch_size = 4 * 1024;
|
|
|
|
|
|
|
|
auto pcache = std::make_shared<BlockCacheTier>(rc_cfg);
|
|
|
|
block_based_options.persistent_cache = pcache;
|
|
|
|
rc_status = pcache->Open();
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!rc_status.ok()) {
|
|
|
|
fprintf(stderr, "Error initializing read cache, %s\n",
|
|
|
|
rc_status.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
#else
|
|
|
|
fprintf(stderr, "Read cache is not supported in LITE\n");
|
|
|
|
exit(1);
|
|
|
|
|
|
|
|
#endif
|
|
|
|
}
|
2022-07-19 06:26:57 +00:00
|
|
|
|
|
|
|
if (FLAGS_use_blob_cache) {
|
|
|
|
if (FLAGS_use_shared_block_and_blob_cache) {
|
|
|
|
options.blob_cache = cache_;
|
|
|
|
} else {
|
|
|
|
if (FLAGS_blob_cache_size > 0) {
|
|
|
|
LRUCacheOptions co;
|
|
|
|
co.capacity = FLAGS_blob_cache_size;
|
|
|
|
co.num_shard_bits = FLAGS_blob_cache_numshardbits;
|
|
|
|
options.blob_cache = NewLRUCache(co);
|
|
|
|
} else {
|
|
|
|
fprintf(
|
|
|
|
stderr,
|
|
|
|
"Unable to create a standalone blob cache if blob_cache_size "
|
|
|
|
"<= 0.\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
switch (FLAGS_prepopulate_blob_cache) {
|
|
|
|
case 0:
|
|
|
|
options.prepopulate_blob_cache = PrepopulateBlobCache::kDisable;
|
|
|
|
break;
|
|
|
|
case 1:
|
|
|
|
options.prepopulate_blob_cache = PrepopulateBlobCache::kFlushOnly;
|
|
|
|
break;
|
|
|
|
default:
|
|
|
|
fprintf(stderr, "Unknown prepopulate blob cache mode\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
fprintf(stdout,
|
|
|
|
"Integrated BlobDB: blob cache enabled, block and blob caches "
|
|
|
|
"shared: %d, blob cache size %" PRIu64
|
|
|
|
", blob cache num shard bits: %d, hot/warm blobs prepopulated: "
|
|
|
|
"%d\n",
|
|
|
|
FLAGS_use_shared_block_and_blob_cache, FLAGS_blob_cache_size,
|
|
|
|
FLAGS_blob_cache_numshardbits, FLAGS_prepopulate_blob_cache);
|
|
|
|
} else {
|
|
|
|
fprintf(stdout, "Integrated BlobDB: blob cache disabled\n");
|
|
|
|
}
|
|
|
|
|
2014-07-17 00:32:30 +00:00
|
|
|
options.table_factory.reset(
|
|
|
|
NewBlockBasedTableFactory(block_based_options));
|
2014-02-12 18:41:55 +00:00
|
|
|
}
|
2013-10-24 14:43:14 +00:00
|
|
|
if (FLAGS_max_bytes_for_level_multiplier_additional_v.size() > 0) {
|
|
|
|
if (FLAGS_max_bytes_for_level_multiplier_additional_v.size() !=
|
2019-07-01 20:02:30 +00:00
|
|
|
static_cast<unsigned int>(FLAGS_num_levels)) {
|
2019-07-01 21:53:51 +00:00
|
|
|
fprintf(stderr, "Insufficient number of fanouts specified %d\n",
|
|
|
|
static_cast<int>(
|
|
|
|
FLAGS_max_bytes_for_level_multiplier_additional_v.size()));
|
2013-05-21 18:37:06 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
options.max_bytes_for_level_multiplier_additional =
|
2013-10-24 14:43:14 +00:00
|
|
|
FLAGS_max_bytes_for_level_multiplier_additional_v;
|
2013-05-21 18:37:06 +00:00
|
|
|
}
|
2012-08-19 23:05:02 +00:00
|
|
|
options.level0_stop_writes_trigger = FLAGS_level0_stop_writes_trigger;
|
2012-10-23 17:34:09 +00:00
|
|
|
options.level0_file_num_compaction_trigger =
|
2012-10-19 21:00:53 +00:00
|
|
|
FLAGS_level0_file_num_compaction_trigger;
|
2012-08-19 23:05:02 +00:00
|
|
|
options.level0_slowdown_writes_trigger =
|
|
|
|
FLAGS_level0_slowdown_writes_trigger;
|
2013-10-24 14:43:14 +00:00
|
|
|
options.compression = FLAGS_compression_type_e;
|
2021-05-03 20:30:00 +00:00
|
|
|
if (FLAGS_simulate_hybrid_fs_file != "") {
|
|
|
|
options.bottommost_temperature = Temperature::kWarm;
|
|
|
|
}
|
2022-08-08 20:08:35 +00:00
|
|
|
options.preclude_last_level_data_seconds =
|
|
|
|
FLAGS_preclude_last_level_data_seconds;
|
2019-03-18 19:07:35 +00:00
|
|
|
options.sample_for_compression = FLAGS_sample_for_compression;
|
2013-11-07 02:46:28 +00:00
|
|
|
options.WAL_ttl_seconds = FLAGS_wal_ttl_seconds;
|
|
|
|
options.WAL_size_limit_MB = FLAGS_wal_size_limit_MB;
|
2014-12-23 02:39:28 +00:00
|
|
|
options.max_total_wal_size = FLAGS_max_total_wal_size;
|
|
|
|
|
2012-10-28 06:13:17 +00:00
|
|
|
if (FLAGS_min_level_to_compress >= 0) {
|
|
|
|
assert(FLAGS_min_level_to_compress <= FLAGS_num_levels);
|
2013-01-24 18:54:26 +00:00
|
|
|
options.compression_per_level.resize(FLAGS_num_levels);
|
2012-11-12 21:50:55 +00:00
|
|
|
for (int i = 0; i < FLAGS_min_level_to_compress; i++) {
|
2012-10-28 06:13:17 +00:00
|
|
|
options.compression_per_level[i] = kNoCompression;
|
|
|
|
}
|
2013-03-15 01:32:01 +00:00
|
|
|
for (int i = FLAGS_min_level_to_compress;
|
2012-10-28 06:13:17 +00:00
|
|
|
i < FLAGS_num_levels; i++) {
|
2013-10-24 14:43:14 +00:00
|
|
|
options.compression_per_level[i] = FLAGS_compression_type_e;
|
2012-10-28 06:13:17 +00:00
|
|
|
}
|
|
|
|
}
|
2015-12-18 02:10:48 +00:00
|
|
|
options.soft_pending_compaction_bytes_limit =
|
|
|
|
FLAGS_soft_pending_compaction_bytes_limit;
|
2015-09-11 21:31:23 +00:00
|
|
|
options.hard_pending_compaction_bytes_limit =
|
|
|
|
FLAGS_hard_pending_compaction_bytes_limit;
|
2015-05-15 22:52:51 +00:00
|
|
|
options.delayed_write_rate = FLAGS_delayed_write_rate;
|
support for concurrent adds to memtable
Summary:
This diff adds support for concurrent adds to the skiplist memtable
implementations. Memory allocation is made thread-safe by the addition of
a spinlock, with small per-core buffers to avoid contention. Concurrent
memtable writes are made via an additional method and don't impose a
performance overhead on the non-concurrent case, so parallelism can be
selected on a per-batch basis.
Write thread synchronization is an increasing bottleneck for higher levels
of concurrency, so this diff adds --enable_write_thread_adaptive_yield
(default off). This feature causes threads joining a write batch
group to spin for a short time (default 100 usec) using sched_yield,
rather than going to sleep on a mutex. If the timing of the yield calls
indicates that another thread has actually run during the yield then
spinning is avoided. This option improves performance for concurrent
situations even without parallel adds, although it has the potential to
increase CPU usage (and the heuristic adaptation is not yet mature).
Parallel writes are not currently compatible with
inplace updates, update callbacks, or delete filtering.
Enable it with --allow_concurrent_memtable_write (and
--enable_write_thread_adaptive_yield). Parallel memtable writes
are performance neutral when there is no actual parallelism, and in
my experiments (SSD server-class Linux and varying contention and key
sizes for fillrandom) they are always a performance win when there is
more than one thread.
Statistics are updated earlier in the write path, dropping the number
of DB mutex acquisitions from 2 to 1 for almost all cases.
This diff was motivated and inspired by Yahoo's cLSM work. It is more
conservative than cLSM: RocksDB's write batch group leader role is
preserved (along with all of the existing flush and write throttling
logic) and concurrent writers are blocked until all memtable insertions
have completed and the sequence number has been advanced, to preserve
linearizability.
My test config is "db_bench -benchmarks=fillrandom -threads=$T
-batch_size=1 -memtablerep=skip_list -value_size=100 --num=1000000/$T
-level0_slowdown_writes_trigger=9999 -level0_stop_writes_trigger=9999
-disable_auto_compactions --max_write_buffer_number=8
-max_background_flushes=8 --disable_wal --write_buffer_size=160000000
--block_size=16384 --allow_concurrent_memtable_write" on a two-socket
Xeon E5-2660 @ 2.2Ghz with lots of memory and an SSD hard drive. With 1
thread I get ~440Kops/sec. Peak performance for 1 socket (numactl
-N1) is slightly more than 1Mops/sec, at 16 threads. Peak performance
across both sockets happens at 30 threads, and is ~900Kops/sec, although
with fewer threads there is less performance loss when the system has
background work.
Test Plan:
1. concurrent stress tests for InlineSkipList and DynamicBloom
2. make clean; make check
3. make clean; DISABLE_JEMALLOC=1 make valgrind_check; valgrind db_bench
4. make clean; COMPILE_WITH_TSAN=1 make all check; db_bench
5. make clean; COMPILE_WITH_ASAN=1 make all check; db_bench
6. make clean; OPT=-DROCKSDB_LITE make check
7. verify no perf regressions when disabled
Reviewers: igor, sdong
Reviewed By: sdong
Subscribers: MarkCallaghan, IslamAbdelRahman, anthony, yhchiang, rven, sdong, guyg8, kradhakrishnan, dhruba
Differential Revision: https://reviews.facebook.net/D50589
2015-08-14 23:59:07 +00:00
|
|
|
options.allow_concurrent_memtable_write =
|
|
|
|
FLAGS_allow_concurrent_memtable_write;
|
2021-08-11 01:07:48 +00:00
|
|
|
options.experimental_mempurge_threshold =
|
|
|
|
FLAGS_experimental_mempurge_threshold;
|
2018-01-26 18:46:30 +00:00
|
|
|
options.inplace_update_support = FLAGS_inplace_update_support;
|
|
|
|
options.inplace_update_num_locks = FLAGS_inplace_update_num_locks;
|
support for concurrent adds to memtable
Summary:
This diff adds support for concurrent adds to the skiplist memtable
implementations. Memory allocation is made thread-safe by the addition of
a spinlock, with small per-core buffers to avoid contention. Concurrent
memtable writes are made via an additional method and don't impose a
performance overhead on the non-concurrent case, so parallelism can be
selected on a per-batch basis.
Write thread synchronization is an increasing bottleneck for higher levels
of concurrency, so this diff adds --enable_write_thread_adaptive_yield
(default off). This feature causes threads joining a write batch
group to spin for a short time (default 100 usec) using sched_yield,
rather than going to sleep on a mutex. If the timing of the yield calls
indicates that another thread has actually run during the yield then
spinning is avoided. This option improves performance for concurrent
situations even without parallel adds, although it has the potential to
increase CPU usage (and the heuristic adaptation is not yet mature).
Parallel writes are not currently compatible with
inplace updates, update callbacks, or delete filtering.
Enable it with --allow_concurrent_memtable_write (and
--enable_write_thread_adaptive_yield). Parallel memtable writes
are performance neutral when there is no actual parallelism, and in
my experiments (SSD server-class Linux and varying contention and key
sizes for fillrandom) they are always a performance win when there is
more than one thread.
Statistics are updated earlier in the write path, dropping the number
of DB mutex acquisitions from 2 to 1 for almost all cases.
This diff was motivated and inspired by Yahoo's cLSM work. It is more
conservative than cLSM: RocksDB's write batch group leader role is
preserved (along with all of the existing flush and write throttling
logic) and concurrent writers are blocked until all memtable insertions
have completed and the sequence number has been advanced, to preserve
linearizability.
My test config is "db_bench -benchmarks=fillrandom -threads=$T
-batch_size=1 -memtablerep=skip_list -value_size=100 --num=1000000/$T
-level0_slowdown_writes_trigger=9999 -level0_stop_writes_trigger=9999
-disable_auto_compactions --max_write_buffer_number=8
-max_background_flushes=8 --disable_wal --write_buffer_size=160000000
--block_size=16384 --allow_concurrent_memtable_write" on a two-socket
Xeon E5-2660 @ 2.2Ghz with lots of memory and an SSD hard drive. With 1
thread I get ~440Kops/sec. Peak performance for 1 socket (numactl
-N1) is slightly more than 1Mops/sec, at 16 threads. Peak performance
across both sockets happens at 30 threads, and is ~900Kops/sec, although
with fewer threads there is less performance loss when the system has
background work.
Test Plan:
1. concurrent stress tests for InlineSkipList and DynamicBloom
2. make clean; make check
3. make clean; DISABLE_JEMALLOC=1 make valgrind_check; valgrind db_bench
4. make clean; COMPILE_WITH_TSAN=1 make all check; db_bench
5. make clean; COMPILE_WITH_ASAN=1 make all check; db_bench
6. make clean; OPT=-DROCKSDB_LITE make check
7. verify no perf regressions when disabled
Reviewers: igor, sdong
Reviewed By: sdong
Subscribers: MarkCallaghan, IslamAbdelRahman, anthony, yhchiang, rven, sdong, guyg8, kradhakrishnan, dhruba
Differential Revision: https://reviews.facebook.net/D50589
2015-08-14 23:59:07 +00:00
|
|
|
options.enable_write_thread_adaptive_yield =
|
|
|
|
FLAGS_enable_write_thread_adaptive_yield;
|
2017-06-30 22:21:02 +00:00
|
|
|
options.enable_pipelined_write = FLAGS_enable_pipelined_write;
|
2019-05-14 00:43:47 +00:00
|
|
|
options.unordered_write = FLAGS_unordered_write;
|
support for concurrent adds to memtable
Summary:
This diff adds support for concurrent adds to the skiplist memtable
implementations. Memory allocation is made thread-safe by the addition of
a spinlock, with small per-core buffers to avoid contention. Concurrent
memtable writes are made via an additional method and don't impose a
performance overhead on the non-concurrent case, so parallelism can be
selected on a per-batch basis.
Write thread synchronization is an increasing bottleneck for higher levels
of concurrency, so this diff adds --enable_write_thread_adaptive_yield
(default off). This feature causes threads joining a write batch
group to spin for a short time (default 100 usec) using sched_yield,
rather than going to sleep on a mutex. If the timing of the yield calls
indicates that another thread has actually run during the yield then
spinning is avoided. This option improves performance for concurrent
situations even without parallel adds, although it has the potential to
increase CPU usage (and the heuristic adaptation is not yet mature).
Parallel writes are not currently compatible with
inplace updates, update callbacks, or delete filtering.
Enable it with --allow_concurrent_memtable_write (and
--enable_write_thread_adaptive_yield). Parallel memtable writes
are performance neutral when there is no actual parallelism, and in
my experiments (SSD server-class Linux and varying contention and key
sizes for fillrandom) they are always a performance win when there is
more than one thread.
Statistics are updated earlier in the write path, dropping the number
of DB mutex acquisitions from 2 to 1 for almost all cases.
This diff was motivated and inspired by Yahoo's cLSM work. It is more
conservative than cLSM: RocksDB's write batch group leader role is
preserved (along with all of the existing flush and write throttling
logic) and concurrent writers are blocked until all memtable insertions
have completed and the sequence number has been advanced, to preserve
linearizability.
My test config is "db_bench -benchmarks=fillrandom -threads=$T
-batch_size=1 -memtablerep=skip_list -value_size=100 --num=1000000/$T
-level0_slowdown_writes_trigger=9999 -level0_stop_writes_trigger=9999
-disable_auto_compactions --max_write_buffer_number=8
-max_background_flushes=8 --disable_wal --write_buffer_size=160000000
--block_size=16384 --allow_concurrent_memtable_write" on a two-socket
Xeon E5-2660 @ 2.2Ghz with lots of memory and an SSD hard drive. With 1
thread I get ~440Kops/sec. Peak performance for 1 socket (numactl
-N1) is slightly more than 1Mops/sec, at 16 threads. Peak performance
across both sockets happens at 30 threads, and is ~900Kops/sec, although
with fewer threads there is less performance loss when the system has
background work.
Test Plan:
1. concurrent stress tests for InlineSkipList and DynamicBloom
2. make clean; make check
3. make clean; DISABLE_JEMALLOC=1 make valgrind_check; valgrind db_bench
4. make clean; COMPILE_WITH_TSAN=1 make all check; db_bench
5. make clean; COMPILE_WITH_ASAN=1 make all check; db_bench
6. make clean; OPT=-DROCKSDB_LITE make check
7. verify no perf regressions when disabled
Reviewers: igor, sdong
Reviewed By: sdong
Subscribers: MarkCallaghan, IslamAbdelRahman, anthony, yhchiang, rven, sdong, guyg8, kradhakrishnan, dhruba
Differential Revision: https://reviews.facebook.net/D50589
2015-08-14 23:59:07 +00:00
|
|
|
options.write_thread_max_yield_usec = FLAGS_write_thread_max_yield_usec;
|
|
|
|
options.write_thread_slow_yield_usec = FLAGS_write_thread_slow_yield_usec;
|
2012-11-01 00:02:24 +00:00
|
|
|
options.table_cache_numshardbits = FLAGS_table_cache_numshardbits;
|
2016-06-16 23:02:52 +00:00
|
|
|
options.max_compaction_bytes = FLAGS_max_compaction_bytes;
|
2012-11-20 23:45:41 +00:00
|
|
|
options.disable_auto_compactions = FLAGS_disable_auto_compactions;
|
2016-05-05 14:32:10 +00:00
|
|
|
options.optimize_filters_for_hits = FLAGS_optimize_filters_for_hits;
|
2022-01-19 01:25:33 +00:00
|
|
|
options.paranoid_checks = FLAGS_paranoid_checks;
|
|
|
|
options.force_consistency_checks = FLAGS_force_consistency_checks;
|
|
|
|
options.check_flush_compaction_key_order =
|
|
|
|
FLAGS_check_flush_compaction_key_order;
|
2020-07-29 20:38:07 +00:00
|
|
|
options.periodic_compaction_seconds = FLAGS_periodic_compaction_seconds;
|
Try to start TTL earlier with kMinOverlappingRatio is used (#8749)
Summary:
Right now, when options.ttl is set, compactions are triggered around the time when TTL is reached. This might cause extra compactions which are often bursty. This commit tries to mitigate it by picking those files earlier in normal compaction picking process. This is only implemented using kMinOverlappingRatio with Leveled compaction as it is the default value and it is more complicated to change other styles.
When a file is aged more than ttl/2, RocksDB starts to boost the compaction priority of files in normal compaction picking process, and hope by the time TTL is reached, very few extra compaction is needed.
In order for this to work, another change is made: during a compaction, if an output level file is older than ttl/2, cut output files based on original boundary (if it is not in the last level). This is to make sure that after an old file is moved to the next level, and new data is merged from the upper level, the new data falling into this range isn't reset with old timestamp. Without this change, in many cases, most files from one level will keep having old timestamp, even if they have newer data and we stuck in it.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8749
Test Plan: Add a unit test to test the boosting logic. Will add a unit test to test it end-to-end.
Reviewed By: jay-zhuang
Differential Revision: D30735261
fbshipit-source-id: 503c2d89250b22911eb99e72b379be154de3428e
2021-11-01 21:32:12 +00:00
|
|
|
options.ttl = FLAGS_ttl_seconds;
|
2013-03-15 00:00:04 +00:00
|
|
|
// fill storage options
|
2013-05-17 22:53:01 +00:00
|
|
|
options.advise_random_on_open = FLAGS_advise_random_on_open;
|
2013-10-24 14:43:14 +00:00
|
|
|
options.access_hint_on_compaction_start = FLAGS_compaction_fadvice_e;
|
2013-05-31 23:30:17 +00:00
|
|
|
options.use_adaptive_mutex = FLAGS_use_adaptive_mutex;
|
2013-06-14 05:49:46 +00:00
|
|
|
options.bytes_per_sync = FLAGS_bytes_per_sync;
|
2015-05-19 23:19:30 +00:00
|
|
|
options.wal_bytes_per_sync = FLAGS_wal_bytes_per_sync;
|
2013-05-31 23:30:17 +00:00
|
|
|
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
// merge operator options
|
2021-08-06 15:26:23 +00:00
|
|
|
if (!FLAGS_merge_operator.empty()) {
|
2021-09-08 14:45:59 +00:00
|
|
|
s = MergeOperator::CreateFromString(config_options, FLAGS_merge_operator,
|
|
|
|
&options.merge_operator);
|
2021-08-06 15:26:23 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "invalid merge operator[%s]: %s\n",
|
|
|
|
FLAGS_merge_operator.c_str(), s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
}
|
2014-01-11 01:33:56 +00:00
|
|
|
options.max_successive_merges = FLAGS_max_successive_merges;
|
2016-04-14 20:56:29 +00:00
|
|
|
options.report_bg_io_stats = FLAGS_report_bg_io_stats;
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
|
2013-09-09 23:06:10 +00:00
|
|
|
// set universal style compaction configurations, if applicable
|
|
|
|
if (FLAGS_universal_size_ratio != 0) {
|
|
|
|
options.compaction_options_universal.size_ratio =
|
|
|
|
FLAGS_universal_size_ratio;
|
|
|
|
}
|
|
|
|
if (FLAGS_universal_min_merge_width != 0) {
|
|
|
|
options.compaction_options_universal.min_merge_width =
|
|
|
|
FLAGS_universal_min_merge_width;
|
|
|
|
}
|
|
|
|
if (FLAGS_universal_max_merge_width != 0) {
|
|
|
|
options.compaction_options_universal.max_merge_width =
|
|
|
|
FLAGS_universal_max_merge_width;
|
|
|
|
}
|
|
|
|
if (FLAGS_universal_max_size_amplification_percent != 0) {
|
|
|
|
options.compaction_options_universal.max_size_amplification_percent =
|
|
|
|
FLAGS_universal_max_size_amplification_percent;
|
|
|
|
}
|
2013-12-03 20:32:07 +00:00
|
|
|
if (FLAGS_universal_compression_size_percent != -1) {
|
|
|
|
options.compaction_options_universal.compression_size_percent =
|
|
|
|
FLAGS_universal_compression_size_percent;
|
|
|
|
}
|
2015-07-20 18:52:39 +00:00
|
|
|
options.compaction_options_universal.allow_trivial_move =
|
|
|
|
FLAGS_universal_allow_trivial_move;
|
Incremental Space Amp Compactions in Universal Style (#8655)
Summary:
This commit introduces incremental compaction in univeral style for space amplification. This follows the first improvement mentioned in https://rocksdb.org/blog/2021/04/12/universal-improvements.html . The implemention simply picks up files about size of max_compaction_bytes to compact and execute if the penalty is not too big. More optimizations can be done in the future, e.g. prioritizing between this compaction and other types. But for now, the feature is supposed to be functional and can often reduce frequency of full compactions, although it can introduce penalty.
In order to add cut files more efficiently so that more files from upper levels can be included, SST file cutting threshold (for current file + overlapping parent level files) is set to 1.5X of target file size. A 2MB target file size will generate files like this: https://gist.github.com/siying/29d2676fba417404f3c95e6c013c7de8 Number of files indeed increases but it is not out of control.
Two set of write benchmarks are run:
1. For ingestion rate limited scenario, we can see full compaction is mostly eliminated: https://gist.github.com/siying/959bc1186066906831cf4c808d6e0a19 . The write amp increased from 7.7 to 9.4, as expected. After applying file cutting, the number is improved to 8.9. In another benchmark, the write amp is even better with the incremental approach: https://gist.github.com/siying/d1c16c286d7c59c4d7bba718ca198163
2. For ingestion rate unlimited scenario, incremental compaction turns out to be too expensive most of the time and is not executed, as expected.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8655
Test Plan: Add unit tests to the functionality.
Reviewed By: ajkr
Differential Revision: D31787034
fbshipit-source-id: ce813e63b15a61d5a56e97bf8902a1b28e011beb
2021-10-20 17:03:03 +00:00
|
|
|
options.compaction_options_universal.incremental =
|
|
|
|
FLAGS_universal_incremental;
|
2015-03-06 19:22:06 +00:00
|
|
|
if (FLAGS_thread_status_per_interval > 0) {
|
|
|
|
options.enable_thread_tracking = true;
|
|
|
|
}
|
2013-09-09 23:06:10 +00:00
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
if (FLAGS_user_timestamp_size > 0) {
|
|
|
|
if (FLAGS_user_timestamp_size != 8) {
|
|
|
|
fprintf(stderr, "Only 64 bits timestamps are supported.\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
2022-02-08 20:14:25 +00:00
|
|
|
options.comparator = test::BytewiseComparatorWithU64TsWrapper();
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
|
|
|
|
2022-06-15 19:38:04 +00:00
|
|
|
options.allow_data_in_errors = FLAGS_allow_data_in_errors;
|
2022-07-13 00:16:57 +00:00
|
|
|
options.track_and_verify_wals_in_manifest =
|
|
|
|
FLAGS_track_and_verify_wals_in_manifest;
|
2022-06-15 19:38:04 +00:00
|
|
|
|
2021-02-17 19:08:12 +00:00
|
|
|
// Integrated BlobDB
|
|
|
|
options.enable_blob_files = FLAGS_enable_blob_files;
|
|
|
|
options.min_blob_size = FLAGS_min_blob_size;
|
|
|
|
options.blob_file_size = FLAGS_blob_file_size;
|
|
|
|
options.blob_compression_type =
|
|
|
|
StringToCompressionType(FLAGS_blob_compression_type.c_str());
|
|
|
|
options.enable_blob_garbage_collection =
|
|
|
|
FLAGS_enable_blob_garbage_collection;
|
|
|
|
options.blob_garbage_collection_age_cutoff =
|
|
|
|
FLAGS_blob_garbage_collection_age_cutoff;
|
Make it possible to force the garbage collection of the oldest blob files (#8994)
Summary:
The current BlobDB garbage collection logic works by relocating the valid
blobs from the oldest blob files as they are encountered during compaction,
and cleaning up blob files once they contain nothing but garbage. However,
with sufficiently skewed workloads, it is theoretically possible to end up in a
situation when few or no compactions get scheduled for the SST files that contain
references to the oldest blob files, which can lead to increased space amp due
to the lack of GC.
In order to efficiently handle such workloads, the patch adds a new BlobDB
configuration option called `blob_garbage_collection_force_threshold`,
which signals to BlobDB to schedule targeted compactions for the SST files
that keep alive the oldest batch of blob files if the overall ratio of garbage in
the given blob files meets the threshold *and* all the given blob files are
eligible for GC based on `blob_garbage_collection_age_cutoff`. (For example,
if the new option is set to 0.9, targeted compactions will get scheduled if the
sum of garbage bytes meets or exceeds 90% of the sum of total bytes in the
oldest blob files, assuming all affected blob files are below the age-based cutoff.)
The net result of these targeted compactions is that the valid blobs in the oldest
blob files are relocated and the oldest blob files themselves cleaned up (since
*all* SST files that rely on them get compacted away).
These targeted compactions are similar to periodic compactions in the sense
that they force certain SST files that otherwise would not get picked up to undergo
compaction and also in the sense that instead of merging files from multiple levels,
they target a single file. (Note: such compactions might still include neighboring files
from the same level due to the need of having a "clean cut" boundary but they never
include any files from any other level.)
This functionality is currently only supported with the leveled compaction style
and is inactive by default (since the default value is set to 1.0, i.e. 100%).
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8994
Test Plan: Ran `make check` and tested using `db_bench` and the stress/crash tests.
Reviewed By: riversand963
Differential Revision: D31489850
Pulled By: ltamasi
fbshipit-source-id: 44057d511726a0e2a03c5d9313d7511b3f0c4eab
2021-10-12 01:00:44 +00:00
|
|
|
options.blob_garbage_collection_force_threshold =
|
|
|
|
FLAGS_blob_garbage_collection_force_threshold;
|
2021-11-20 01:52:42 +00:00
|
|
|
options.blob_compaction_readahead_size =
|
|
|
|
FLAGS_blob_compaction_readahead_size;
|
2022-06-03 03:04:33 +00:00
|
|
|
options.blob_file_starting_level = FLAGS_blob_file_starting_level;
|
2021-02-17 19:08:12 +00:00
|
|
|
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2015-05-29 21:36:35 +00:00
|
|
|
if (FLAGS_readonly && FLAGS_transaction_db) {
|
|
|
|
fprintf(stderr, "Cannot use readonly flag with transaction_db\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
2019-05-31 02:29:34 +00:00
|
|
|
if (FLAGS_use_secondary_db &&
|
|
|
|
(FLAGS_transaction_db || FLAGS_optimistic_transaction_db)) {
|
|
|
|
fprintf(stderr, "Cannot use use_secondary_db flag with transaction_db\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2022-08-12 20:51:32 +00:00
|
|
|
options.memtable_protection_bytes_per_key =
|
|
|
|
FLAGS_memtable_protection_bytes_per_key;
|
2016-06-02 23:24:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
void InitializeOptionsGeneral(Options* opts) {
|
2022-04-19 06:46:16 +00:00
|
|
|
// Be careful about what is set here to avoid accidentally overwriting
|
|
|
|
// settings already configured by OPTIONS file. Only configure settings that
|
|
|
|
// are needed for the benchmark to run, settings for shared objects that
|
|
|
|
// were not configured already, settings that require dynamically invoking
|
|
|
|
// APIs, and settings for the benchmark itself.
|
2016-06-02 23:24:14 +00:00
|
|
|
Options& options = *opts;
|
|
|
|
|
2022-04-19 06:46:16 +00:00
|
|
|
// Always set these since they are harmless when not needed and prevent
|
|
|
|
// a guaranteed failure when they are needed.
|
|
|
|
options.create_missing_column_families = true;
|
|
|
|
options.create_if_missing = true;
|
|
|
|
|
|
|
|
if (options.statistics == nullptr) {
|
|
|
|
options.statistics = dbstats;
|
|
|
|
}
|
2016-06-02 23:24:14 +00:00
|
|
|
|
2020-09-14 23:59:00 +00:00
|
|
|
auto table_options =
|
|
|
|
options.table_factory->GetOptions<BlockBasedTableOptions>();
|
|
|
|
if (table_options != nullptr) {
|
2022-04-19 06:46:16 +00:00
|
|
|
if (FLAGS_cache_size > 0) {
|
|
|
|
// This violates this function's rules on when to set options. But we
|
|
|
|
// have to do it because the case of unconfigured block cache in OPTIONS
|
|
|
|
// file is indistinguishable (it is sanitized to 8MB by this point, not
|
|
|
|
// nullptr), and our regression tests assume this will be the shared
|
|
|
|
// block cache, even with OPTIONS file provided.
|
2018-07-13 23:27:37 +00:00
|
|
|
table_options->block_cache = cache_;
|
|
|
|
}
|
2022-04-19 06:46:16 +00:00
|
|
|
if (table_options->filter_policy == nullptr) {
|
|
|
|
if (FLAGS_bloom_bits < 0) {
|
|
|
|
table_options->filter_policy = BlockBasedTableOptions().filter_policy;
|
|
|
|
} else if (FLAGS_bloom_bits == 0) {
|
|
|
|
table_options->filter_policy.reset();
|
|
|
|
} else {
|
|
|
|
table_options->filter_policy.reset(
|
|
|
|
FLAGS_use_ribbon_filter ? NewRibbonFilterPolicy(FLAGS_bloom_bits)
|
|
|
|
: NewBloomFilterPolicy(FLAGS_bloom_bits));
|
Hide deprecated, inefficient block-based filter from public API (#9535)
Summary:
This change removes the ability to configure the deprecated,
inefficient block-based filter in the public API. Options that would
have enabled it now use "full" (and optionally partitioned) filters.
Existing block-based filters can still be read and used, and a "back
door" way to build them still exists, for testing and in case of trouble.
About the only way this removal would cause an issue for users is if
temporary memory for filter construction greatly increases. In
HISTORY.md we suggest a few possible mitigations: partitioned filters,
smaller SST files, or setting reserve_table_builder_memory=true.
Or users who have customized a FilterPolicy using the
CreateFilter/KeyMayMatch mechanism removed in https://github.com/facebook/rocksdb/issues/9501 will have to upgrade
their code. (It's long past time for people to move to the new
builder/reader customization interface.)
This change also introduces some internal-use-only configuration strings
for testing specific filter implementations while bypassing some
compatibility / intelligence logic. This is intended to hint at a path
toward making FilterPolicy Customizable, but it also gives us a "back
door" way to configure block-based filter.
Aside: updated db_bench so that -readonly implies -use_existing_db
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9535
Test Plan:
Unit tests updated. Specifically,
* BlockBasedTableTest.BlockReadCountTest is tweaked to validate the back
door configuration interface and ignoring of `use_block_based_builder`.
* BlockBasedTableTest.TracingGetTest is migrated from testing
block-based filter access pattern to full filter access patter, by
re-ordering some things.
* Options test (pretty self-explanatory)
Performance test - create with `./db_bench -db=/dev/shm/rocksdb1 -bloom_bits=10 -cache_index_and_filter_blocks=1 -benchmarks=fillrandom -num=10000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=0` with and without `-use_block_based_filter`, which creates a DB with 21 SST files in L0. Read with `./db_bench -db=/dev/shm/rocksdb1 -readonly -bloom_bits=10 -cache_index_and_filter_blocks=1 -benchmarks=readrandom -num=10000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=0 -duration=30`
Without -use_block_based_filter: readrandom 464 ops/sec, 689280 KB DB
With -use_block_based_filter: readrandom 169 ops/sec, 690996 KB DB
No consistent difference with fillrandom
Reviewed By: jay-zhuang
Differential Revision: D34153871
Pulled By: pdillinger
fbshipit-source-id: 31f4a933c542f8f09aca47fa64aec67832a69738
2022-02-12 15:04:09 +00:00
|
|
|
}
|
2018-07-18 23:14:02 +00:00
|
|
|
}
|
2018-07-13 23:27:37 +00:00
|
|
|
}
|
2022-04-19 06:46:16 +00:00
|
|
|
|
|
|
|
if (options.row_cache == nullptr) {
|
|
|
|
if (FLAGS_row_cache_size) {
|
|
|
|
if (FLAGS_cache_numshardbits >= 1) {
|
|
|
|
options.row_cache =
|
|
|
|
NewLRUCache(FLAGS_row_cache_size, FLAGS_cache_numshardbits);
|
|
|
|
} else {
|
|
|
|
options.row_cache = NewLRUCache(FLAGS_row_cache_size);
|
|
|
|
}
|
2016-06-02 23:24:14 +00:00
|
|
|
}
|
|
|
|
}
|
2022-04-19 06:46:16 +00:00
|
|
|
|
|
|
|
if (options.env == Env::Default()) {
|
|
|
|
options.env = FLAGS_env;
|
|
|
|
}
|
2016-06-02 23:24:14 +00:00
|
|
|
if (FLAGS_enable_io_prio) {
|
2022-04-19 06:46:16 +00:00
|
|
|
options.env->LowerThreadPoolIOPriority(Env::LOW);
|
|
|
|
options.env->LowerThreadPoolIOPriority(Env::HIGH);
|
2016-06-02 23:24:14 +00:00
|
|
|
}
|
2018-04-24 15:38:01 +00:00
|
|
|
if (FLAGS_enable_cpu_prio) {
|
2022-04-19 06:46:16 +00:00
|
|
|
options.env->LowerThreadPoolCPUPriority(Env::LOW);
|
|
|
|
options.env->LowerThreadPoolCPUPriority(Env::HIGH);
|
2018-04-24 15:38:01 +00:00
|
|
|
}
|
2022-04-19 06:46:16 +00:00
|
|
|
|
2018-06-15 19:07:38 +00:00
|
|
|
if (FLAGS_sine_write_rate) {
|
|
|
|
FLAGS_benchmark_write_rate_limit = static_cast<uint64_t>(SineRate(0));
|
|
|
|
}
|
2016-06-02 23:24:14 +00:00
|
|
|
|
2022-04-19 06:46:16 +00:00
|
|
|
if (options.rate_limiter == nullptr) {
|
|
|
|
if (FLAGS_rate_limiter_bytes_per_sec > 0) {
|
|
|
|
options.rate_limiter.reset(NewGenericRateLimiter(
|
|
|
|
FLAGS_rate_limiter_bytes_per_sec,
|
|
|
|
FLAGS_rate_limiter_refill_period_us, 10 /* fairness */,
|
2022-06-17 23:40:47 +00:00
|
|
|
// TODO: replace this with a more general FLAG for deciding
|
|
|
|
// RateLimiter::Mode as now we also rate-limit foreground reads e.g,
|
|
|
|
// Get()/MultiGet()
|
2022-04-19 06:46:16 +00:00
|
|
|
FLAGS_rate_limit_bg_reads ? RateLimiter::Mode::kReadsOnly
|
|
|
|
: RateLimiter::Mode::kWritesOnly,
|
|
|
|
FLAGS_rate_limiter_auto_tuned));
|
|
|
|
}
|
2017-09-21 18:03:53 +00:00
|
|
|
}
|
|
|
|
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
options.listeners.emplace_back(listener_);
|
2021-02-17 19:08:12 +00:00
|
|
|
|
2022-04-19 06:46:16 +00:00
|
|
|
if (options.file_checksum_gen_factory == nullptr) {
|
|
|
|
if (FLAGS_file_checksum) {
|
|
|
|
options.file_checksum_gen_factory.reset(
|
|
|
|
new FileChecksumGenCrc32cFactory());
|
|
|
|
}
|
2022-02-17 07:17:03 +00:00
|
|
|
}
|
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
if (FLAGS_num_multi_db <= 1) {
|
|
|
|
OpenDb(options, FLAGS_db, &db_);
|
|
|
|
} else {
|
|
|
|
multi_dbs_.clear();
|
2014-08-19 01:15:01 +00:00
|
|
|
multi_dbs_.resize(FLAGS_num_multi_db);
|
2016-10-18 23:30:57 +00:00
|
|
|
auto wal_dir = options.wal_dir;
|
2014-04-29 19:33:57 +00:00
|
|
|
for (int i = 0; i < FLAGS_num_multi_db; i++) {
|
2016-10-18 23:30:57 +00:00
|
|
|
if (!wal_dir.empty()) {
|
|
|
|
options.wal_dir = GetPathForMultiple(wal_dir, i);
|
|
|
|
}
|
|
|
|
OpenDb(options, GetPathForMultiple(FLAGS_db, i), &multi_dbs_[i]);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
2016-10-18 23:30:57 +00:00
|
|
|
options.wal_dir = wal_dir;
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
2018-07-13 02:33:59 +00:00
|
|
|
|
|
|
|
// KeepFilter is a noop filter, this can be used to test compaction filter
|
2022-04-19 06:46:16 +00:00
|
|
|
if (options.compaction_filter == nullptr) {
|
|
|
|
if (FLAGS_use_keep_filter) {
|
|
|
|
options.compaction_filter = new KeepFilter();
|
|
|
|
fprintf(stdout, "A noop compaction filter is used\n");
|
|
|
|
}
|
2018-07-13 02:33:59 +00:00
|
|
|
}
|
2019-03-01 19:14:28 +00:00
|
|
|
|
|
|
|
if (FLAGS_use_existing_keys) {
|
|
|
|
// Only work on single database
|
|
|
|
assert(db_.db != nullptr);
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions read_opts; // before read_options_ initialized
|
2019-03-01 19:14:28 +00:00
|
|
|
read_opts.total_order_seek = true;
|
|
|
|
Iterator* iter = db_.db->NewIterator(read_opts);
|
|
|
|
for (iter->SeekToFirst(); iter->Valid(); iter->Next()) {
|
|
|
|
keys_.emplace_back(iter->key().ToString());
|
|
|
|
}
|
|
|
|
delete iter;
|
|
|
|
FLAGS_num = keys_.size();
|
|
|
|
}
|
2016-06-02 23:24:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
void Open(Options* opts) {
|
|
|
|
if (!InitializeOptionsFromFile(opts)) {
|
|
|
|
InitializeOptionsFromFlags(opts);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
2016-04-27 23:23:33 +00:00
|
|
|
|
2016-06-02 23:24:14 +00:00
|
|
|
InitializeOptionsGeneral(opts);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
|
2017-07-11 21:05:39 +00:00
|
|
|
void OpenDb(Options options, const std::string& db_name,
|
2014-08-19 01:15:01 +00:00
|
|
|
DBWithColumnFamilies* db) {
|
2021-07-02 01:41:20 +00:00
|
|
|
uint64_t open_start = FLAGS_report_open_timing ? FLAGS_env->NowNanos() : 0;
|
2012-11-06 03:18:49 +00:00
|
|
|
Status s;
|
2014-08-19 01:15:01 +00:00
|
|
|
// Open with column families if necessary.
|
|
|
|
if (FLAGS_num_column_families > 1) {
|
2014-12-23 02:39:28 +00:00
|
|
|
size_t num_hot = FLAGS_num_column_families;
|
|
|
|
if (FLAGS_num_hot_column_families > 0 &&
|
|
|
|
FLAGS_num_hot_column_families < FLAGS_num_column_families) {
|
|
|
|
num_hot = FLAGS_num_hot_column_families;
|
|
|
|
} else {
|
|
|
|
FLAGS_num_hot_column_families = FLAGS_num_column_families;
|
|
|
|
}
|
2014-08-19 01:15:01 +00:00
|
|
|
std::vector<ColumnFamilyDescriptor> column_families;
|
2014-12-23 02:39:28 +00:00
|
|
|
for (size_t i = 0; i < num_hot; i++) {
|
2014-08-19 01:15:01 +00:00
|
|
|
column_families.push_back(ColumnFamilyDescriptor(
|
|
|
|
ColumnFamilyName(i), ColumnFamilyOptions(options)));
|
|
|
|
}
|
2017-08-11 20:46:41 +00:00
|
|
|
std::vector<int> cfh_idx_to_prob;
|
|
|
|
if (!FLAGS_column_family_distribution.empty()) {
|
|
|
|
std::stringstream cf_prob_stream(FLAGS_column_family_distribution);
|
|
|
|
std::string cf_prob;
|
|
|
|
int sum = 0;
|
|
|
|
while (std::getline(cf_prob_stream, cf_prob, ',')) {
|
|
|
|
cfh_idx_to_prob.push_back(std::stoi(cf_prob));
|
|
|
|
sum += cfh_idx_to_prob.back();
|
|
|
|
}
|
|
|
|
if (sum != 100) {
|
|
|
|
fprintf(stderr, "column_family_distribution items must sum to 100\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
if (cfh_idx_to_prob.size() != num_hot) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"got %" ROCKSDB_PRIszt
|
|
|
|
" column_family_distribution items; expected "
|
|
|
|
"%" ROCKSDB_PRIszt "\n",
|
|
|
|
cfh_idx_to_prob.size(), num_hot);
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2014-08-19 01:15:01 +00:00
|
|
|
if (FLAGS_readonly) {
|
|
|
|
s = DB::OpenForReadOnly(options, db_name, column_families,
|
|
|
|
&db->cfh, &db->db);
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
} else if (FLAGS_optimistic_transaction_db) {
|
2015-05-29 21:36:35 +00:00
|
|
|
s = OptimisticTransactionDB::Open(options, db_name, column_families,
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
&db->cfh, &db->opt_txn_db);
|
|
|
|
if (s.ok()) {
|
|
|
|
db->db = db->opt_txn_db->GetBaseDB();
|
|
|
|
}
|
|
|
|
} else if (FLAGS_transaction_db) {
|
|
|
|
TransactionDB* ptr;
|
|
|
|
TransactionDBOptions txn_db_options;
|
2019-05-28 23:26:14 +00:00
|
|
|
if (options.unordered_write) {
|
|
|
|
options.two_write_queues = true;
|
|
|
|
txn_db_options.skip_concurrency_control = true;
|
|
|
|
txn_db_options.write_policy = WRITE_PREPARED;
|
|
|
|
}
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
s = TransactionDB::Open(options, txn_db_options, db_name,
|
|
|
|
column_families, &db->cfh, &ptr);
|
2015-05-29 21:36:35 +00:00
|
|
|
if (s.ok()) {
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
db->db = ptr;
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
2014-08-19 01:15:01 +00:00
|
|
|
} else {
|
|
|
|
s = DB::Open(options, db_name, column_families, &db->cfh, &db->db);
|
|
|
|
}
|
2015-10-14 19:43:00 +00:00
|
|
|
#else
|
|
|
|
s = DB::Open(options, db_name, column_families, &db->cfh, &db->db);
|
|
|
|
#endif // ROCKSDB_LITE
|
2014-12-23 02:39:28 +00:00
|
|
|
db->cfh.resize(FLAGS_num_column_families);
|
|
|
|
db->num_created = num_hot;
|
|
|
|
db->num_hot = num_hot;
|
2017-08-11 20:46:41 +00:00
|
|
|
db->cfh_idx_to_prob = std::move(cfh_idx_to_prob);
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2014-08-19 01:15:01 +00:00
|
|
|
} else if (FLAGS_readonly) {
|
|
|
|
s = DB::OpenForReadOnly(options, db_name, &db->db);
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
} else if (FLAGS_optimistic_transaction_db) {
|
|
|
|
s = OptimisticTransactionDB::Open(options, db_name, &db->opt_txn_db);
|
|
|
|
if (s.ok()) {
|
|
|
|
db->db = db->opt_txn_db->GetBaseDB();
|
|
|
|
}
|
2015-05-29 21:36:35 +00:00
|
|
|
} else if (FLAGS_transaction_db) {
|
2017-10-19 17:48:47 +00:00
|
|
|
TransactionDB* ptr = nullptr;
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
TransactionDBOptions txn_db_options;
|
2019-05-28 23:26:14 +00:00
|
|
|
if (options.unordered_write) {
|
|
|
|
options.two_write_queues = true;
|
|
|
|
txn_db_options.skip_concurrency_control = true;
|
|
|
|
txn_db_options.write_policy = WRITE_PREPARED;
|
|
|
|
}
|
2017-07-11 21:05:39 +00:00
|
|
|
s = CreateLoggerFromOptions(db_name, options, &options.info_log);
|
|
|
|
if (s.ok()) {
|
|
|
|
s = TransactionDB::Open(options, txn_db_options, db_name, &ptr);
|
|
|
|
}
|
2015-05-29 21:36:35 +00:00
|
|
|
if (s.ok()) {
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
db->db = ptr;
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
2016-08-09 17:16:32 +00:00
|
|
|
} else if (FLAGS_use_blob_db) {
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB
|
2017-05-10 21:54:35 +00:00
|
|
|
blob_db::BlobDBOptions blob_db_options;
|
2017-11-21 07:19:46 +00:00
|
|
|
blob_db_options.enable_garbage_collection = FLAGS_blob_db_enable_gc;
|
2019-12-19 01:44:29 +00:00
|
|
|
blob_db_options.garbage_collection_cutoff = FLAGS_blob_db_gc_cutoff;
|
2017-12-07 04:40:46 +00:00
|
|
|
blob_db_options.is_fifo = FLAGS_blob_db_is_fifo;
|
2018-03-06 19:46:20 +00:00
|
|
|
blob_db_options.max_db_size = FLAGS_blob_db_max_db_size;
|
2017-12-07 04:40:46 +00:00
|
|
|
blob_db_options.ttl_range_secs = FLAGS_blob_db_ttl_range_secs;
|
|
|
|
blob_db_options.min_blob_size = FLAGS_blob_db_min_blob_size;
|
|
|
|
blob_db_options.bytes_per_sync = FLAGS_blob_db_bytes_per_sync;
|
|
|
|
blob_db_options.blob_file_size = FLAGS_blob_db_file_size;
|
2020-02-12 22:44:46 +00:00
|
|
|
blob_db_options.compression = FLAGS_blob_db_compression_type_e;
|
2017-10-19 17:48:47 +00:00
|
|
|
blob_db::BlobDB* ptr = nullptr;
|
2017-08-01 19:48:22 +00:00
|
|
|
s = blob_db::BlobDB::Open(options, blob_db_options, db_name, &ptr);
|
2017-05-10 21:54:35 +00:00
|
|
|
if (s.ok()) {
|
|
|
|
db->db = ptr;
|
|
|
|
}
|
2019-05-31 02:29:34 +00:00
|
|
|
} else if (FLAGS_use_secondary_db) {
|
|
|
|
if (FLAGS_secondary_path.empty()) {
|
|
|
|
std::string default_secondary_path;
|
|
|
|
FLAGS_env->GetTestDirectory(&default_secondary_path);
|
|
|
|
default_secondary_path += "/dbbench_secondary";
|
|
|
|
FLAGS_secondary_path = default_secondary_path;
|
|
|
|
}
|
|
|
|
s = DB::OpenAsSecondary(options, db_name, FLAGS_secondary_path, &db->db);
|
|
|
|
if (s.ok() && FLAGS_secondary_update_interval > 0) {
|
|
|
|
secondary_update_thread_.reset(new port::Thread(
|
|
|
|
[this](int interval, DBWithColumnFamilies* _db) {
|
|
|
|
while (0 == secondary_update_stopped_.load(
|
|
|
|
std::memory_order_relaxed)) {
|
|
|
|
Status secondary_update_status =
|
|
|
|
_db->db->TryCatchUpWithPrimary();
|
|
|
|
if (!secondary_update_status.ok()) {
|
|
|
|
fprintf(stderr, "Failed to catch up with primary: %s\n",
|
|
|
|
secondary_update_status.ToString().c_str());
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
++secondary_db_updates_;
|
|
|
|
FLAGS_env->SleepForMicroseconds(interval * 1000000);
|
|
|
|
}
|
|
|
|
},
|
|
|
|
FLAGS_secondary_update_interval, db));
|
|
|
|
}
|
2017-05-10 21:54:35 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2012-11-06 03:18:49 +00:00
|
|
|
} else {
|
2014-08-19 01:15:01 +00:00
|
|
|
s = DB::Open(options, db_name, &db->db);
|
2012-11-06 03:18:49 +00:00
|
|
|
}
|
2021-07-02 01:41:20 +00:00
|
|
|
if (FLAGS_report_open_timing) {
|
|
|
|
std::cout << "OpenDb: "
|
|
|
|
<< (FLAGS_env->NowNanos() - open_start) / 1000000.0
|
|
|
|
<< " milliseconds\n";
|
|
|
|
}
|
2011-03-22 18:32:49 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "open error: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2013-06-14 23:17:56 +00:00
|
|
|
enum WriteMode {
|
|
|
|
RANDOM, SEQUENTIAL, UNIQUE_RANDOM
|
|
|
|
};
|
|
|
|
|
2016-10-18 23:30:57 +00:00
|
|
|
void WriteSeqDeterministic(ThreadState* thread) {
|
|
|
|
DoDeterministicCompact(thread, open_options_.compaction_style, SEQUENTIAL);
|
|
|
|
}
|
|
|
|
|
|
|
|
void WriteUniqueRandomDeterministic(ThreadState* thread) {
|
|
|
|
DoDeterministicCompact(thread, open_options_.compaction_style,
|
|
|
|
UNIQUE_RANDOM);
|
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void WriteSeq(ThreadState* thread) {
|
2013-06-14 23:17:56 +00:00
|
|
|
DoWrite(thread, SEQUENTIAL);
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
2011-03-22 18:32:49 +00:00
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void WriteRandom(ThreadState* thread) {
|
2013-06-14 23:17:56 +00:00
|
|
|
DoWrite(thread, RANDOM);
|
2011-08-22 21:08:51 +00:00
|
|
|
}
|
|
|
|
|
2013-06-14 23:17:56 +00:00
|
|
|
void WriteUniqueRandom(ThreadState* thread) {
|
|
|
|
DoWrite(thread, UNIQUE_RANDOM);
|
|
|
|
}
|
|
|
|
|
2014-04-09 18:25:21 +00:00
|
|
|
class KeyGenerator {
|
|
|
|
public:
|
2018-03-05 21:08:17 +00:00
|
|
|
KeyGenerator(Random64* rand, WriteMode mode, uint64_t num,
|
|
|
|
uint64_t /*num_per_set*/ = 64 * 1024)
|
|
|
|
: rand_(rand), mode_(mode), num_(num), next_(0) {
|
2014-04-09 18:25:21 +00:00
|
|
|
if (mode_ == UNIQUE_RANDOM) {
|
|
|
|
// NOTE: if memory consumption of this approach becomes a concern,
|
|
|
|
// we can either break it into pieces and only random shuffle a section
|
|
|
|
// each time. Alternatively, use a bit map implementation
|
|
|
|
// (https://reviews.facebook.net/differential/diff/54627/)
|
|
|
|
values_.resize(num_);
|
|
|
|
for (uint64_t i = 0; i < num_; ++i) {
|
|
|
|
values_[i] = i;
|
|
|
|
}
|
2020-04-20 20:21:34 +00:00
|
|
|
RandomShuffle(values_.begin(), values_.end(),
|
2022-03-25 17:12:27 +00:00
|
|
|
static_cast<uint32_t>(seed_base));
|
2014-04-09 18:25:21 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
uint64_t Next() {
|
|
|
|
switch (mode_) {
|
|
|
|
case SEQUENTIAL:
|
|
|
|
return next_++;
|
|
|
|
case RANDOM:
|
|
|
|
return rand_->Next() % num_;
|
|
|
|
case UNIQUE_RANDOM:
|
2018-01-29 19:30:37 +00:00
|
|
|
assert(next_ < num_);
|
2014-04-09 18:25:21 +00:00
|
|
|
return values_[next_++];
|
|
|
|
}
|
|
|
|
assert(false);
|
|
|
|
return std::numeric_limits<uint64_t>::max();
|
|
|
|
}
|
|
|
|
|
2021-07-29 21:57:03 +00:00
|
|
|
// Only available for UNIQUE_RANDOM mode.
|
|
|
|
uint64_t Fetch(uint64_t index) {
|
|
|
|
assert(mode_ == UNIQUE_RANDOM);
|
|
|
|
assert(index < values_.size());
|
|
|
|
return values_[index];
|
|
|
|
}
|
|
|
|
|
2014-04-09 18:25:21 +00:00
|
|
|
private:
|
|
|
|
Random64* rand_;
|
|
|
|
WriteMode mode_;
|
|
|
|
const uint64_t num_;
|
|
|
|
uint64_t next_;
|
|
|
|
std::vector<uint64_t> values_;
|
|
|
|
};
|
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* SelectDB(ThreadState* thread) {
|
2014-08-19 01:15:01 +00:00
|
|
|
return SelectDBWithCfh(thread)->db;
|
|
|
|
}
|
|
|
|
|
|
|
|
DBWithColumnFamilies* SelectDBWithCfh(ThreadState* thread) {
|
|
|
|
return SelectDBWithCfh(thread->rand.Next());
|
|
|
|
}
|
|
|
|
|
|
|
|
DBWithColumnFamilies* SelectDBWithCfh(uint64_t rand_int) {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
return &db_;
|
|
|
|
} else {
|
|
|
|
return &multi_dbs_[rand_int % multi_dbs_.size()];
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
}
|
2014-04-09 18:25:21 +00:00
|
|
|
|
2018-06-15 19:07:38 +00:00
|
|
|
double SineRate(double x) {
|
|
|
|
return FLAGS_sine_a*sin((FLAGS_sine_b*x) + FLAGS_sine_c) + FLAGS_sine_d;
|
|
|
|
}
|
|
|
|
|
2013-06-14 23:17:56 +00:00
|
|
|
void DoWrite(ThreadState* thread, WriteMode write_mode) {
|
|
|
|
const int test_duration = write_mode == RANDOM ? FLAGS_duration : 0;
|
2014-03-05 18:27:17 +00:00
|
|
|
const int64_t num_ops = writes_ == 0 ? num_ : writes_;
|
2013-06-14 23:17:56 +00:00
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
size_t num_key_gens = 1;
|
2014-08-19 01:15:01 +00:00
|
|
|
if (db_.db == nullptr) {
|
2014-04-11 19:15:09 +00:00
|
|
|
num_key_gens = multi_dbs_.size();
|
|
|
|
}
|
|
|
|
std::vector<std::unique_ptr<KeyGenerator>> key_gens(num_key_gens);
|
2014-12-23 02:39:28 +00:00
|
|
|
int64_t max_ops = num_ops * num_key_gens;
|
|
|
|
int64_t ops_per_stage = max_ops;
|
|
|
|
if (FLAGS_num_column_families > 1 && FLAGS_num_hot_column_families > 0) {
|
|
|
|
ops_per_stage = (max_ops - 1) / (FLAGS_num_column_families /
|
|
|
|
FLAGS_num_hot_column_families) +
|
|
|
|
1;
|
|
|
|
}
|
|
|
|
|
|
|
|
Duration duration(test_duration, max_ops, ops_per_stage);
|
2021-09-30 21:16:23 +00:00
|
|
|
const uint64_t num_per_key_gen = num_ + max_num_range_tombstones_;
|
2014-04-11 19:15:09 +00:00
|
|
|
for (size_t i = 0; i < num_key_gens; i++) {
|
2018-09-19 23:26:50 +00:00
|
|
|
key_gens[i].reset(new KeyGenerator(&(thread->rand), write_mode,
|
2021-09-30 21:16:23 +00:00
|
|
|
num_per_key_gen, ops_per_stage));
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
2013-03-01 19:25:13 +00:00
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
if (num_ != FLAGS_num) {
|
2011-03-22 18:32:49 +00:00
|
|
|
char msg[100];
|
2014-03-05 01:08:05 +00:00
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " ops)", num_);
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
2011-03-22 18:32:49 +00:00
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
RandomGenerator gen;
|
2020-09-16 03:04:58 +00:00
|
|
|
WriteBatch batch(/*reserved_bytes=*/0, /*max_bytes=*/0,
|
2022-06-15 20:43:58 +00:00
|
|
|
FLAGS_write_batch_protection_bytes_per_key,
|
|
|
|
user_timestamp_size_);
|
2011-03-18 22:37:00 +00:00
|
|
|
Status s;
|
2011-08-22 21:08:51 +00:00
|
|
|
int64_t bytes = 0;
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2016-11-16 01:33:27 +00:00
|
|
|
std::unique_ptr<const char[]> begin_key_guard;
|
|
|
|
Slice begin_key = AllocateKey(&begin_key_guard);
|
|
|
|
std::unique_ptr<const char[]> end_key_guard;
|
|
|
|
Slice end_key = AllocateKey(&end_key_guard);
|
2021-07-21 18:32:36 +00:00
|
|
|
double p = 0.0;
|
2021-07-29 21:57:03 +00:00
|
|
|
uint64_t num_overwrites = 0, num_unique_keys = 0, num_selective_deletes = 0;
|
2021-07-21 18:32:36 +00:00
|
|
|
// If user set overwrite_probability flag,
|
|
|
|
// check if value is in [0.0,1.0].
|
|
|
|
if (FLAGS_overwrite_probability > 0.0) {
|
|
|
|
p = FLAGS_overwrite_probability > 1.0 ? 1.0 : FLAGS_overwrite_probability;
|
|
|
|
// If overwrite set by user, and UNIQUE_RANDOM mode on,
|
|
|
|
// the overwrite_window_size must be > 0.
|
|
|
|
if (write_mode == UNIQUE_RANDOM && FLAGS_overwrite_window_size == 0) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Overwrite_window_size must be strictly greater than 0.\n");
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Default_random_engine provides slightly
|
|
|
|
// improved throughput over mt19937.
|
|
|
|
std::default_random_engine overwrite_gen{
|
2022-03-25 17:12:27 +00:00
|
|
|
static_cast<unsigned int>(seed_base)};
|
2021-07-21 18:32:36 +00:00
|
|
|
std::bernoulli_distribution overwrite_decider(p);
|
|
|
|
|
|
|
|
// Inserted key window is filled with the last N
|
|
|
|
// keys previously inserted into the DB (with
|
|
|
|
// N=FLAGS_overwrite_window_size).
|
|
|
|
// We use a deque struct because:
|
|
|
|
// - random access is O(1)
|
|
|
|
// - insertion/removal at beginning/end is also O(1).
|
|
|
|
std::deque<int64_t> inserted_key_window;
|
2022-03-25 17:12:27 +00:00
|
|
|
Random64 reservoir_id_gen(seed_base);
|
2021-07-21 18:32:36 +00:00
|
|
|
|
2021-07-29 21:57:03 +00:00
|
|
|
// --- Variables used in disposable/persistent keys simulation:
|
|
|
|
// The following variables are used when
|
|
|
|
// disposable_entries_batch_size is >0. We simualte a workload
|
|
|
|
// where the following sequence is repeated multiple times:
|
|
|
|
// "A set of keys S1 is inserted ('disposable entries'), then after
|
|
|
|
// some delay another set of keys S2 is inserted ('persistent entries')
|
|
|
|
// and the first set of keys S1 is deleted. S2 artificially represents
|
|
|
|
// the insertion of hypothetical results from some undefined computation
|
|
|
|
// done on the first set of keys S1. The next sequence can start as soon
|
|
|
|
// as the last disposable entry in the set S1 of this sequence is
|
|
|
|
// inserted, if the delay is non negligible"
|
|
|
|
bool skip_for_loop = false, is_disposable_entry = true;
|
|
|
|
std::vector<uint64_t> disposable_entries_index(num_key_gens, 0);
|
|
|
|
std::vector<uint64_t> persistent_ent_and_del_index(num_key_gens, 0);
|
|
|
|
const uint64_t kNumDispAndPersEntries =
|
|
|
|
FLAGS_disposable_entries_batch_size +
|
|
|
|
FLAGS_persistent_entries_batch_size;
|
|
|
|
if (kNumDispAndPersEntries > 0) {
|
|
|
|
if ((write_mode != UNIQUE_RANDOM) || (writes_per_range_tombstone_ > 0) ||
|
|
|
|
(p > 0.0)) {
|
|
|
|
fprintf(
|
|
|
|
stderr,
|
|
|
|
"Disposable/persistent deletes are not compatible with overwrites "
|
|
|
|
"and DeleteRanges; and are only supported in filluniquerandom.\n");
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
if (FLAGS_disposable_entries_value_size < 0 ||
|
|
|
|
FLAGS_persistent_entries_value_size < 0) {
|
|
|
|
fprintf(
|
|
|
|
stderr,
|
|
|
|
"disposable_entries_value_size and persistent_entries_value_size"
|
|
|
|
"have to be positive.\n");
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
2022-03-25 17:12:27 +00:00
|
|
|
Random rnd_disposable_entry(static_cast<uint32_t>(seed_base));
|
2021-07-29 21:57:03 +00:00
|
|
|
std::string random_value;
|
|
|
|
// Queue that stores scheduled timestamp of disposable entries deletes,
|
|
|
|
// along with starting index of disposable entry keys to delete.
|
|
|
|
std::vector<std::queue<std::pair<uint64_t, uint64_t>>> disposable_entries_q(
|
|
|
|
num_key_gens);
|
|
|
|
// --- End of variables used in disposable/persistent keys simulation.
|
|
|
|
|
2016-12-07 02:02:43 +00:00
|
|
|
std::vector<std::unique_ptr<const char[]>> expanded_key_guards;
|
|
|
|
std::vector<Slice> expanded_keys;
|
|
|
|
if (FLAGS_expand_range_tombstones) {
|
|
|
|
expanded_key_guards.resize(range_tombstone_width_);
|
|
|
|
for (auto& expanded_key_guard : expanded_key_guards) {
|
|
|
|
expanded_keys.emplace_back(AllocateKey(&expanded_key_guard));
|
|
|
|
}
|
|
|
|
}
|
2016-11-16 01:33:27 +00:00
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
|
|
|
|
2014-12-23 02:39:28 +00:00
|
|
|
int64_t stage = 0;
|
2016-11-16 01:33:27 +00:00
|
|
|
int64_t num_written = 0;
|
2022-03-22 17:36:24 +00:00
|
|
|
int64_t next_seq_db_at = num_ops;
|
|
|
|
size_t id = 0;
|
2022-08-05 19:02:33 +00:00
|
|
|
int64_t num_range_deletions = 0;
|
2022-03-22 17:36:24 +00:00
|
|
|
|
2021-09-30 21:16:23 +00:00
|
|
|
while ((num_per_key_gen != 0) && !duration.Done(entries_per_batch_)) {
|
2014-12-23 02:39:28 +00:00
|
|
|
if (duration.GetStage() != stage) {
|
|
|
|
stage = duration.GetStage();
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
db_.CreateNewCf(open_options_, stage);
|
|
|
|
} else {
|
|
|
|
for (auto& db : multi_dbs_) {
|
|
|
|
db.CreateNewCf(open_options_, stage);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2016-01-04 20:01:27 +00:00
|
|
|
|
2022-03-22 17:36:24 +00:00
|
|
|
if (write_mode != SEQUENTIAL) {
|
|
|
|
id = thread->rand.Next() % num_key_gens;
|
|
|
|
} else {
|
|
|
|
// When doing a sequential load with multiple databases, load them in
|
|
|
|
// order rather than all at the same time to avoid:
|
|
|
|
// 1) long delays between flushing memtables
|
|
|
|
// 2) flushing memtables for all of them at the same point in time
|
|
|
|
// 3) not putting the same number of keys in each database
|
|
|
|
if (num_written >= next_seq_db_at) {
|
|
|
|
next_seq_db_at += num_ops;
|
|
|
|
id++;
|
|
|
|
if (id >= num_key_gens) {
|
|
|
|
fprintf(stderr, "Logic error. Filled all databases\n");
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2014-08-19 01:15:01 +00:00
|
|
|
DBWithColumnFamilies* db_with_cfh = SelectDBWithCfh(id);
|
2022-03-22 17:36:24 +00:00
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
batch.Clear();
|
2020-02-12 22:44:46 +00:00
|
|
|
int64_t batch_bytes = 0;
|
2016-01-04 20:01:27 +00:00
|
|
|
|
2014-04-08 18:21:09 +00:00
|
|
|
for (int64_t j = 0; j < entries_per_batch_; j++) {
|
2021-07-21 18:32:36 +00:00
|
|
|
int64_t rand_num = 0;
|
|
|
|
if ((write_mode == UNIQUE_RANDOM) && (p > 0.0)) {
|
|
|
|
if ((inserted_key_window.size() > 0) &&
|
|
|
|
overwrite_decider(overwrite_gen)) {
|
|
|
|
num_overwrites++;
|
|
|
|
rand_num = inserted_key_window[reservoir_id_gen.Next() %
|
|
|
|
inserted_key_window.size()];
|
|
|
|
} else {
|
|
|
|
num_unique_keys++;
|
|
|
|
rand_num = key_gens[id]->Next();
|
|
|
|
if (inserted_key_window.size() < FLAGS_overwrite_window_size) {
|
|
|
|
inserted_key_window.push_back(rand_num);
|
|
|
|
} else {
|
|
|
|
inserted_key_window.pop_front();
|
|
|
|
inserted_key_window.push_back(rand_num);
|
|
|
|
}
|
|
|
|
}
|
2021-07-29 21:57:03 +00:00
|
|
|
} else if (kNumDispAndPersEntries > 0) {
|
|
|
|
// Check if queue is non-empty and if we need to insert
|
|
|
|
// 'persistent' KV entries (KV entries that are never deleted)
|
|
|
|
// and delete disposable entries previously inserted.
|
|
|
|
if (!disposable_entries_q[id].empty() &&
|
|
|
|
(disposable_entries_q[id].front().first <
|
|
|
|
FLAGS_env->NowMicros())) {
|
|
|
|
// If we need to perform a "merge op" pattern,
|
|
|
|
// we first write all the persistent KV entries not targeted
|
|
|
|
// by deletes, and then we write the disposable entries deletes.
|
|
|
|
if (persistent_ent_and_del_index[id] <
|
|
|
|
FLAGS_persistent_entries_batch_size) {
|
|
|
|
// Generate key to insert.
|
|
|
|
rand_num =
|
|
|
|
key_gens[id]->Fetch(disposable_entries_q[id].front().second +
|
|
|
|
FLAGS_disposable_entries_batch_size +
|
|
|
|
persistent_ent_and_del_index[id]);
|
|
|
|
persistent_ent_and_del_index[id]++;
|
|
|
|
is_disposable_entry = false;
|
|
|
|
skip_for_loop = false;
|
|
|
|
} else if (persistent_ent_and_del_index[id] <
|
|
|
|
kNumDispAndPersEntries) {
|
|
|
|
// Find key of the entry to delete.
|
|
|
|
rand_num =
|
|
|
|
key_gens[id]->Fetch(disposable_entries_q[id].front().second +
|
|
|
|
(persistent_ent_and_del_index[id] -
|
|
|
|
FLAGS_persistent_entries_batch_size));
|
|
|
|
persistent_ent_and_del_index[id]++;
|
|
|
|
GenerateKeyFromInt(rand_num, FLAGS_num, &key);
|
|
|
|
// For the delete operation, everything happens here and we
|
|
|
|
// skip the rest of the for-loop, which is designed for
|
|
|
|
// inserts.
|
|
|
|
if (FLAGS_num_column_families <= 1) {
|
|
|
|
batch.Delete(key);
|
|
|
|
} else {
|
|
|
|
// We use same rand_num as seed for key and column family so
|
|
|
|
// that we can deterministically find the cfh corresponding to a
|
|
|
|
// particular key while reading the key.
|
|
|
|
batch.Delete(db_with_cfh->GetCfh(rand_num), key);
|
|
|
|
}
|
|
|
|
// A delete only includes Key+Timestamp (no value).
|
|
|
|
batch_bytes += key_size_ + user_timestamp_size_;
|
|
|
|
bytes += key_size_ + user_timestamp_size_;
|
|
|
|
num_selective_deletes++;
|
|
|
|
// Skip rest of the for-loop (j=0, j<entries_per_batch_,j++).
|
|
|
|
skip_for_loop = true;
|
|
|
|
} else {
|
|
|
|
assert(false); // should never reach this point.
|
|
|
|
}
|
|
|
|
// If disposable_entries_q needs to be updated (ie: when a selective
|
|
|
|
// insert+delete was successfully completed, pop the job out of the
|
|
|
|
// queue).
|
|
|
|
if (!disposable_entries_q[id].empty() &&
|
|
|
|
(disposable_entries_q[id].front().first <
|
|
|
|
FLAGS_env->NowMicros()) &&
|
|
|
|
persistent_ent_and_del_index[id] == kNumDispAndPersEntries) {
|
|
|
|
disposable_entries_q[id].pop();
|
|
|
|
persistent_ent_and_del_index[id] = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
// If we are deleting disposable entries, skip the rest of the
|
|
|
|
// for-loop since there is no key-value inserts at this moment in
|
|
|
|
// time.
|
|
|
|
if (skip_for_loop) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
// If no job is in the queue, then we keep inserting disposable KV
|
|
|
|
// entries that will be deleted later by a series of deletes.
|
|
|
|
else {
|
|
|
|
rand_num = key_gens[id]->Fetch(disposable_entries_index[id]);
|
|
|
|
disposable_entries_index[id]++;
|
|
|
|
is_disposable_entry = true;
|
|
|
|
if ((disposable_entries_index[id] %
|
|
|
|
FLAGS_disposable_entries_batch_size) == 0) {
|
|
|
|
// Skip the persistent KV entries inserts for now
|
|
|
|
disposable_entries_index[id] +=
|
|
|
|
FLAGS_persistent_entries_batch_size;
|
|
|
|
}
|
|
|
|
}
|
2021-07-21 18:32:36 +00:00
|
|
|
} else {
|
|
|
|
rand_num = key_gens[id]->Next();
|
|
|
|
}
|
2014-08-19 01:15:01 +00:00
|
|
|
GenerateKeyFromInt(rand_num, FLAGS_num, &key);
|
2021-07-29 21:57:03 +00:00
|
|
|
Slice val;
|
|
|
|
if (kNumDispAndPersEntries > 0) {
|
|
|
|
random_value = rnd_disposable_entry.RandomString(
|
|
|
|
is_disposable_entry ? FLAGS_disposable_entries_value_size
|
|
|
|
: FLAGS_persistent_entries_value_size);
|
|
|
|
val = Slice(random_value);
|
|
|
|
num_unique_keys++;
|
|
|
|
} else {
|
|
|
|
val = gen.Generate();
|
|
|
|
}
|
2017-05-25 21:08:16 +00:00
|
|
|
if (use_blob_db_) {
|
|
|
|
#ifndef ROCKSDB_LITE
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB
|
2017-05-10 21:54:35 +00:00
|
|
|
blob_db::BlobDB* blobdb =
|
|
|
|
static_cast<blob_db::BlobDB*>(db_with_cfh->db);
|
2019-10-15 00:47:56 +00:00
|
|
|
if (FLAGS_blob_db_max_ttl_range > 0) {
|
|
|
|
int ttl = rand() % FLAGS_blob_db_max_ttl_range;
|
|
|
|
s = blobdb->PutWithTTL(write_options_, key, val, ttl);
|
|
|
|
} else {
|
|
|
|
s = blobdb->Put(write_options_, key, val);
|
|
|
|
}
|
2017-05-25 21:08:16 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2016-08-09 17:16:32 +00:00
|
|
|
} else if (FLAGS_num_column_families <= 1) {
|
2020-02-12 22:44:46 +00:00
|
|
|
batch.Put(key, val);
|
2014-08-19 01:15:01 +00:00
|
|
|
} else {
|
|
|
|
// We use same rand_num as seed for key and column family so that we
|
|
|
|
// can deterministically find the cfh corresponding to a particular
|
|
|
|
// key while reading the key.
|
2014-12-23 02:39:28 +00:00
|
|
|
batch.Put(db_with_cfh->GetCfh(rand_num), key,
|
2020-02-12 22:44:46 +00:00
|
|
|
val);
|
2014-08-19 01:15:01 +00:00
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
batch_bytes += val.size() + key_size_ + user_timestamp_size_;
|
|
|
|
bytes += val.size() + key_size_ + user_timestamp_size_;
|
2016-11-16 01:33:27 +00:00
|
|
|
++num_written;
|
2021-07-29 21:57:03 +00:00
|
|
|
|
|
|
|
// If all disposable entries have been inserted, then we need to
|
|
|
|
// add in the job queue a call for 'persistent entry insertions +
|
|
|
|
// disposable entry deletions'.
|
|
|
|
if (kNumDispAndPersEntries > 0 && is_disposable_entry &&
|
|
|
|
((disposable_entries_index[id] % kNumDispAndPersEntries) == 0)) {
|
|
|
|
// Queue contains [timestamp, starting_idx],
|
|
|
|
// timestamp = current_time + delay (minimum aboslute time when to
|
|
|
|
// start inserting the selective deletes) starting_idx = index in the
|
|
|
|
// keygen of the rand_num to generate the key of the first KV entry to
|
|
|
|
// delete (= key of the first selective delete).
|
|
|
|
disposable_entries_q[id].push(std::make_pair(
|
|
|
|
FLAGS_env->NowMicros() +
|
|
|
|
FLAGS_disposable_entries_delete_delay /* timestamp */,
|
|
|
|
disposable_entries_index[id] - kNumDispAndPersEntries
|
|
|
|
/*starting idx*/));
|
|
|
|
}
|
2016-11-16 01:33:27 +00:00
|
|
|
if (writes_per_range_tombstone_ > 0 &&
|
2018-10-19 00:16:36 +00:00
|
|
|
num_written > writes_before_delete_range_ &&
|
|
|
|
(num_written - writes_before_delete_range_) /
|
|
|
|
writes_per_range_tombstone_ <=
|
2016-11-16 01:33:27 +00:00
|
|
|
max_num_range_tombstones_ &&
|
2018-10-19 00:16:36 +00:00
|
|
|
(num_written - writes_before_delete_range_) %
|
|
|
|
writes_per_range_tombstone_ ==
|
|
|
|
0) {
|
2022-08-05 19:02:33 +00:00
|
|
|
num_range_deletions++;
|
2016-11-16 01:33:27 +00:00
|
|
|
int64_t begin_num = key_gens[id]->Next();
|
2016-12-07 02:02:43 +00:00
|
|
|
if (FLAGS_expand_range_tombstones) {
|
|
|
|
for (int64_t offset = 0; offset < range_tombstone_width_;
|
|
|
|
++offset) {
|
|
|
|
GenerateKeyFromInt(begin_num + offset, FLAGS_num,
|
|
|
|
&expanded_keys[offset]);
|
2017-05-25 21:08:16 +00:00
|
|
|
if (use_blob_db_) {
|
|
|
|
#ifndef ROCKSDB_LITE
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB
|
2016-12-07 02:02:43 +00:00
|
|
|
s = db_with_cfh->db->Delete(write_options_,
|
|
|
|
expanded_keys[offset]);
|
2017-05-25 21:08:16 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2016-12-07 02:02:43 +00:00
|
|
|
} else if (FLAGS_num_column_families <= 1) {
|
|
|
|
batch.Delete(expanded_keys[offset]);
|
|
|
|
} else {
|
|
|
|
batch.Delete(db_with_cfh->GetCfh(rand_num),
|
|
|
|
expanded_keys[offset]);
|
|
|
|
}
|
|
|
|
}
|
2016-11-16 01:33:27 +00:00
|
|
|
} else {
|
2016-12-07 02:02:43 +00:00
|
|
|
GenerateKeyFromInt(begin_num, FLAGS_num, &begin_key);
|
|
|
|
GenerateKeyFromInt(begin_num + range_tombstone_width_, FLAGS_num,
|
|
|
|
&end_key);
|
2017-05-25 21:08:16 +00:00
|
|
|
if (use_blob_db_) {
|
|
|
|
#ifndef ROCKSDB_LITE
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB
|
2016-12-07 02:02:43 +00:00
|
|
|
s = db_with_cfh->db->DeleteRange(
|
|
|
|
write_options_, db_with_cfh->db->DefaultColumnFamily(),
|
|
|
|
begin_key, end_key);
|
2017-05-25 21:08:16 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2016-12-07 02:02:43 +00:00
|
|
|
} else if (FLAGS_num_column_families <= 1) {
|
|
|
|
batch.DeleteRange(begin_key, end_key);
|
|
|
|
} else {
|
|
|
|
batch.DeleteRange(db_with_cfh->GetCfh(rand_num), begin_key,
|
|
|
|
end_key);
|
|
|
|
}
|
2016-11-16 01:33:27 +00:00
|
|
|
}
|
|
|
|
}
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
2020-02-12 22:44:46 +00:00
|
|
|
if (thread->shared->write_rate_limiter.get() != nullptr) {
|
|
|
|
thread->shared->write_rate_limiter->Request(
|
|
|
|
batch_bytes, Env::IO_HIGH,
|
|
|
|
nullptr /* stats */, RateLimiter::OpType::kWrite);
|
|
|
|
// Set time at which last op finished to Now() to hide latency and
|
|
|
|
// sleep from rate limiter. Also, do the check once per batch, not
|
|
|
|
// once per write.
|
|
|
|
thread->stats.ResetLastOpTime();
|
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
Slice user_ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = batch.UpdateTimestamps(
|
|
|
|
user_ts, [this](uint32_t) { return user_timestamp_size_; });
|
2020-09-16 03:04:58 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "assign timestamp to write batch: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
2017-05-25 21:08:16 +00:00
|
|
|
if (!use_blob_db_) {
|
2021-02-17 19:08:12 +00:00
|
|
|
// Not stacked BlobDB
|
2016-08-09 17:16:32 +00:00
|
|
|
s = db_with_cfh->db->Write(write_options_, &batch);
|
|
|
|
}
|
2014-09-29 16:50:41 +00:00
|
|
|
thread->stats.FinishedOps(db_with_cfh, db_with_cfh->db,
|
2015-12-08 01:33:18 +00:00
|
|
|
entries_per_batch_, kWrite);
|
2018-06-15 19:07:38 +00:00
|
|
|
if (FLAGS_sine_write_rate) {
|
|
|
|
uint64_t now = FLAGS_env->NowMicros();
|
|
|
|
|
|
|
|
uint64_t usecs_since_last;
|
|
|
|
if (now > thread->stats.GetSineInterval()) {
|
|
|
|
usecs_since_last = now - thread->stats.GetSineInterval();
|
|
|
|
} else {
|
|
|
|
usecs_since_last = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (usecs_since_last >
|
|
|
|
(FLAGS_sine_write_rate_interval_milliseconds * uint64_t{1000})) {
|
|
|
|
double usecs_since_start =
|
|
|
|
static_cast<double>(now - thread->stats.GetStart());
|
|
|
|
thread->stats.ResetSineInterval();
|
|
|
|
uint64_t write_rate =
|
|
|
|
static_cast<uint64_t>(SineRate(usecs_since_start / 1000000.0));
|
|
|
|
thread->shared->write_rate_limiter.reset(
|
|
|
|
NewGenericRateLimiter(write_rate));
|
|
|
|
}
|
|
|
|
}
|
Auto recovery from out of space errors (#4164)
Summary:
This commit implements automatic recovery from a Status::NoSpace() error
during background operations such as write callback, flush and
compaction. The broad design is as follows -
1. Compaction errors are treated as soft errors and don't put the
database in read-only mode. A compaction is delayed until enough free
disk space is available to accomodate the compaction outputs, which is
estimated based on the input size. This means that users can continue to
write, and we rely on the WriteController to delay or stop writes if the
compaction debt becomes too high due to persistent low disk space
condition
2. Errors during write callback and flush are treated as hard errors,
i.e the database is put in read-only mode and goes back to read-write
only fater certain recovery actions are taken.
3. Both types of recovery rely on the SstFileManagerImpl to poll for
sufficient disk space. We assume that there is a 1-1 mapping between an
SFM and the underlying OS storage container. For cases where multiple
DBs are hosted on a single storage container, the user is expected to
allocate a single SFM instance and use the same one for all the DBs. If
no SFM is specified by the user, DBImpl::Open() will allocate one, but
this will be one per DB and each DB will recover independently. The
recovery implemented by SFM is as follows -
a) On the first occurance of an out of space error during compaction,
subsequent
compactions will be delayed until the disk free space check indicates
enough available space. The required space is computed as the sum of
input sizes.
b) The free space check requirement will be removed once the amount of
free space is greater than the size reserved by in progress
compactions when the first error occured
c) If the out of space error is a hard error, a background thread in
SFM will poll for sufficient headroom before triggering the recovery
of the database and putting it in write-only mode. The headroom is
calculated as the sum of the write_buffer_size of all the DB instances
associated with the SFM
4. EventListener callbacks will be called at the start and completion of
automatic recovery. Users can disable the auto recov ery in the start
callback, and later initiate it manually by calling DB::Resume()
Todo:
1. More extensive testing
2. Add disk full condition to db_stress (follow-on PR)
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4164
Differential Revision: D9846378
Pulled By: anand1976
fbshipit-source-id: 80ea875dbd7f00205e19c82215ff6e37da10da4a
2018-09-15 20:36:19 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
s = listener_->WaitForRecovery(600000000) ? Status::OK() : s;
|
|
|
|
}
|
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
}
|
2021-07-21 18:32:36 +00:00
|
|
|
if ((write_mode == UNIQUE_RANDOM) && (p > 0.0)) {
|
|
|
|
fprintf(stdout,
|
2021-07-29 21:57:03 +00:00
|
|
|
"Number of unique keys inserted: %" PRIu64
|
2021-07-21 18:32:36 +00:00
|
|
|
".\nNumber of overwrites: %" PRIu64 "\n",
|
|
|
|
num_unique_keys, num_overwrites);
|
2021-07-29 21:57:03 +00:00
|
|
|
} else if (kNumDispAndPersEntries > 0) {
|
|
|
|
fprintf(stdout,
|
|
|
|
"Number of unique keys inserted (disposable+persistent): %" PRIu64
|
|
|
|
".\nNumber of 'disposable entry delete': %" PRIu64 "\n",
|
|
|
|
num_written, num_selective_deletes);
|
2021-07-21 18:32:36 +00:00
|
|
|
}
|
2022-08-05 19:02:33 +00:00
|
|
|
if (num_range_deletions > 0) {
|
|
|
|
std::cout << "Number of range deletions: " << num_range_deletions
|
|
|
|
<< std::endl;
|
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
|
2016-10-18 23:30:57 +00:00
|
|
|
Status DoDeterministicCompact(ThreadState* thread,
|
|
|
|
CompactionStyle compaction_style,
|
|
|
|
WriteMode write_mode) {
|
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
ColumnFamilyMetaData meta;
|
|
|
|
std::vector<DB*> db_list;
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
db_list.push_back(db_.db);
|
|
|
|
} else {
|
|
|
|
for (auto& db : multi_dbs_) {
|
|
|
|
db_list.push_back(db.db);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
std::vector<Options> options_list;
|
|
|
|
for (auto db : db_list) {
|
|
|
|
options_list.push_back(db->GetOptions());
|
2017-03-24 23:58:51 +00:00
|
|
|
if (compaction_style != kCompactionStyleFIFO) {
|
|
|
|
db->SetOptions({{"disable_auto_compactions", "1"},
|
|
|
|
{"level0_slowdown_writes_trigger", "400000000"},
|
|
|
|
{"level0_stop_writes_trigger", "400000000"}});
|
|
|
|
} else {
|
|
|
|
db->SetOptions({{"disable_auto_compactions", "1"}});
|
|
|
|
}
|
2016-10-18 23:30:57 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
assert(!db_list.empty());
|
|
|
|
auto num_db = db_list.size();
|
|
|
|
size_t num_levels = static_cast<size_t>(open_options_.num_levels);
|
|
|
|
size_t output_level = open_options_.num_levels - 1;
|
|
|
|
std::vector<std::vector<std::vector<SstFileMetaData>>> sorted_runs(num_db);
|
|
|
|
std::vector<size_t> num_files_at_level0(num_db, 0);
|
|
|
|
if (compaction_style == kCompactionStyleLevel) {
|
|
|
|
if (num_levels == 0) {
|
|
|
|
return Status::InvalidArgument("num_levels should be larger than 1");
|
|
|
|
}
|
|
|
|
bool should_stop = false;
|
|
|
|
while (!should_stop) {
|
|
|
|
if (sorted_runs[0].empty()) {
|
|
|
|
DoWrite(thread, write_mode);
|
|
|
|
} else {
|
|
|
|
DoWrite(thread, UNIQUE_RANDOM);
|
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
auto db = db_list[i];
|
|
|
|
db->Flush(FlushOptions());
|
|
|
|
db->GetColumnFamilyMetaData(&meta);
|
|
|
|
if (num_files_at_level0[i] == meta.levels[0].files.size() ||
|
|
|
|
writes_ == 0) {
|
|
|
|
should_stop = true;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
sorted_runs[i].emplace_back(
|
|
|
|
meta.levels[0].files.begin(),
|
|
|
|
meta.levels[0].files.end() - num_files_at_level0[i]);
|
|
|
|
num_files_at_level0[i] = meta.levels[0].files.size();
|
|
|
|
if (sorted_runs[i].back().size() == 1) {
|
|
|
|
should_stop = true;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
if (sorted_runs[i].size() == output_level) {
|
|
|
|
auto& L1 = sorted_runs[i].back();
|
|
|
|
L1.erase(L1.begin(), L1.begin() + L1.size() / 3);
|
|
|
|
should_stop = true;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
}
|
2017-01-06 22:42:18 +00:00
|
|
|
writes_ /= static_cast<int64_t>(open_options_.max_bytes_for_level_multiplier);
|
2016-10-18 23:30:57 +00:00
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
if (sorted_runs[i].size() < num_levels - 1) {
|
2017-01-06 22:42:18 +00:00
|
|
|
fprintf(stderr, "n is too small to fill %" ROCKSDB_PRIszt " levels\n", num_levels);
|
2016-10-18 23:30:57 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
auto db = db_list[i];
|
|
|
|
auto compactionOptions = CompactionOptions();
|
2018-04-17 00:56:59 +00:00
|
|
|
compactionOptions.compression = FLAGS_compression_type_e;
|
2016-10-18 23:30:57 +00:00
|
|
|
auto options = db->GetOptions();
|
|
|
|
MutableCFOptions mutable_cf_options(options);
|
|
|
|
for (size_t j = 0; j < sorted_runs[i].size(); j++) {
|
|
|
|
compactionOptions.output_file_size_limit =
|
2018-05-03 23:35:46 +00:00
|
|
|
MaxFileSizeForLevel(mutable_cf_options,
|
|
|
|
static_cast<int>(output_level), compaction_style);
|
2016-10-18 23:30:57 +00:00
|
|
|
std::cout << sorted_runs[i][j].size() << std::endl;
|
|
|
|
db->CompactFiles(compactionOptions, {sorted_runs[i][j].back().name,
|
|
|
|
sorted_runs[i][j].front().name},
|
|
|
|
static_cast<int>(output_level - j) /*level*/);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else if (compaction_style == kCompactionStyleUniversal) {
|
|
|
|
auto ratio = open_options_.compaction_options_universal.size_ratio;
|
|
|
|
bool should_stop = false;
|
|
|
|
while (!should_stop) {
|
|
|
|
if (sorted_runs[0].empty()) {
|
|
|
|
DoWrite(thread, write_mode);
|
|
|
|
} else {
|
|
|
|
DoWrite(thread, UNIQUE_RANDOM);
|
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
auto db = db_list[i];
|
|
|
|
db->Flush(FlushOptions());
|
|
|
|
db->GetColumnFamilyMetaData(&meta);
|
|
|
|
if (num_files_at_level0[i] == meta.levels[0].files.size() ||
|
|
|
|
writes_ == 0) {
|
|
|
|
should_stop = true;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
sorted_runs[i].emplace_back(
|
|
|
|
meta.levels[0].files.begin(),
|
|
|
|
meta.levels[0].files.end() - num_files_at_level0[i]);
|
|
|
|
num_files_at_level0[i] = meta.levels[0].files.size();
|
|
|
|
if (sorted_runs[i].back().size() == 1) {
|
|
|
|
should_stop = true;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
num_files_at_level0[i] = meta.levels[0].files.size();
|
|
|
|
}
|
2017-01-06 22:42:18 +00:00
|
|
|
writes_ = static_cast<int64_t>(writes_* static_cast<double>(100) / (ratio + 200));
|
2016-10-18 23:30:57 +00:00
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
if (sorted_runs[i].size() < num_levels) {
|
2017-01-06 22:42:18 +00:00
|
|
|
fprintf(stderr, "n is too small to fill %" ROCKSDB_PRIszt " levels\n", num_levels);
|
2016-10-18 23:30:57 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
auto db = db_list[i];
|
|
|
|
auto compactionOptions = CompactionOptions();
|
2018-04-17 00:56:59 +00:00
|
|
|
compactionOptions.compression = FLAGS_compression_type_e;
|
2016-10-18 23:30:57 +00:00
|
|
|
auto options = db->GetOptions();
|
|
|
|
MutableCFOptions mutable_cf_options(options);
|
|
|
|
for (size_t j = 0; j < sorted_runs[i].size(); j++) {
|
|
|
|
compactionOptions.output_file_size_limit =
|
2018-05-03 23:35:46 +00:00
|
|
|
MaxFileSizeForLevel(mutable_cf_options,
|
|
|
|
static_cast<int>(output_level), compaction_style);
|
2016-10-18 23:30:57 +00:00
|
|
|
db->CompactFiles(
|
|
|
|
compactionOptions,
|
|
|
|
{sorted_runs[i][j].back().name, sorted_runs[i][j].front().name},
|
|
|
|
(output_level > j ? static_cast<int>(output_level - j)
|
|
|
|
: 0) /*level*/);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else if (compaction_style == kCompactionStyleFIFO) {
|
2017-03-24 23:58:51 +00:00
|
|
|
if (num_levels != 1) {
|
|
|
|
return Status::InvalidArgument(
|
|
|
|
"num_levels should be 1 for FIFO compaction");
|
|
|
|
}
|
|
|
|
if (FLAGS_num_multi_db != 0) {
|
|
|
|
return Status::InvalidArgument("Doesn't support multiDB");
|
|
|
|
}
|
|
|
|
auto db = db_list[0];
|
|
|
|
std::vector<std::string> file_names;
|
|
|
|
while (true) {
|
|
|
|
if (sorted_runs[0].empty()) {
|
|
|
|
DoWrite(thread, write_mode);
|
|
|
|
} else {
|
|
|
|
DoWrite(thread, UNIQUE_RANDOM);
|
|
|
|
}
|
|
|
|
db->Flush(FlushOptions());
|
|
|
|
db->GetColumnFamilyMetaData(&meta);
|
|
|
|
auto total_size = meta.levels[0].size;
|
|
|
|
if (total_size >=
|
|
|
|
db->GetOptions().compaction_options_fifo.max_table_files_size) {
|
|
|
|
for (auto file_meta : meta.levels[0].files) {
|
|
|
|
file_names.emplace_back(file_meta.name);
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
// TODO(shuzhang1989): Investigate why CompactFiles not working
|
|
|
|
// auto compactionOptions = CompactionOptions();
|
|
|
|
// db->CompactFiles(compactionOptions, file_names, 0);
|
|
|
|
auto compactionOptions = CompactRangeOptions();
|
|
|
|
db->CompactRange(compactionOptions, nullptr, nullptr);
|
2016-10-18 23:30:57 +00:00
|
|
|
} else {
|
|
|
|
fprintf(stdout,
|
|
|
|
"%-12s : skipped (-compaction_stype=kCompactionStyleNone)\n",
|
|
|
|
"filldeterministic");
|
|
|
|
return Status::InvalidArgument("None compaction is not supported");
|
|
|
|
}
|
|
|
|
|
|
|
|
// Verify seqno and key range
|
|
|
|
// Note: the seqno get changed at the max level by implementation
|
|
|
|
// optimization, so skip the check of the max level.
|
|
|
|
#ifndef NDEBUG
|
|
|
|
for (size_t k = 0; k < num_db; k++) {
|
|
|
|
auto db = db_list[k];
|
|
|
|
db->GetColumnFamilyMetaData(&meta);
|
|
|
|
// verify the number of sorted runs
|
|
|
|
if (compaction_style == kCompactionStyleLevel) {
|
|
|
|
assert(num_levels - 1 == sorted_runs[k].size());
|
|
|
|
} else if (compaction_style == kCompactionStyleUniversal) {
|
|
|
|
assert(meta.levels[0].files.size() + num_levels - 1 ==
|
|
|
|
sorted_runs[k].size());
|
|
|
|
} else if (compaction_style == kCompactionStyleFIFO) {
|
|
|
|
// TODO(gzh): FIFO compaction
|
2017-03-24 23:58:51 +00:00
|
|
|
db->GetColumnFamilyMetaData(&meta);
|
|
|
|
auto total_size = meta.levels[0].size;
|
|
|
|
assert(total_size <=
|
|
|
|
db->GetOptions().compaction_options_fifo.max_table_files_size);
|
|
|
|
break;
|
2016-10-18 23:30:57 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// verify smallest/largest seqno and key range of each sorted run
|
|
|
|
auto max_level = num_levels - 1;
|
|
|
|
int level;
|
|
|
|
for (size_t i = 0; i < sorted_runs[k].size(); i++) {
|
|
|
|
level = static_cast<int>(max_level - i);
|
|
|
|
SequenceNumber sorted_run_smallest_seqno = kMaxSequenceNumber;
|
|
|
|
SequenceNumber sorted_run_largest_seqno = 0;
|
|
|
|
std::string sorted_run_smallest_key, sorted_run_largest_key;
|
|
|
|
bool first_key = true;
|
|
|
|
for (auto fileMeta : sorted_runs[k][i]) {
|
|
|
|
sorted_run_smallest_seqno =
|
|
|
|
std::min(sorted_run_smallest_seqno, fileMeta.smallest_seqno);
|
|
|
|
sorted_run_largest_seqno =
|
|
|
|
std::max(sorted_run_largest_seqno, fileMeta.largest_seqno);
|
|
|
|
if (first_key ||
|
|
|
|
db->DefaultColumnFamily()->GetComparator()->Compare(
|
|
|
|
fileMeta.smallestkey, sorted_run_smallest_key) < 0) {
|
|
|
|
sorted_run_smallest_key = fileMeta.smallestkey;
|
|
|
|
}
|
|
|
|
if (first_key ||
|
|
|
|
db->DefaultColumnFamily()->GetComparator()->Compare(
|
|
|
|
fileMeta.largestkey, sorted_run_largest_key) > 0) {
|
|
|
|
sorted_run_largest_key = fileMeta.largestkey;
|
|
|
|
}
|
|
|
|
first_key = false;
|
|
|
|
}
|
|
|
|
if (compaction_style == kCompactionStyleLevel ||
|
|
|
|
(compaction_style == kCompactionStyleUniversal && level > 0)) {
|
|
|
|
SequenceNumber level_smallest_seqno = kMaxSequenceNumber;
|
|
|
|
SequenceNumber level_largest_seqno = 0;
|
|
|
|
for (auto fileMeta : meta.levels[level].files) {
|
|
|
|
level_smallest_seqno =
|
|
|
|
std::min(level_smallest_seqno, fileMeta.smallest_seqno);
|
|
|
|
level_largest_seqno =
|
|
|
|
std::max(level_largest_seqno, fileMeta.largest_seqno);
|
|
|
|
}
|
|
|
|
assert(sorted_run_smallest_key ==
|
|
|
|
meta.levels[level].files.front().smallestkey);
|
|
|
|
assert(sorted_run_largest_key ==
|
|
|
|
meta.levels[level].files.back().largestkey);
|
|
|
|
if (level != static_cast<int>(max_level)) {
|
|
|
|
// compaction at max_level would change sequence number
|
|
|
|
assert(sorted_run_smallest_seqno == level_smallest_seqno);
|
|
|
|
assert(sorted_run_largest_seqno == level_largest_seqno);
|
|
|
|
}
|
|
|
|
} else if (compaction_style == kCompactionStyleUniversal) {
|
|
|
|
// level <= 0 means sorted runs on level 0
|
|
|
|
auto level0_file =
|
|
|
|
meta.levels[0].files[sorted_runs[k].size() - 1 - i];
|
|
|
|
assert(sorted_run_smallest_key == level0_file.smallestkey);
|
|
|
|
assert(sorted_run_largest_key == level0_file.largestkey);
|
|
|
|
if (level != static_cast<int>(max_level)) {
|
|
|
|
assert(sorted_run_smallest_seqno == level0_file.smallest_seqno);
|
|
|
|
assert(sorted_run_largest_seqno == level0_file.largest_seqno);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
// print the size of each sorted_run
|
|
|
|
for (size_t k = 0; k < num_db; k++) {
|
|
|
|
auto db = db_list[k];
|
|
|
|
fprintf(stdout,
|
2017-01-06 22:42:18 +00:00
|
|
|
"---------------------- DB %" ROCKSDB_PRIszt " LSM ---------------------\n", k);
|
2016-10-18 23:30:57 +00:00
|
|
|
db->GetColumnFamilyMetaData(&meta);
|
|
|
|
for (auto& levelMeta : meta.levels) {
|
|
|
|
if (levelMeta.files.empty()) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
if (levelMeta.level == 0) {
|
|
|
|
for (auto& fileMeta : levelMeta.files) {
|
2021-09-17 19:38:21 +00:00
|
|
|
fprintf(stdout, "Level[%d]: %s(size: %" PRIi64 " bytes)\n",
|
2016-11-12 23:43:33 +00:00
|
|
|
levelMeta.level, fileMeta.name.c_str(), fileMeta.size);
|
2016-10-18 23:30:57 +00:00
|
|
|
}
|
|
|
|
} else {
|
2016-11-12 23:43:33 +00:00
|
|
|
fprintf(stdout, "Level[%d]: %s - %s(total size: %" PRIi64 " bytes)\n",
|
2016-10-18 23:30:57 +00:00
|
|
|
levelMeta.level, levelMeta.files.front().name.c_str(),
|
|
|
|
levelMeta.files.back().name.c_str(), levelMeta.size);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
for (size_t i = 0; i < num_db; i++) {
|
|
|
|
db_list[i]->SetOptions(
|
|
|
|
{{"disable_auto_compactions",
|
|
|
|
std::to_string(options_list[i].disable_auto_compactions)},
|
|
|
|
{"level0_slowdown_writes_trigger",
|
|
|
|
std::to_string(options_list[i].level0_slowdown_writes_trigger)},
|
|
|
|
{"level0_stop_writes_trigger",
|
|
|
|
std::to_string(options_list[i].level0_stop_writes_trigger)}});
|
|
|
|
}
|
|
|
|
return Status::OK();
|
|
|
|
#else
|
2018-04-16 00:19:57 +00:00
|
|
|
(void)thread;
|
|
|
|
(void)compaction_style;
|
|
|
|
(void)write_mode;
|
2016-10-18 23:30:57 +00:00
|
|
|
fprintf(stderr, "Rocksdb Lite doesn't support filldeterministic\n");
|
|
|
|
return Status::NotSupported(
|
|
|
|
"Rocksdb Lite doesn't support filldeterministic");
|
|
|
|
#endif // ROCKSDB_LITE
|
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void ReadSequential(ThreadState* thread) {
|
2014-08-19 01:15:01 +00:00
|
|
|
if (db_.db != nullptr) {
|
|
|
|
ReadSequential(thread, db_.db);
|
2014-04-11 19:15:09 +00:00
|
|
|
} else {
|
2014-08-19 01:15:01 +00:00
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
ReadSequential(thread, db_with_cfh.db);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void ReadSequential(ThreadState* thread, DB* db) {
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
2014-09-26 21:20:24 +00:00
|
|
|
|
2021-11-11 00:18:27 +00:00
|
|
|
options.adaptive_readahead = FLAGS_adaptive_readahead;
|
2022-03-23 00:21:35 +00:00
|
|
|
options.async_io = FLAGS_async_io;
|
|
|
|
|
2014-09-26 21:20:24 +00:00
|
|
|
Iterator* iter = db->NewIterator(options);
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t i = 0;
|
2011-08-22 21:08:51 +00:00
|
|
|
int64_t bytes = 0;
|
2011-05-21 02:17:43 +00:00
|
|
|
for (iter->SeekToFirst(); i < reads_ && iter->Valid(); iter->Next()) {
|
2011-08-22 21:08:51 +00:00
|
|
|
bytes += iter->key().size() + iter->value().size();
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kRead);
|
2011-03-22 18:32:49 +00:00
|
|
|
++i;
|
2016-12-19 20:25:35 +00:00
|
|
|
|
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr &&
|
|
|
|
i % 1024 == 1023) {
|
2017-03-17 00:45:28 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(1024, Env::IO_HIGH,
|
2017-06-13 21:51:22 +00:00
|
|
|
nullptr /* stats */,
|
|
|
|
RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
2011-03-22 18:32:49 +00:00
|
|
|
}
|
2016-12-19 20:25:35 +00:00
|
|
|
|
2011-03-22 18:32:49 +00:00
|
|
|
delete iter;
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2019-09-10 18:03:31 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
void ReadToRowCache(ThreadState* thread) {
|
|
|
|
int64_t read = 0;
|
|
|
|
int64_t found = 0;
|
|
|
|
int64_t bytes = 0;
|
|
|
|
int64_t key_rand = 0;
|
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
|
|
|
PinnableSlice pinnable_val;
|
|
|
|
|
|
|
|
while (key_rand < FLAGS_num) {
|
|
|
|
DBWithColumnFamilies* db_with_cfh = SelectDBWithCfh(thread);
|
|
|
|
// We use same key_rand as seed for key and column family so that we can
|
|
|
|
// deterministically find the cfh corresponding to a particular key, as it
|
|
|
|
// is done in DoWrite method.
|
|
|
|
GenerateKeyFromInt(key_rand, FLAGS_num, &key);
|
|
|
|
key_rand++;
|
|
|
|
read++;
|
|
|
|
Status s;
|
|
|
|
if (FLAGS_num_column_families > 1) {
|
2022-02-01 03:45:17 +00:00
|
|
|
s = db_with_cfh->db->Get(read_options_, db_with_cfh->GetCfh(key_rand),
|
|
|
|
key, &pinnable_val);
|
2019-09-10 18:03:31 +00:00
|
|
|
} else {
|
|
|
|
pinnable_val.Reset();
|
2022-02-01 03:45:17 +00:00
|
|
|
s = db_with_cfh->db->Get(read_options_,
|
2019-09-10 18:03:31 +00:00
|
|
|
db_with_cfh->db->DefaultColumnFamily(), key,
|
|
|
|
&pinnable_val);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (s.ok()) {
|
|
|
|
found++;
|
|
|
|
bytes += key.size() + pinnable_val.size();
|
|
|
|
} else if (!s.IsNotFound()) {
|
|
|
|
fprintf(stderr, "Get returned an error: %s\n", s.ToString().c_str());
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
|
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr &&
|
|
|
|
read % 256 == 255) {
|
|
|
|
thread->shared->read_rate_limiter->Request(
|
|
|
|
256, Env::IO_HIGH, nullptr /* stats */, RateLimiter::OpType::kRead);
|
|
|
|
}
|
|
|
|
|
|
|
|
thread->stats.FinishedOps(db_with_cfh, db_with_cfh->db, 1, kRead);
|
|
|
|
}
|
|
|
|
|
|
|
|
char msg[100];
|
2019-09-12 23:53:31 +00:00
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " of %" PRIu64 " found)\n", found,
|
|
|
|
read);
|
2019-09-10 18:03:31 +00:00
|
|
|
|
|
|
|
thread->stats.AddBytes(bytes);
|
|
|
|
thread->stats.AddMessage(msg);
|
2011-03-22 18:32:49 +00:00
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void ReadReverse(ThreadState* thread) {
|
2014-08-19 01:15:01 +00:00
|
|
|
if (db_.db != nullptr) {
|
|
|
|
ReadReverse(thread, db_.db);
|
2014-04-11 19:15:09 +00:00
|
|
|
} else {
|
2014-08-19 01:15:01 +00:00
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
ReadReverse(thread, db_with_cfh.db);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void ReadReverse(ThreadState* thread, DB* db) {
|
2022-02-01 03:45:17 +00:00
|
|
|
Iterator* iter = db->NewIterator(read_options_);
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t i = 0;
|
2011-08-22 21:08:51 +00:00
|
|
|
int64_t bytes = 0;
|
2011-05-21 02:17:43 +00:00
|
|
|
for (iter->SeekToLast(); i < reads_ && iter->Valid(); iter->Prev()) {
|
2011-08-22 21:08:51 +00:00
|
|
|
bytes += iter->key().size() + iter->value().size();
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kRead);
|
2011-03-22 18:32:49 +00:00
|
|
|
++i;
|
2016-12-19 20:25:35 +00:00
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr &&
|
|
|
|
i % 1024 == 1023) {
|
2017-03-17 00:45:28 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(1024, Env::IO_HIGH,
|
2017-06-13 21:51:22 +00:00
|
|
|
nullptr /* stats */,
|
|
|
|
RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
2011-03-22 18:32:49 +00:00
|
|
|
}
|
|
|
|
delete iter;
|
2011-08-22 21:08:51 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2011-03-22 18:32:49 +00:00
|
|
|
}
|
|
|
|
|
2014-09-25 18:14:01 +00:00
|
|
|
void ReadRandomFast(ThreadState* thread) {
|
|
|
|
int64_t read = 0;
|
|
|
|
int64_t found = 0;
|
2014-09-25 20:34:51 +00:00
|
|
|
int64_t nonexist = 0;
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2014-09-25 18:14:01 +00:00
|
|
|
std::string value;
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2014-09-25 18:14:01 +00:00
|
|
|
DB* db = SelectDBWithCfh(thread)->db;
|
|
|
|
|
|
|
|
int64_t pot = 1;
|
|
|
|
while (pot < FLAGS_num) {
|
|
|
|
pot <<= 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
Duration duration(FLAGS_duration, reads_);
|
|
|
|
do {
|
|
|
|
for (int i = 0; i < 100; ++i) {
|
|
|
|
int64_t key_rand = thread->rand.Next() & (pot - 1);
|
|
|
|
GenerateKeyFromInt(key_rand, FLAGS_num, &key);
|
|
|
|
++read;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::string ts_ret;
|
|
|
|
std::string* ts_ptr = nullptr;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand,
|
|
|
|
ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
ts_ptr = &ts_ret;
|
|
|
|
}
|
|
|
|
auto status = db->Get(options, key, &value, ts_ptr);
|
2015-01-22 02:18:15 +00:00
|
|
|
if (status.ok()) {
|
2014-09-25 18:14:01 +00:00
|
|
|
++found;
|
2015-01-22 02:18:15 +00:00
|
|
|
} else if (!status.IsNotFound()) {
|
2015-01-22 02:23:12 +00:00
|
|
|
fprintf(stderr, "Get returned an error: %s\n",
|
|
|
|
status.ToString().c_str());
|
2015-01-22 02:18:15 +00:00
|
|
|
abort();
|
2014-09-25 18:14:01 +00:00
|
|
|
}
|
2014-09-25 20:34:51 +00:00
|
|
|
if (key_rand >= FLAGS_num) {
|
|
|
|
++nonexist;
|
|
|
|
}
|
2014-09-25 18:14:01 +00:00
|
|
|
}
|
2016-12-19 20:25:35 +00:00
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr) {
|
2017-06-13 21:51:22 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(
|
|
|
|
100, Env::IO_HIGH, nullptr /* stats */, RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 100, kRead);
|
2014-09-25 18:14:01 +00:00
|
|
|
} while (!duration.Done(100));
|
|
|
|
|
|
|
|
char msg[100];
|
2014-09-25 20:34:51 +00:00
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " of %" PRIu64 " found, "
|
|
|
|
"issued %" PRIu64 " non-exist keys)\n",
|
|
|
|
found, read, nonexist);
|
2014-09-25 18:14:01 +00:00
|
|
|
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2015-03-07 00:38:50 +00:00
|
|
|
int64_t GetRandomKey(Random64* rand) {
|
|
|
|
uint64_t rand_int = rand->Next();
|
|
|
|
int64_t key_rand;
|
|
|
|
if (read_random_exp_range_ == 0) {
|
|
|
|
key_rand = rand_int % FLAGS_num;
|
|
|
|
} else {
|
|
|
|
const uint64_t kBigInt = static_cast<uint64_t>(1U) << 62;
|
|
|
|
long double order = -static_cast<long double>(rand_int % kBigInt) /
|
|
|
|
static_cast<long double>(kBigInt) *
|
|
|
|
read_random_exp_range_;
|
|
|
|
long double exp_ran = std::exp(order);
|
2015-03-10 23:32:12 +00:00
|
|
|
uint64_t rand_num =
|
2015-03-07 00:38:50 +00:00
|
|
|
static_cast<int64_t>(exp_ran * static_cast<long double>(FLAGS_num));
|
2015-03-10 23:32:12 +00:00
|
|
|
// Map to a different number to avoid locality.
|
|
|
|
const uint64_t kBigPrime = 0x5bd1e995;
|
|
|
|
// Overflow is like %(2^64). Will have little impact of results.
|
|
|
|
key_rand = static_cast<int64_t>((rand_num * kBigPrime) % FLAGS_num);
|
2015-03-07 00:38:50 +00:00
|
|
|
}
|
|
|
|
return key_rand;
|
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void ReadRandom(ThreadState* thread) {
|
2014-03-28 16:21:20 +00:00
|
|
|
int64_t read = 0;
|
2014-04-08 18:21:09 +00:00
|
|
|
int64_t found = 0;
|
2015-03-30 18:28:25 +00:00
|
|
|
int64_t bytes = 0;
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
int num_keys = 0;
|
2020-04-08 21:23:41 +00:00
|
|
|
int64_t key_rand = 0;
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2017-03-13 18:44:50 +00:00
|
|
|
PinnableSlice pinnable_val;
|
2022-04-01 04:23:58 +00:00
|
|
|
std::vector<PinnableSlice> pinnable_vals;
|
|
|
|
if (read_operands_) {
|
|
|
|
// Start off with a small-ish value that'll be increased later if
|
|
|
|
// `GetMergeOperands()` tells us it is not large enough.
|
|
|
|
pinnable_vals.resize(8);
|
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2013-01-03 20:11:50 +00:00
|
|
|
|
2014-04-08 18:21:09 +00:00
|
|
|
Duration duration(FLAGS_duration, reads_);
|
|
|
|
while (!duration.Done(1)) {
|
2014-08-19 01:15:01 +00:00
|
|
|
DBWithColumnFamilies* db_with_cfh = SelectDBWithCfh(thread);
|
|
|
|
// We use same key_rand as seed for key and column family so that we can
|
|
|
|
// deterministically find the cfh corresponding to a particular key, as it
|
|
|
|
// is done in DoWrite method.
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
if (entries_per_batch_ > 1 && FLAGS_multiread_stride) {
|
|
|
|
if (++num_keys == entries_per_batch_) {
|
|
|
|
num_keys = 0;
|
|
|
|
key_rand = GetRandomKey(&thread->rand);
|
|
|
|
if ((key_rand + (entries_per_batch_ - 1) * FLAGS_multiread_stride) >=
|
|
|
|
FLAGS_num) {
|
|
|
|
key_rand = FLAGS_num - entries_per_batch_ * FLAGS_multiread_stride;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
key_rand += FLAGS_multiread_stride;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
key_rand = GetRandomKey(&thread->rand);
|
|
|
|
}
|
2020-04-08 21:23:41 +00:00
|
|
|
GenerateKeyFromInt(key_rand, FLAGS_num, &key);
|
2014-04-08 18:21:09 +00:00
|
|
|
read++;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::string ts_ret;
|
|
|
|
std::string* ts_ptr = nullptr;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
ts_ptr = &ts_ret;
|
|
|
|
}
|
2014-08-19 01:15:01 +00:00
|
|
|
Status s;
|
2021-04-06 18:30:17 +00:00
|
|
|
pinnable_val.Reset();
|
2022-04-01 04:23:58 +00:00
|
|
|
for (size_t i = 0; i < pinnable_vals.size(); ++i) {
|
|
|
|
pinnable_vals[i].Reset();
|
|
|
|
}
|
|
|
|
ColumnFamilyHandle* cfh;
|
2014-08-19 01:15:01 +00:00
|
|
|
if (FLAGS_num_column_families > 1) {
|
2022-04-01 04:23:58 +00:00
|
|
|
cfh = db_with_cfh->GetCfh(key_rand);
|
2014-08-19 01:15:01 +00:00
|
|
|
} else {
|
2022-04-01 04:23:58 +00:00
|
|
|
cfh = db_with_cfh->db->DefaultColumnFamily();
|
|
|
|
}
|
|
|
|
if (read_operands_) {
|
|
|
|
GetMergeOperandsOptions get_merge_operands_options;
|
|
|
|
get_merge_operands_options.expected_max_number_of_operands =
|
|
|
|
static_cast<int>(pinnable_vals.size());
|
|
|
|
int number_of_operands;
|
|
|
|
s = db_with_cfh->db->GetMergeOperands(
|
|
|
|
options, cfh, key, pinnable_vals.data(),
|
|
|
|
&get_merge_operands_options, &number_of_operands);
|
|
|
|
if (s.IsIncomplete()) {
|
|
|
|
// Should only happen a few times when we encounter a key that had
|
|
|
|
// more merge operands than any key seen so far. Production use case
|
|
|
|
// would typically retry in such event to get all the operands so do
|
|
|
|
// that here.
|
|
|
|
pinnable_vals.resize(number_of_operands);
|
|
|
|
get_merge_operands_options.expected_max_number_of_operands =
|
|
|
|
static_cast<int>(pinnable_vals.size());
|
|
|
|
s = db_with_cfh->db->GetMergeOperands(
|
|
|
|
options, cfh, key, pinnable_vals.data(),
|
|
|
|
&get_merge_operands_options, &number_of_operands);
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
s = db_with_cfh->db->Get(options, cfh, key, &pinnable_val, ts_ptr);
|
2014-08-19 01:15:01 +00:00
|
|
|
}
|
2022-04-01 04:23:58 +00:00
|
|
|
|
2014-08-19 01:15:01 +00:00
|
|
|
if (s.ok()) {
|
2014-04-08 18:21:09 +00:00
|
|
|
found++;
|
2020-09-16 03:04:58 +00:00
|
|
|
bytes += key.size() + pinnable_val.size() + user_timestamp_size_;
|
2022-04-01 04:23:58 +00:00
|
|
|
for (size_t i = 0; i < pinnable_vals.size(); ++i) {
|
|
|
|
bytes += pinnable_vals[i].size();
|
Avoid allocations/copies for large `GetMergeOperands()` results (#10458)
Summary:
This PR avoids allocations and copies for the result of `GetMergeOperands()` when the average operand size is at least 256 bytes and the total operands size is at least 32KB. The `GetMergeOperands()` already included `PinnableSlice` but was calling `PinSelf()` (i.e., allocating and copying) for each operand. When this optimization takes effect, we instead call `PinSlice()` to skip that allocation and copy. Resources are pinned in order for the `PinnableSlice` to point to valid memory even after `GetMergeOperands()` returns.
The pinned resources include a referenced `SuperVersion`, a `MergingContext`, and a `PinnedIteratorsManager`. They are bundled into a `GetMergeOperandsState`. We use `SharedCleanablePtr` to share that bundle among all `PinnableSlice`s populated by `GetMergeOperands()`. That way, the last `PinnableSlice` to be `Reset()` will cleanup the bundle, including unreferencing the `SuperVersion`.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/10458
Test Plan:
- new DB level test
- measured benefit/regression in a number of memtable scenarios
Setup command:
```
$ ./db_bench -benchmarks=mergerandom -merge_operator=StringAppendOperator -num=$num -writes=16384 -key_size=16 -value_size=$value_sz -compression_type=none -write_buffer_size=1048576000
```
Benchmark command:
```
./db_bench -threads=$threads -use_existing_db=true -avoid_flush_during_recovery=true -write_buffer_size=1048576000 -benchmarks=readrandomoperands -merge_operator=StringAppendOperator -num=$num -duration=10
```
Worst regression is when a key has many tiny operands:
- Parameters: num=1 (implying 16384 operands per key), value_sz=8, threads=1
- `GetMergeOperands()` latency increases 682 micros -> 800 micros (+17%)
The regression disappears into the noise (<1% difference) if we remove the `Reset()` loop and the size counting loop. The former is arguably needed regardless of this PR as the convention in `Get()` and `MultiGet()` is to `Reset()` the input `PinnableSlice`s at the start. The latter could be optimized to count the size as we accumulate operands rather than after the fact.
Best improvement is when a key has large operands and high concurrency:
- Parameters: num=4 (implying 4096 operands per key), value_sz=2KB, threads=32
- `GetMergeOperands()` latency decreases 11492 micros -> 437 micros (-96%).
Reviewed By: cbi42
Differential Revision: D38336578
Pulled By: ajkr
fbshipit-source-id: 48146d127e04cb7f2d4d2939a2b9dff3aba18258
2022-08-04 07:42:13 +00:00
|
|
|
pinnable_vals[i].Reset();
|
2022-04-01 04:23:58 +00:00
|
|
|
}
|
2015-01-22 02:18:15 +00:00
|
|
|
} else if (!s.IsNotFound()) {
|
2015-01-22 02:23:12 +00:00
|
|
|
fprintf(stderr, "Get returned an error: %s\n", s.ToString().c_str());
|
2015-01-22 02:18:15 +00:00
|
|
|
abort();
|
2013-03-01 19:25:13 +00:00
|
|
|
}
|
2016-12-19 20:25:35 +00:00
|
|
|
|
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr &&
|
|
|
|
read % 256 == 255) {
|
2017-06-13 21:51:22 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(
|
|
|
|
256, Env::IO_HIGH, nullptr /* stats */, RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(db_with_cfh, db_with_cfh->db, 1, kRead);
|
2012-04-17 15:36:46 +00:00
|
|
|
}
|
2013-06-12 19:42:21 +00:00
|
|
|
|
2012-04-17 15:36:46 +00:00
|
|
|
char msg[100];
|
2014-05-30 21:31:55 +00:00
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " of %" PRIu64 " found)\n",
|
2014-03-28 16:21:20 +00:00
|
|
|
found, read);
|
2014-03-05 18:32:54 +00:00
|
|
|
|
2015-03-30 18:28:25 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2012-04-17 15:36:46 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2014-04-08 18:21:09 +00:00
|
|
|
// Calls MultiGet over a list of keys from a random distribution.
|
|
|
|
// Returns the total number of keys found.
|
|
|
|
void MultiReadRandom(ThreadState* thread) {
|
|
|
|
int64_t read = 0;
|
2021-07-12 19:17:32 +00:00
|
|
|
int64_t bytes = 0;
|
2016-12-19 20:25:35 +00:00
|
|
|
int64_t num_multireads = 0;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t found = 0;
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2014-04-14 22:42:20 +00:00
|
|
|
std::vector<Slice> keys;
|
2015-02-19 22:27:48 +00:00
|
|
|
std::vector<std::unique_ptr<const char[]> > key_guards;
|
2014-04-08 18:21:09 +00:00
|
|
|
std::vector<std::string> values(entries_per_batch_);
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
PinnableSlice* pin_values = new PinnableSlice[entries_per_batch_];
|
2019-04-12 17:42:06 +00:00
|
|
|
std::unique_ptr<PinnableSlice[]> pin_values_guard(pin_values);
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
std::vector<Status> stat_list(entries_per_batch_);
|
2014-04-29 19:33:57 +00:00
|
|
|
while (static_cast<int64_t>(keys.size()) < entries_per_batch_) {
|
2015-12-29 01:42:32 +00:00
|
|
|
key_guards.push_back(std::unique_ptr<const char[]>());
|
2015-02-19 22:27:48 +00:00
|
|
|
keys.push_back(AllocateKey(&key_guards.back()));
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
|
|
|
|
2013-03-01 19:25:13 +00:00
|
|
|
Duration duration(FLAGS_duration, reads_);
|
2020-12-28 21:37:07 +00:00
|
|
|
while (!duration.Done(entries_per_batch_)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
if (FLAGS_multiread_stride) {
|
|
|
|
int64_t key = GetRandomKey(&thread->rand);
|
|
|
|
if ((key + (entries_per_batch_ - 1) * FLAGS_multiread_stride) >=
|
2019-07-01 20:02:30 +00:00
|
|
|
static_cast<int64_t>(FLAGS_num)) {
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
key = FLAGS_num - entries_per_batch_ * FLAGS_multiread_stride;
|
|
|
|
}
|
|
|
|
for (int64_t i = 0; i < entries_per_batch_; ++i) {
|
|
|
|
GenerateKeyFromInt(key, FLAGS_num, &keys[i]);
|
|
|
|
key += FLAGS_multiread_stride;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
for (int64_t i = 0; i < entries_per_batch_; ++i) {
|
|
|
|
GenerateKeyFromInt(GetRandomKey(&thread->rand), FLAGS_num, &keys[i]);
|
|
|
|
}
|
2013-06-12 19:42:21 +00:00
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
if (!FLAGS_multiread_batched) {
|
|
|
|
std::vector<Status> statuses = db->MultiGet(options, keys, &values);
|
|
|
|
assert(static_cast<int64_t>(statuses.size()) == entries_per_batch_);
|
|
|
|
|
|
|
|
read += entries_per_batch_;
|
|
|
|
num_multireads++;
|
|
|
|
for (int64_t i = 0; i < entries_per_batch_; ++i) {
|
|
|
|
if (statuses[i].ok()) {
|
2021-07-12 19:17:32 +00:00
|
|
|
bytes += keys[i].size() + values[i].size() + user_timestamp_size_;
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
++found;
|
|
|
|
} else if (!statuses[i].IsNotFound()) {
|
|
|
|
fprintf(stderr, "MultiGet returned an error: %s\n",
|
|
|
|
statuses[i].ToString().c_str());
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
db->MultiGet(options, db->DefaultColumnFamily(), keys.size(),
|
|
|
|
keys.data(), pin_values, stat_list.data());
|
|
|
|
|
|
|
|
read += entries_per_batch_;
|
|
|
|
num_multireads++;
|
|
|
|
for (int64_t i = 0; i < entries_per_batch_; ++i) {
|
|
|
|
if (stat_list[i].ok()) {
|
2021-07-12 19:17:32 +00:00
|
|
|
bytes +=
|
|
|
|
keys[i].size() + pin_values[i].size() + user_timestamp_size_;
|
Introduce a new MultiGet batching implementation (#5011)
Summary:
This PR introduces a new MultiGet() API, with the underlying implementation grouping keys based on SST file and batching lookups in a file. The reason for the new API is twofold - the definition allows callers to allocate storage for status and values on stack instead of std::vector, as well as return values as PinnableSlices in order to avoid copying, and it keeps the original MultiGet() implementation intact while we experiment with batching.
Batching is useful when there is some spatial locality to the keys being queries, as well as larger batch sizes. The main benefits are due to -
1. Fewer function calls, especially to BlockBasedTableReader::MultiGet() and FullFilterBlockReader::KeysMayMatch()
2. Bloom filter cachelines can be prefetched, hiding the cache miss latency
The next step is to optimize the binary searches in the level_storage_info, index blocks and data blocks, since we could reduce the number of key comparisons if the keys are relatively close to each other. The batching optimizations also need to be extended to other formats, such as PlainTable and filter formats. This also needs to be added to db_stress.
Benchmark results from db_bench for various batch size/locality of reference combinations are given below. Locality was simulated by offsetting the keys in a batch by a stride length. Each SST file is about 8.6MB uncompressed and key/value size is 16/100 uncompressed. To focus on the cpu benefit of batching, the runs were single threaded and bound to the same cpu to eliminate interference from other system events. The results show a 10-25% improvement in micros/op from smaller to larger batch sizes (4 - 32).
Batch Sizes
1 | 2 | 4 | 8 | 16 | 32
Random pattern (Stride length 0)
4.158 | 4.109 | 4.026 | 4.05 | 4.1 | 4.074 - Get
4.438 | 4.302 | 4.165 | 4.122 | 4.096 | 4.075 - MultiGet (no batching)
4.461 | 4.256 | 4.277 | 4.11 | 4.182 | 4.14 - MultiGet (w/ batching)
Good locality (Stride length 16)
4.048 | 3.659 | 3.248 | 2.99 | 2.84 | 2.753
4.429 | 3.728 | 3.406 | 3.053 | 2.911 | 2.781
4.452 | 3.45 | 2.833 | 2.451 | 2.233 | 2.135
Good locality (Stride length 256)
4.066 | 3.786 | 3.581 | 3.447 | 3.415 | 3.232
4.406 | 4.005 | 3.644 | 3.49 | 3.381 | 3.268
4.393 | 3.649 | 3.186 | 2.882 | 2.676 | 2.62
Medium locality (Stride length 4096)
4.012 | 3.922 | 3.768 | 3.61 | 3.582 | 3.555
4.364 | 4.057 | 3.791 | 3.65 | 3.57 | 3.465
4.479 | 3.758 | 3.316 | 3.077 | 2.959 | 2.891
dbbench command used (on a DB with 4 levels, 12 million keys)-
TEST_TMPDIR=/dev/shm numactl -C 10 ./db_bench.tmp -use_existing_db=true -benchmarks="readseq,multireadrandom" -write_buffer_size=4194304 -target_file_size_base=4194304 -max_bytes_for_level_base=16777216 -num=12000000 -reads=12000000 -duration=90 -threads=1 -compression_type=none -cache_size=4194304000 -batch_size=32 -disable_auto_compactions=true -bloom_bits=10 -cache_index_and_filter_blocks=true -pin_l0_filter_and_index_blocks_in_cache=true -multiread_batched=true -multiread_stride=4
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5011
Differential Revision: D14348703
Pulled By: anand1976
fbshipit-source-id: 774406dab3776d979c809522a67bedac6c17f84b
2019-04-11 21:24:09 +00:00
|
|
|
++found;
|
|
|
|
} else if (!stat_list[i].IsNotFound()) {
|
|
|
|
fprintf(stderr, "MultiGet returned an error: %s\n",
|
|
|
|
stat_list[i].ToString().c_str());
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
stat_list[i] = Status::OK();
|
|
|
|
pin_values[i].Reset();
|
2013-06-12 19:42:21 +00:00
|
|
|
}
|
|
|
|
}
|
2016-12-19 20:25:35 +00:00
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr &&
|
|
|
|
num_multireads % 256 == 255) {
|
2017-03-17 00:45:28 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(
|
2017-06-13 21:51:22 +00:00
|
|
|
256 * entries_per_batch_, Env::IO_HIGH, nullptr /* stats */,
|
|
|
|
RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, entries_per_batch_, kRead);
|
2011-05-21 02:17:43 +00:00
|
|
|
}
|
2013-06-12 19:42:21 +00:00
|
|
|
|
|
|
|
char msg[100];
|
2014-03-05 01:08:05 +00:00
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " of %" PRIu64 " found)",
|
2014-04-08 18:21:09 +00:00
|
|
|
found, read);
|
2021-07-12 19:17:32 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2013-06-12 19:42:21 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
2011-05-21 02:17:43 +00:00
|
|
|
}
|
|
|
|
|
For ApproximateSizes, pro-rate table metadata size over data blocks (#6784)
Summary:
The implementation of GetApproximateSizes was inconsistent in
its treatment of the size of non-data blocks of SST files, sometimes
including and sometimes now. This was at its worst with large portion
of table file used by filters and querying a small range that crossed
a table boundary: the size estimate would include large filter size.
It's conceivable that someone might want only to know the size in terms
of data blocks, but I believe that's unlikely enough to ignore for now.
Similarly, there's no evidence the internal function AppoximateOffsetOf
is used for anything other than a one-sided ApproximateSize, so I intend
to refactor to remove redundancy in a follow-up commit.
So to fix this, GetApproximateSizes (and implementation details
ApproximateSize and ApproximateOffsetOf) now consistently include in
their returned sizes a portion of table file metadata (incl filters
and indexes) based on the size portion of the data blocks in range. In
other words, if a key range covers data blocks that are X% by size of all
the table's data blocks, returned approximate size is X% of the total
file size. It would technically be more accurate to attribute metadata
based on number of keys, but that's not computationally efficient with
data available and rarely a meaningful difference.
Also includes miscellaneous comment improvements / clarifications.
Also included is a new approximatesizerandom benchmark for db_bench.
No significant performance difference seen with this change, whether ~700 ops/sec with cache_index_and_filter_blocks and small cache or ~150k ops/sec without cache_index_and_filter_blocks.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/6784
Test Plan:
Test added to DBTest.ApproximateSizesFilesWithErrorMargin.
Old code running new test...
[ RUN ] DBTest.ApproximateSizesFilesWithErrorMargin
db/db_test.cc:1562: Failure
Expected: (size) <= (11 * 100), actual: 9478 vs 1100
Other tests updated to reflect consistent accounting of metadata.
Reviewed By: siying
Differential Revision: D21334706
Pulled By: pdillinger
fbshipit-source-id: 6f86870e45213334fedbe9c73b4ebb1d8d611185
2020-06-02 19:27:59 +00:00
|
|
|
// Calls ApproximateSize over random key ranges.
|
|
|
|
void ApproximateSizeRandom(ThreadState* thread) {
|
|
|
|
int64_t size_sum = 0;
|
|
|
|
int64_t num_sizes = 0;
|
|
|
|
const size_t batch_size = entries_per_batch_;
|
|
|
|
std::vector<Range> ranges;
|
|
|
|
std::vector<Slice> lkeys;
|
|
|
|
std::vector<std::unique_ptr<const char[]>> lkey_guards;
|
|
|
|
std::vector<Slice> rkeys;
|
|
|
|
std::vector<std::unique_ptr<const char[]>> rkey_guards;
|
|
|
|
std::vector<uint64_t> sizes;
|
|
|
|
while (ranges.size() < batch_size) {
|
|
|
|
// Ugly without C++17 return from emplace_back
|
|
|
|
lkey_guards.emplace_back();
|
|
|
|
rkey_guards.emplace_back();
|
|
|
|
lkeys.emplace_back(AllocateKey(&lkey_guards.back()));
|
|
|
|
rkeys.emplace_back(AllocateKey(&rkey_guards.back()));
|
|
|
|
ranges.emplace_back(lkeys.back(), rkeys.back());
|
|
|
|
sizes.push_back(0);
|
|
|
|
}
|
|
|
|
Duration duration(FLAGS_duration, reads_);
|
|
|
|
while (!duration.Done(1)) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
for (size_t i = 0; i < batch_size; ++i) {
|
|
|
|
int64_t lkey = GetRandomKey(&thread->rand);
|
|
|
|
int64_t rkey = GetRandomKey(&thread->rand);
|
|
|
|
if (lkey > rkey) {
|
|
|
|
std::swap(lkey, rkey);
|
|
|
|
}
|
|
|
|
GenerateKeyFromInt(lkey, FLAGS_num, &lkeys[i]);
|
|
|
|
GenerateKeyFromInt(rkey, FLAGS_num, &rkeys[i]);
|
|
|
|
}
|
|
|
|
db->GetApproximateSizes(&ranges[0], static_cast<int>(entries_per_batch_),
|
|
|
|
&sizes[0]);
|
|
|
|
num_sizes += entries_per_batch_;
|
|
|
|
for (int64_t size : sizes) {
|
|
|
|
size_sum += size;
|
|
|
|
}
|
|
|
|
thread->stats.FinishedOps(nullptr, db, entries_per_batch_, kOthers);
|
|
|
|
}
|
|
|
|
|
|
|
|
char msg[100];
|
|
|
|
snprintf(msg, sizeof(msg), "(Avg approx size=%g)",
|
|
|
|
static_cast<double>(size_sum) / static_cast<double>(num_sizes));
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// The inverse function of Pareto distribution
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
int64_t ParetoCdfInversion(double u, double theta, double k, double sigma) {
|
|
|
|
double ret;
|
|
|
|
if (k == 0.0) {
|
|
|
|
ret = theta - sigma * std::log(u);
|
|
|
|
} else {
|
|
|
|
ret = theta + sigma * (std::pow(u, -1 * k) - 1) / k;
|
|
|
|
}
|
|
|
|
return static_cast<int64_t>(ceil(ret));
|
|
|
|
}
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// The inverse function of power distribution (y=ax^b)
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
int64_t PowerCdfInversion(double u, double a, double b) {
|
|
|
|
double ret;
|
|
|
|
ret = std::pow((u / a), (1 / b));
|
|
|
|
return static_cast<int64_t>(ceil(ret));
|
|
|
|
}
|
|
|
|
|
|
|
|
// Add the noice to the QPS
|
|
|
|
double AddNoise(double origin, double noise_ratio) {
|
|
|
|
if (noise_ratio < 0.0 || noise_ratio > 1.0) {
|
|
|
|
return origin;
|
|
|
|
}
|
|
|
|
int band_int = static_cast<int>(FLAGS_sine_a);
|
|
|
|
double delta = (rand() % band_int - band_int / 2) * noise_ratio;
|
|
|
|
if (origin + delta < 0) {
|
|
|
|
return origin;
|
|
|
|
} else {
|
|
|
|
return (origin + delta);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// Decide the ratio of different query types
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
// 0 Get, 1 Put, 2 Seek, 3 SeekForPrev, 4 Delete, 5 SingleDelete, 6 merge
|
|
|
|
class QueryDecider {
|
|
|
|
public:
|
|
|
|
std::vector<int> type_;
|
|
|
|
std::vector<double> ratio_;
|
|
|
|
int range_;
|
|
|
|
|
|
|
|
QueryDecider() {}
|
|
|
|
~QueryDecider() {}
|
|
|
|
|
|
|
|
Status Initiate(std::vector<double> ratio_input) {
|
|
|
|
int range_max = 1000;
|
|
|
|
double sum = 0.0;
|
|
|
|
for (auto& ratio : ratio_input) {
|
|
|
|
sum += ratio;
|
|
|
|
}
|
|
|
|
range_ = 0;
|
|
|
|
for (auto& ratio : ratio_input) {
|
|
|
|
range_ += static_cast<int>(ceil(range_max * (ratio / sum)));
|
|
|
|
type_.push_back(range_);
|
|
|
|
ratio_.push_back(ratio / sum);
|
|
|
|
}
|
|
|
|
return Status::OK();
|
|
|
|
}
|
|
|
|
|
|
|
|
int GetType(int64_t rand_num) {
|
|
|
|
if (rand_num < 0) {
|
|
|
|
rand_num = rand_num * (-1);
|
|
|
|
}
|
2019-01-23 21:26:03 +00:00
|
|
|
assert(range_ != 0);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
int pos = static_cast<int>(rand_num % range_);
|
|
|
|
for (int i = 0; i < static_cast<int>(type_.size()); i++) {
|
|
|
|
if (pos < type_[i]) {
|
|
|
|
return i;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// KeyrangeUnit is the struct of a keyrange. It is used in a keyrange vector
|
|
|
|
// to transfer a random value to one keyrange based on the hotness.
|
|
|
|
struct KeyrangeUnit {
|
|
|
|
int64_t keyrange_start;
|
|
|
|
int64_t keyrange_access;
|
|
|
|
int64_t keyrange_keys;
|
|
|
|
};
|
|
|
|
|
|
|
|
// From our observations, the prefix hotness (key-range hotness) follows
|
|
|
|
// the two-term-exponential distribution: f(x) = a*exp(b*x) + c*exp(d*x).
|
|
|
|
// However, we cannot directly use the inverse function to decide a
|
|
|
|
// key-range from a random distribution. To achieve it, we create a list of
|
|
|
|
// KeyrangeUnit, each KeyrangeUnit occupies a range of integers whose size is
|
|
|
|
// decided based on the hotness of the key-range. When a random value is
|
|
|
|
// generated based on uniform distribution, we map it to the KeyrangeUnit Vec
|
|
|
|
// and one KeyrangeUnit is selected. The probability of a KeyrangeUnit being
|
|
|
|
// selected is the same as the hotness of this KeyrangeUnit. After that, the
|
|
|
|
// key can be randomly allocated to the key-range of this KeyrangeUnit, or we
|
|
|
|
// can based on the power distribution (y=ax^b) to generate the offset of
|
|
|
|
// the key in the selected key-range. In this way, we generate the keyID
|
|
|
|
// based on the hotness of the prefix and also the key hotness distribution.
|
|
|
|
class GenerateTwoTermExpKeys {
|
|
|
|
public:
|
2020-09-08 22:10:28 +00:00
|
|
|
// Avoid uninitialized warning-as-error in some compilers
|
|
|
|
int64_t keyrange_rand_max_ = 0;
|
|
|
|
int64_t keyrange_size_ = 0;
|
|
|
|
int64_t keyrange_num_ = 0;
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
std::vector<KeyrangeUnit> keyrange_set_;
|
|
|
|
|
|
|
|
// Initiate the KeyrangeUnit vector and calculate the size of each
|
|
|
|
// KeyrangeUnit.
|
|
|
|
Status InitiateExpDistribution(int64_t total_keys, double prefix_a,
|
|
|
|
double prefix_b, double prefix_c,
|
|
|
|
double prefix_d) {
|
|
|
|
int64_t amplify = 0;
|
|
|
|
int64_t keyrange_start = 0;
|
|
|
|
if (FLAGS_keyrange_num <= 0) {
|
|
|
|
keyrange_num_ = 1;
|
|
|
|
} else {
|
|
|
|
keyrange_num_ = FLAGS_keyrange_num;
|
|
|
|
}
|
|
|
|
keyrange_size_ = total_keys / keyrange_num_;
|
|
|
|
|
|
|
|
// Calculate the key-range shares size based on the input parameters
|
|
|
|
for (int64_t pfx = keyrange_num_; pfx >= 1; pfx--) {
|
|
|
|
// Step 1. Calculate the probability that this key range will be
|
|
|
|
// accessed in a query. It is based on the two-term expoential
|
|
|
|
// distribution
|
|
|
|
double keyrange_p = prefix_a * std::exp(prefix_b * pfx) +
|
|
|
|
prefix_c * std::exp(prefix_d * pfx);
|
|
|
|
if (keyrange_p < std::pow(10.0, -16.0)) {
|
|
|
|
keyrange_p = 0.0;
|
|
|
|
}
|
|
|
|
// Step 2. Calculate the amplify
|
|
|
|
// In order to allocate a query to a key-range based on the random
|
|
|
|
// number generated for this query, we need to extend the probability
|
|
|
|
// of each key range from [0,1] to [0, amplify]. Amplify is calculated
|
|
|
|
// by 1/(smallest key-range probability). In this way, we ensure that
|
|
|
|
// all key-ranges are assigned with an Integer that >=0
|
|
|
|
if (amplify == 0 && keyrange_p > 0) {
|
|
|
|
amplify = static_cast<int64_t>(std::floor(1 / keyrange_p)) + 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Step 3. For each key-range, we calculate its position in the
|
|
|
|
// [0, amplify] range, including the start, the size (keyrange_access)
|
|
|
|
KeyrangeUnit p_unit;
|
|
|
|
p_unit.keyrange_start = keyrange_start;
|
|
|
|
if (0.0 >= keyrange_p) {
|
|
|
|
p_unit.keyrange_access = 0;
|
|
|
|
} else {
|
|
|
|
p_unit.keyrange_access =
|
|
|
|
static_cast<int64_t>(std::floor(amplify * keyrange_p));
|
|
|
|
}
|
|
|
|
p_unit.keyrange_keys = keyrange_size_;
|
|
|
|
keyrange_set_.push_back(p_unit);
|
|
|
|
keyrange_start += p_unit.keyrange_access;
|
|
|
|
}
|
|
|
|
keyrange_rand_max_ = keyrange_start;
|
|
|
|
|
|
|
|
// Step 4. Shuffle the key-ranges randomly
|
|
|
|
// Since the access probability is calculated from small to large,
|
|
|
|
// If we do not re-allocate them, hot key-ranges are always at the end
|
|
|
|
// and cold key-ranges are at the begin of the key space. Therefore, the
|
|
|
|
// key-ranges are shuffled and the rand seed is only decide by the
|
|
|
|
// key-range hotness distribution. With the same distribution parameters
|
|
|
|
// the shuffle results are the same.
|
|
|
|
Random64 rand_loca(keyrange_rand_max_);
|
|
|
|
for (int64_t i = 0; i < FLAGS_keyrange_num; i++) {
|
|
|
|
int64_t pos = rand_loca.Next() % FLAGS_keyrange_num;
|
|
|
|
assert(i >= 0 && i < static_cast<int64_t>(keyrange_set_.size()) &&
|
|
|
|
pos >= 0 && pos < static_cast<int64_t>(keyrange_set_.size()));
|
|
|
|
std::swap(keyrange_set_[i], keyrange_set_[pos]);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Step 5. Recalculate the prefix start postion after shuffling
|
|
|
|
int64_t offset = 0;
|
|
|
|
for (auto& p_unit : keyrange_set_) {
|
|
|
|
p_unit.keyrange_start = offset;
|
|
|
|
offset += p_unit.keyrange_access;
|
|
|
|
}
|
|
|
|
|
|
|
|
return Status::OK();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Generate the Key ID according to the input ini_rand and key distribution
|
|
|
|
int64_t DistGetKeyID(int64_t ini_rand, double key_dist_a,
|
|
|
|
double key_dist_b) {
|
|
|
|
int64_t keyrange_rand = ini_rand % keyrange_rand_max_;
|
|
|
|
|
|
|
|
// Calculate and select one key-range that contains the new key
|
|
|
|
int64_t start = 0, end = static_cast<int64_t>(keyrange_set_.size());
|
|
|
|
while (start + 1 < end) {
|
|
|
|
int64_t mid = start + (end - start) / 2;
|
|
|
|
assert(mid >= 0 && mid < static_cast<int64_t>(keyrange_set_.size()));
|
|
|
|
if (keyrange_rand < keyrange_set_[mid].keyrange_start) {
|
|
|
|
end = mid;
|
|
|
|
} else {
|
|
|
|
start = mid;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
int64_t keyrange_id = start;
|
|
|
|
|
|
|
|
// Select one key in the key-range and compose the keyID
|
|
|
|
int64_t key_offset = 0, key_seed;
|
2020-05-04 17:53:15 +00:00
|
|
|
if (key_dist_a == 0.0 || key_dist_b == 0.0) {
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
key_offset = ini_rand % keyrange_size_;
|
|
|
|
} else {
|
2020-05-04 17:53:15 +00:00
|
|
|
double u =
|
|
|
|
static_cast<double>(ini_rand % keyrange_size_) / keyrange_size_;
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
key_seed = static_cast<int64_t>(
|
2020-05-04 17:53:15 +00:00
|
|
|
ceil(std::pow((u / key_dist_a), (1 / key_dist_b))));
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
Random64 rand_key(key_seed);
|
2020-05-04 17:53:15 +00:00
|
|
|
key_offset = rand_key.Next() % keyrange_size_;
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
}
|
|
|
|
return keyrange_size_ * keyrange_id + key_offset;
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2021-03-26 18:46:47 +00:00
|
|
|
// The social graph workload mixed with Get, Put, Iterator queries.
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// The value size and iterator length follow Pareto distribution.
|
|
|
|
// The overall key access follow power distribution. If user models the
|
|
|
|
// workload based on different key-ranges (or different prefixes), user
|
|
|
|
// can use two-term-exponential distribution to fit the workload. User
|
2021-03-26 18:46:47 +00:00
|
|
|
// needs to decide the ratio between Get, Put, Iterator queries before
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// starting the benchmark.
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
void MixGraph(ThreadState* thread) {
|
|
|
|
int64_t gets = 0;
|
|
|
|
int64_t puts = 0;
|
2022-03-22 00:30:51 +00:00
|
|
|
int64_t get_found = 0;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
int64_t seek = 0;
|
|
|
|
int64_t seek_found = 0;
|
|
|
|
int64_t bytes = 0;
|
2022-03-22 00:30:51 +00:00
|
|
|
double total_scan_length = 0;
|
|
|
|
double total_val_size = 0;
|
2019-03-08 22:07:19 +00:00
|
|
|
const int64_t default_value_max = 1 * 1024 * 1024;
|
2019-01-28 20:23:03 +00:00
|
|
|
int64_t value_max = default_value_max;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
int64_t scan_len_max = FLAGS_mix_max_scan_len;
|
|
|
|
double write_rate = 1000000.0;
|
|
|
|
double read_rate = 1000000.0;
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
bool use_prefix_modeling = false;
|
2020-05-04 17:53:15 +00:00
|
|
|
bool use_random_modeling = false;
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
GenerateTwoTermExpKeys gen_exp;
|
2019-01-30 00:23:21 +00:00
|
|
|
std::vector<double> ratio{FLAGS_mix_get_ratio, FLAGS_mix_put_ratio,
|
|
|
|
FLAGS_mix_seek_ratio};
|
2019-01-28 20:23:03 +00:00
|
|
|
char value_buffer[default_value_max];
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
QueryDecider query;
|
|
|
|
RandomGenerator gen;
|
|
|
|
Status s;
|
2019-01-30 00:23:21 +00:00
|
|
|
if (value_max > FLAGS_mix_max_value_size) {
|
2019-01-28 20:23:03 +00:00
|
|
|
value_max = FLAGS_mix_max_value_size;
|
|
|
|
}
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
|
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
|
|
|
PinnableSlice pinnable_val;
|
|
|
|
query.Initiate(ratio);
|
|
|
|
|
|
|
|
// the limit of qps initiation
|
2021-10-14 20:23:01 +00:00
|
|
|
if (FLAGS_sine_mix_rate) {
|
|
|
|
thread->shared->read_rate_limiter.reset(
|
|
|
|
NewGenericRateLimiter(static_cast<int64_t>(read_rate)));
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
thread->shared->write_rate_limiter.reset(
|
2019-04-23 18:12:39 +00:00
|
|
|
NewGenericRateLimiter(static_cast<int64_t>(write_rate)));
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
|
|
|
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
// Decide if user wants to use prefix based key generation
|
|
|
|
if (FLAGS_keyrange_dist_a != 0.0 || FLAGS_keyrange_dist_b != 0.0 ||
|
|
|
|
FLAGS_keyrange_dist_c != 0.0 || FLAGS_keyrange_dist_d != 0.0) {
|
|
|
|
use_prefix_modeling = true;
|
|
|
|
gen_exp.InitiateExpDistribution(
|
|
|
|
FLAGS_num, FLAGS_keyrange_dist_a, FLAGS_keyrange_dist_b,
|
|
|
|
FLAGS_keyrange_dist_c, FLAGS_keyrange_dist_d);
|
|
|
|
}
|
2020-05-04 17:53:15 +00:00
|
|
|
if (FLAGS_key_dist_a == 0 || FLAGS_key_dist_b == 0) {
|
|
|
|
use_random_modeling = true;
|
|
|
|
}
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
Duration duration(FLAGS_duration, reads_);
|
|
|
|
while (!duration.Done(1)) {
|
|
|
|
DBWithColumnFamilies* db_with_cfh = SelectDBWithCfh(thread);
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
int64_t ini_rand, rand_v, key_rand, key_seed;
|
|
|
|
ini_rand = GetRandomKey(&thread->rand);
|
|
|
|
rand_v = ini_rand % FLAGS_num;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
double u = static_cast<double>(rand_v) / FLAGS_num;
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
|
|
|
|
// Generate the keyID based on the key hotness and prefix hotness
|
2020-05-04 17:53:15 +00:00
|
|
|
if (use_random_modeling) {
|
|
|
|
key_rand = ini_rand;
|
|
|
|
} else if (use_prefix_modeling) {
|
Workload generator (Mixgraph) based on prefix hotness (#5953)
Summary:
In the previous PR https://github.com/facebook/rocksdb/issues/4788, user can use db_bench mix_graph option to generate the workload that is from the social graph. The key is generated based on the key access hotness. In this PR, user can further model the key-range hotness and fit those to two-term-exponential distribution. First, user cuts the whole key space into small key ranges (e.g., key-ranges are the same size and the key-range number is the number of SST files). Then, user calculates the average access count per key of each key-range as the key-range hotness. Next, user fits the key-range hotness to two-term-exponential distribution (f(x) = f(x) = a*exp(b*x) + c*exp(d*x)) and generate the value of a, b, c, and d. They are the parameters in db_bench: prefix_dist_a, prefix_dist_b, prefix_dist_c, and prefix_dist_d. Finally, user can run db_bench by specify the parameters.
For example:
`./db_bench --benchmarks="mixgraph" -use_direct_io_for_flush_and_compaction=true -use_direct_reads=true -cache_size=268435456 -key_dist_a=0.002312 -key_dist_b=0.3467 -keyrange_dist_a=14.18 -keyrange_dist_b=-2.917 -keyrange_dist_c=0.0164 -keyrange_dist_d=-0.08082 -keyrange_num=30 -value_k=0.2615 -value_sigma=25.45 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.85 -mix_put_ratio=0.14 -mix_seek_ratio=0.01 -sine_mix_rate_interval_milliseconds=5000 -sine_a=350 -sine_b=0.0105 -sine_d=50000 --perf_level=2 -reads=1000000 -num=5000000 -key_size=48`
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5953
Test Plan: run db_bench with different parameters and checked the results.
Differential Revision: D18053527
Pulled By: zhichao-cao
fbshipit-source-id: 171f8b3142bd76462f1967c58345ad7e4f84bab7
2019-11-06 20:50:33 +00:00
|
|
|
key_rand =
|
|
|
|
gen_exp.DistGetKeyID(ini_rand, FLAGS_key_dist_a, FLAGS_key_dist_b);
|
|
|
|
} else {
|
|
|
|
key_seed = PowerCdfInversion(u, FLAGS_key_dist_a, FLAGS_key_dist_b);
|
|
|
|
Random64 rand(key_seed);
|
|
|
|
key_rand = static_cast<int64_t>(rand.Next()) % FLAGS_num;
|
|
|
|
}
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
GenerateKeyFromInt(key_rand, FLAGS_num, &key);
|
|
|
|
int query_type = query.GetType(rand_v);
|
|
|
|
|
|
|
|
// change the qps
|
|
|
|
uint64_t now = FLAGS_env->NowMicros();
|
|
|
|
uint64_t usecs_since_last;
|
|
|
|
if (now > thread->stats.GetSineInterval()) {
|
|
|
|
usecs_since_last = now - thread->stats.GetSineInterval();
|
|
|
|
} else {
|
|
|
|
usecs_since_last = 0;
|
|
|
|
}
|
|
|
|
|
2021-10-14 20:23:01 +00:00
|
|
|
if (FLAGS_sine_mix_rate &&
|
|
|
|
usecs_since_last >
|
|
|
|
(FLAGS_sine_mix_rate_interval_milliseconds * uint64_t{1000})) {
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
double usecs_since_start =
|
|
|
|
static_cast<double>(now - thread->stats.GetStart());
|
|
|
|
thread->stats.ResetSineInterval();
|
|
|
|
double mix_rate_with_noise = AddNoise(
|
|
|
|
SineRate(usecs_since_start / 1000000.0), FLAGS_sine_mix_rate_noise);
|
|
|
|
read_rate = mix_rate_with_noise * (query.ratio_[0] + query.ratio_[2]);
|
2021-10-14 20:23:01 +00:00
|
|
|
write_rate = mix_rate_with_noise * query.ratio_[1];
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
|
2021-10-14 20:23:01 +00:00
|
|
|
if (read_rate > 0) {
|
|
|
|
thread->shared->read_rate_limiter->SetBytesPerSecond(
|
|
|
|
static_cast<int64_t>(read_rate));
|
|
|
|
}
|
|
|
|
if (write_rate > 0) {
|
|
|
|
thread->shared->write_rate_limiter->SetBytesPerSecond(
|
|
|
|
static_cast<int64_t>(write_rate));
|
|
|
|
}
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
|
|
|
// Start the query
|
|
|
|
if (query_type == 0) {
|
|
|
|
// the Get query
|
|
|
|
gets++;
|
|
|
|
if (FLAGS_num_column_families > 1) {
|
2022-02-01 03:45:17 +00:00
|
|
|
s = db_with_cfh->db->Get(read_options_, db_with_cfh->GetCfh(key_rand),
|
|
|
|
key, &pinnable_val);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
} else {
|
|
|
|
pinnable_val.Reset();
|
2022-02-01 03:45:17 +00:00
|
|
|
s = db_with_cfh->db->Get(read_options_,
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
db_with_cfh->db->DefaultColumnFamily(), key,
|
|
|
|
&pinnable_val);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (s.ok()) {
|
2022-03-22 00:30:51 +00:00
|
|
|
get_found++;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
bytes += key.size() + pinnable_val.size();
|
|
|
|
} else if (!s.IsNotFound()) {
|
|
|
|
fprintf(stderr, "Get returned an error: %s\n", s.ToString().c_str());
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
|
2022-03-22 00:30:51 +00:00
|
|
|
if (thread->shared->read_rate_limiter && (gets + seek) % 100 == 0) {
|
2021-10-14 20:23:01 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(100, Env::IO_HIGH,
|
|
|
|
nullptr /*stats*/);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
2019-03-08 22:07:19 +00:00
|
|
|
thread->stats.FinishedOps(db_with_cfh, db_with_cfh->db, 1, kRead);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
} else if (query_type == 1) {
|
|
|
|
// the Put query
|
|
|
|
puts++;
|
2020-02-12 22:44:46 +00:00
|
|
|
int64_t val_size = ParetoCdfInversion(
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
u, FLAGS_value_theta, FLAGS_value_k, FLAGS_value_sigma);
|
2022-03-22 00:30:51 +00:00
|
|
|
if (val_size < 10) {
|
2020-02-12 22:44:46 +00:00
|
|
|
val_size = 10;
|
|
|
|
} else if (val_size > value_max) {
|
|
|
|
val_size = val_size % value_max;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
2022-03-22 00:30:51 +00:00
|
|
|
total_val_size += val_size;
|
|
|
|
|
2019-01-23 06:41:49 +00:00
|
|
|
s = db_with_cfh->db->Put(
|
|
|
|
write_options_, key,
|
2020-02-12 22:44:46 +00:00
|
|
|
gen.Generate(static_cast<unsigned int>(val_size)));
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
|
|
|
|
2021-10-14 20:23:01 +00:00
|
|
|
if (thread->shared->write_rate_limiter && puts % 100 == 0) {
|
|
|
|
thread->shared->write_rate_limiter->Request(100, Env::IO_HIGH,
|
|
|
|
nullptr /*stats*/);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
2019-03-08 22:07:19 +00:00
|
|
|
thread->stats.FinishedOps(db_with_cfh, db_with_cfh->db, 1, kWrite);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
} else if (query_type == 2) {
|
|
|
|
// Seek query
|
|
|
|
if (db_with_cfh->db != nullptr) {
|
|
|
|
Iterator* single_iter = nullptr;
|
2022-02-01 03:45:17 +00:00
|
|
|
single_iter = db_with_cfh->db->NewIterator(read_options_);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
if (single_iter != nullptr) {
|
|
|
|
single_iter->Seek(key);
|
|
|
|
seek++;
|
|
|
|
if (single_iter->Valid() && single_iter->key().compare(key) == 0) {
|
|
|
|
seek_found++;
|
|
|
|
}
|
|
|
|
int64_t scan_length =
|
|
|
|
ParetoCdfInversion(u, FLAGS_iter_theta, FLAGS_iter_k,
|
|
|
|
FLAGS_iter_sigma) %
|
|
|
|
scan_len_max;
|
|
|
|
for (int64_t j = 0; j < scan_length && single_iter->Valid(); j++) {
|
|
|
|
Slice value = single_iter->value();
|
|
|
|
memcpy(value_buffer, value.data(),
|
|
|
|
std::min(value.size(), sizeof(value_buffer)));
|
|
|
|
bytes += single_iter->key().size() + single_iter->value().size();
|
|
|
|
single_iter->Next();
|
|
|
|
assert(single_iter->status().ok());
|
2022-03-22 00:30:51 +00:00
|
|
|
total_scan_length++;
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
delete single_iter;
|
|
|
|
}
|
2019-03-08 22:07:19 +00:00
|
|
|
thread->stats.FinishedOps(db_with_cfh, db_with_cfh->db, 1, kSeek);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
}
|
|
|
|
}
|
2019-01-28 18:57:57 +00:00
|
|
|
char msg[256];
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
snprintf(msg, sizeof(msg),
|
2022-03-22 00:30:51 +00:00
|
|
|
"( Gets:%" PRIu64 " Puts:%" PRIu64 " Seek:%" PRIu64
|
|
|
|
", reads %" PRIu64 " in %" PRIu64
|
|
|
|
" found, "
|
|
|
|
"avg size: %.1f value, %.1f scan)\n",
|
|
|
|
gets, puts, seek, get_found + seek_found, gets + seek,
|
|
|
|
total_val_size / puts, total_scan_length / seek);
|
Generate mixed workload with Get, Put, Seek in db_bench (#4788)
Summary:
Based on the specific workload models (key access distribution, value size distribution, and iterator scan length distribution, the QPS variation), the MixGraph benchmark generate the synthetic workload according to these distributions which can reflect the real-world workload characteristics.
After user enable the tracing function, they will get the trace file. By analyzing the trace file with the trace_analyzer tool, user can generate a set of statistic data files including. The *_accessed_key_stats.txt, *-accessed_value_size_distribution.txt, *-iterator_length_distribution.txt, and *-qps_stats.txt are mainly used to fit the Matlab model fitting. After that, user can get the parameters of the workload distributions (the modeling details are described: [here](https://github.com/facebook/rocksdb/wiki/RocksDB-Trace%2C-Replay%2C-and-Analyzer))
The key access distribution follows the The two-term power model. The probability density function is: `f(x) = ax^{b}+c`. The corresponding parameters are key_dist_a, key_dist_b, and key_dist_c in db_bench
For the value size distribution and iterator scan length distribution, they both follow the Generalized Pareto Distribution. The probability density function is `f(x) = (1/sigma)(1+k*(x-theta)/sigma))^{-1-1/k)`. The parameters are: value_k, value_theta, value_sigma and iter_k, iter_theta, iter_sigma. For more information about the Generalized Pareto Distribution, users can find the [wiki](https://en.wikipedia.org/wiki/Generalized_Pareto_distribution) and [Matalb page](https://www.mathworks.com/help/stats/generalized-pareto-distribution.html)
As for the QPS, it follows the diurnal pattern. So Sine is a good model to fit it. `F(x) = sine_a*sin(sine_b*x + sine_c) + sine_d`. The trace_will tell you the average QPS in the print out resutls, which is sine_d. After user fit the "*-qps_stats.txt" to the Matlab model, user can get the sine_a, sine_b, and sine_c. By using the 4 parameters, user can control the QPS variation including the period, average, changes.
To use the bench mark, user can indicate the following parameters as examples:
```
-benchmarks="mixgraph" -key_dist_a=0.002312 -key_dist_b=0.3467 -value_k=0.9233 -value_sigma=226.4092 -iter_k=2.517 -iter_sigma=14.236 -mix_get_ratio=0.7 -mix_put_ratio=0.25 -mix_seek_ratio=0.05 -sine_mix_rate_interval_milliseconds=500 -sine_a=15000 -sine_b=1 -sine_d=20000
```
Pull Request resolved: https://github.com/facebook/rocksdb/pull/4788
Differential Revision: D13573940
Pulled By: sagar0
fbshipit-source-id: e184c27e07b4f1bc0b436c2be36c5090c1fb0222
2019-01-22 18:40:44 +00:00
|
|
|
|
|
|
|
thread->stats.AddBytes(bytes);
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2014-02-03 21:13:36 +00:00
|
|
|
void IteratorCreation(ThreadState* thread) {
|
|
|
|
Duration duration(FLAGS_duration, reads_);
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2014-02-03 21:13:36 +00:00
|
|
|
while (!duration.Done(1)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
2014-04-11 19:15:09 +00:00
|
|
|
Iterator* iter = db->NewIterator(options);
|
2014-02-03 21:13:36 +00:00
|
|
|
delete iter;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kOthers);
|
2014-02-03 21:13:36 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-04-10 17:15:59 +00:00
|
|
|
void IteratorCreationWhileWriting(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
IteratorCreation(thread);
|
|
|
|
} else {
|
2015-12-08 01:33:18 +00:00
|
|
|
BGWriter(thread, kWrite);
|
2014-04-10 17:15:59 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-04-17 15:36:46 +00:00
|
|
|
void SeekRandom(ThreadState* thread) {
|
2014-04-08 18:21:09 +00:00
|
|
|
int64_t read = 0;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t found = 0;
|
2015-03-30 18:28:25 +00:00
|
|
|
int64_t bytes = 0;
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
2014-04-11 19:15:09 +00:00
|
|
|
|
2021-07-16 19:27:00 +00:00
|
|
|
std::vector<Iterator*> tailing_iters;
|
|
|
|
if (FLAGS_use_tailing_iterator) {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
tailing_iters.push_back(db_.db->NewIterator(options));
|
|
|
|
} else {
|
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
tailing_iters.push_back(db_with_cfh.db->NewIterator(options));
|
|
|
|
}
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
}
|
2022-05-19 20:09:03 +00:00
|
|
|
options.auto_prefix_mode = FLAGS_auto_prefix_mode;
|
2014-04-11 19:15:09 +00:00
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2018-11-14 18:39:54 +00:00
|
|
|
std::unique_ptr<const char[]> upper_bound_key_guard;
|
|
|
|
Slice upper_bound = AllocateKey(&upper_bound_key_guard);
|
|
|
|
std::unique_ptr<const char[]> lower_bound_key_guard;
|
|
|
|
Slice lower_bound = AllocateKey(&lower_bound_key_guard);
|
|
|
|
|
2014-04-08 18:21:09 +00:00
|
|
|
Duration duration(FLAGS_duration, reads_);
|
2014-10-17 17:20:25 +00:00
|
|
|
char value_buffer[256];
|
2013-03-01 19:25:13 +00:00
|
|
|
while (!duration.Done(1)) {
|
2018-11-14 18:39:54 +00:00
|
|
|
int64_t seek_pos = thread->rand.Next() % FLAGS_num;
|
2019-04-15 17:49:47 +00:00
|
|
|
GenerateKeyFromIntForSeek(static_cast<uint64_t>(seek_pos), FLAGS_num,
|
|
|
|
&key);
|
2018-11-14 18:39:54 +00:00
|
|
|
if (FLAGS_max_scan_distance != 0) {
|
|
|
|
if (FLAGS_reverse_iterator) {
|
|
|
|
GenerateKeyFromInt(
|
2018-12-13 22:12:02 +00:00
|
|
|
static_cast<uint64_t>(std::max(
|
|
|
|
static_cast<int64_t>(0), seek_pos - FLAGS_max_scan_distance)),
|
2018-11-14 18:39:54 +00:00
|
|
|
FLAGS_num, &lower_bound);
|
|
|
|
options.iterate_lower_bound = &lower_bound;
|
|
|
|
} else {
|
2019-07-01 20:02:30 +00:00
|
|
|
auto min_num =
|
2019-07-01 21:53:51 +00:00
|
|
|
std::min(FLAGS_num, seek_pos + FLAGS_max_scan_distance);
|
|
|
|
GenerateKeyFromInt(static_cast<uint64_t>(min_num), FLAGS_num,
|
|
|
|
&upper_bound);
|
2018-11-14 18:39:54 +00:00
|
|
|
options.iterate_upper_bound = &upper_bound;
|
|
|
|
}
|
2022-05-19 20:09:03 +00:00
|
|
|
} else if (FLAGS_auto_prefix_mode && prefix_extractor_ &&
|
|
|
|
!FLAGS_reverse_iterator) {
|
|
|
|
// Set upper bound to next prefix
|
|
|
|
auto mutable_upper_bound = const_cast<char*>(upper_bound.data());
|
|
|
|
std::memcpy(mutable_upper_bound, key.data(), prefix_size_);
|
|
|
|
mutable_upper_bound[prefix_size_ - 1]++;
|
|
|
|
upper_bound = Slice(upper_bound.data(), prefix_size_);
|
|
|
|
options.iterate_upper_bound = &upper_bound;
|
2018-11-14 18:39:54 +00:00
|
|
|
}
|
|
|
|
|
2021-07-16 19:27:00 +00:00
|
|
|
// Pick a Iterator to use
|
2022-04-08 20:29:19 +00:00
|
|
|
uint64_t db_idx_to_use =
|
2021-07-20 00:07:18 +00:00
|
|
|
(db_.db == nullptr)
|
2022-04-08 20:29:19 +00:00
|
|
|
? (uint64_t{thread->rand.Next()} % multi_dbs_.size())
|
2021-07-20 00:07:18 +00:00
|
|
|
: 0;
|
2021-07-16 19:27:00 +00:00
|
|
|
std::unique_ptr<Iterator> single_iter;
|
|
|
|
Iterator* iter_to_use;
|
|
|
|
if (FLAGS_use_tailing_iterator) {
|
2021-07-20 00:07:18 +00:00
|
|
|
iter_to_use = tailing_iters[db_idx_to_use];
|
2021-07-16 19:27:00 +00:00
|
|
|
} else {
|
2015-05-01 21:17:45 +00:00
|
|
|
if (db_.db != nullptr) {
|
2021-07-16 19:27:00 +00:00
|
|
|
single_iter.reset(db_.db->NewIterator(options));
|
2015-05-01 21:17:45 +00:00
|
|
|
} else {
|
2021-07-20 00:07:18 +00:00
|
|
|
single_iter.reset(multi_dbs_[db_idx_to_use].db->NewIterator(options));
|
2014-05-30 21:09:22 +00:00
|
|
|
}
|
2021-07-16 19:27:00 +00:00
|
|
|
iter_to_use = single_iter.get();
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
iter_to_use->Seek(key);
|
2014-04-08 18:21:09 +00:00
|
|
|
read++;
|
2014-04-11 19:15:09 +00:00
|
|
|
if (iter_to_use->Valid() && iter_to_use->key().compare(key) == 0) {
|
2014-04-08 18:21:09 +00:00
|
|
|
found++;
|
|
|
|
}
|
2014-10-17 17:20:25 +00:00
|
|
|
|
|
|
|
for (int j = 0; j < FLAGS_seek_nexts && iter_to_use->Valid(); ++j) {
|
|
|
|
// Copy out iterator's value to make sure we read them.
|
|
|
|
Slice value = iter_to_use->value();
|
|
|
|
memcpy(value_buffer, value.data(),
|
|
|
|
std::min(value.size(), sizeof(value_buffer)));
|
2015-03-30 18:28:25 +00:00
|
|
|
bytes += iter_to_use->key().size() + iter_to_use->value().size();
|
2015-03-18 20:50:52 +00:00
|
|
|
|
|
|
|
if (!FLAGS_reverse_iterator) {
|
|
|
|
iter_to_use->Next();
|
|
|
|
} else {
|
|
|
|
iter_to_use->Prev();
|
|
|
|
}
|
2014-10-17 17:20:25 +00:00
|
|
|
assert(iter_to_use->status().ok());
|
|
|
|
}
|
|
|
|
|
2016-12-19 20:25:35 +00:00
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr &&
|
|
|
|
read % 256 == 255) {
|
2017-06-13 21:51:22 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(
|
|
|
|
256, Env::IO_HIGH, nullptr /* stats */, RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kSeek);
|
2012-04-17 15:36:46 +00:00
|
|
|
}
|
2021-07-16 19:27:00 +00:00
|
|
|
for (auto iter : tailing_iters) {
|
2014-04-11 19:15:09 +00:00
|
|
|
delete iter;
|
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2012-04-17 15:36:46 +00:00
|
|
|
char msg[100];
|
2014-05-30 21:31:55 +00:00
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " of %" PRIu64 " found)\n",
|
2014-04-08 18:21:09 +00:00
|
|
|
found, read);
|
2015-03-30 18:28:25 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2012-04-17 15:36:46 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
2014-04-11 16:47:20 +00:00
|
|
|
|
|
|
|
void SeekRandomWhileWriting(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
SeekRandom(thread);
|
|
|
|
} else {
|
2015-12-08 01:33:18 +00:00
|
|
|
BGWriter(thread, kWrite);
|
2014-04-11 16:47:20 +00:00
|
|
|
}
|
|
|
|
}
|
2012-04-17 15:36:46 +00:00
|
|
|
|
2015-03-30 18:28:25 +00:00
|
|
|
void SeekRandomWhileMerging(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
SeekRandom(thread);
|
|
|
|
} else {
|
|
|
|
BGWriter(thread, kMerge);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-04-17 15:36:46 +00:00
|
|
|
void DoDelete(ThreadState* thread, bool seq) {
|
2020-09-16 03:04:58 +00:00
|
|
|
WriteBatch batch(/*reserved_bytes=*/0, /*max_bytes=*/0,
|
2022-06-15 20:43:58 +00:00
|
|
|
FLAGS_write_batch_protection_bytes_per_key,
|
|
|
|
user_timestamp_size_);
|
2016-06-28 21:10:24 +00:00
|
|
|
Duration duration(seq ? 0 : FLAGS_duration, deletes_);
|
2014-04-08 18:21:09 +00:00
|
|
|
int64_t i = 0;
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2013-03-01 19:25:13 +00:00
|
|
|
while (!duration.Done(entries_per_batch_)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2012-04-17 15:36:46 +00:00
|
|
|
batch.Clear();
|
2014-04-08 18:21:09 +00:00
|
|
|
for (int64_t j = 0; j < entries_per_batch_; ++j) {
|
|
|
|
const int64_t k = seq ? i + j : (thread->rand.Next() % FLAGS_num);
|
|
|
|
GenerateKeyFromInt(k, FLAGS_num, &key);
|
2014-03-05 01:08:05 +00:00
|
|
|
batch.Delete(key);
|
2012-04-17 15:36:46 +00:00
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
Status s;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = batch.UpdateTimestamps(
|
|
|
|
ts, [this](uint32_t) { return user_timestamp_size_; });
|
2020-09-16 03:04:58 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "assign timestamp: %s\n", s.ToString().c_str());
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
s = db->Write(write_options_, &batch);
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, entries_per_batch_, kDelete);
|
2012-04-17 15:36:46 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "del error: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
i += entries_per_batch_;
|
2012-04-17 15:36:46 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void DeleteSeq(ThreadState* thread) {
|
|
|
|
DoDelete(thread, true);
|
|
|
|
}
|
|
|
|
|
|
|
|
void DeleteRandom(ThreadState* thread) {
|
|
|
|
DoDelete(thread, false);
|
|
|
|
}
|
|
|
|
|
2011-09-01 19:08:02 +00:00
|
|
|
void ReadWhileWriting(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
ReadRandom(thread);
|
|
|
|
} else {
|
2015-12-08 01:33:18 +00:00
|
|
|
BGWriter(thread, kWrite);
|
2014-04-10 17:15:59 +00:00
|
|
|
}
|
|
|
|
}
|
2011-09-01 19:08:02 +00:00
|
|
|
|
2015-03-18 20:50:52 +00:00
|
|
|
void ReadWhileMerging(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
ReadRandom(thread);
|
|
|
|
} else {
|
|
|
|
BGWriter(thread, kMerge);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
void BGWriter(ThreadState* thread, enum OperationType write_merge) {
|
2014-04-10 17:15:59 +00:00
|
|
|
// Special thread that keeps writing until other threads are done.
|
|
|
|
RandomGenerator gen;
|
2015-03-30 18:28:25 +00:00
|
|
|
int64_t bytes = 0;
|
2014-04-10 17:15:59 +00:00
|
|
|
|
2016-01-04 20:01:27 +00:00
|
|
|
std::unique_ptr<RateLimiter> write_rate_limiter;
|
|
|
|
if (FLAGS_benchmark_write_rate_limit > 0) {
|
|
|
|
write_rate_limiter.reset(
|
|
|
|
NewGenericRateLimiter(FLAGS_benchmark_write_rate_limit));
|
|
|
|
}
|
2014-04-10 17:15:59 +00:00
|
|
|
|
|
|
|
// Don't merge stats from this thread with the readers.
|
|
|
|
thread->stats.SetExcludeFromMerge();
|
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2017-04-07 18:25:42 +00:00
|
|
|
uint32_t written = 0;
|
|
|
|
bool hint_printed = false;
|
2014-04-10 17:15:59 +00:00
|
|
|
|
|
|
|
while (true) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2014-04-10 17:15:59 +00:00
|
|
|
{
|
|
|
|
MutexLock l(&thread->shared->mu);
|
2017-04-07 18:25:42 +00:00
|
|
|
if (FLAGS_finish_after_writes && written == writes_) {
|
|
|
|
fprintf(stderr, "Exiting the writer after %u writes...\n", written);
|
|
|
|
break;
|
|
|
|
}
|
2014-04-10 17:15:59 +00:00
|
|
|
if (thread->shared->num_done + 1 >= thread->shared->num_initialized) {
|
|
|
|
// Other threads have finished
|
2017-04-07 18:25:42 +00:00
|
|
|
if (FLAGS_finish_after_writes) {
|
|
|
|
// Wait for the writes to be finished
|
|
|
|
if (!hint_printed) {
|
|
|
|
fprintf(stderr, "Reads are finished. Have %d more writes to do\n",
|
2019-07-01 20:02:30 +00:00
|
|
|
static_cast<int>(writes_) - written);
|
2017-04-07 18:25:42 +00:00
|
|
|
hint_printed = true;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
// Finish the write immediately
|
|
|
|
break;
|
|
|
|
}
|
2011-09-01 19:08:02 +00:00
|
|
|
}
|
2014-04-10 17:15:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
GenerateKeyFromInt(thread->rand.Next() % FLAGS_num, FLAGS_num, &key);
|
2015-03-18 20:50:52 +00:00
|
|
|
Status s;
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice val = gen.Generate();
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
}
|
2015-12-08 01:33:18 +00:00
|
|
|
if (write_merge == kWrite) {
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
if (user_timestamp_size_ == 0) {
|
|
|
|
s = db->Put(write_options_, key, val);
|
|
|
|
} else {
|
|
|
|
s = db->Put(write_options_, key, ts, val);
|
|
|
|
}
|
2015-03-18 20:50:52 +00:00
|
|
|
} else {
|
2020-02-12 22:44:46 +00:00
|
|
|
s = db->Merge(write_options_, key, val);
|
2015-03-18 20:50:52 +00:00
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
// Restore write_options_
|
2017-04-07 18:25:42 +00:00
|
|
|
written++;
|
2015-03-18 20:50:52 +00:00
|
|
|
|
2014-04-10 17:15:59 +00:00
|
|
|
if (!s.ok()) {
|
2015-03-18 20:50:52 +00:00
|
|
|
fprintf(stderr, "put or merge error: %s\n", s.ToString().c_str());
|
2014-04-10 17:15:59 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
bytes += key.size() + val.size() + user_timestamp_size_;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kWrite);
|
2013-04-17 17:56:39 +00:00
|
|
|
|
2016-01-04 20:01:27 +00:00
|
|
|
if (FLAGS_benchmark_write_rate_limit > 0) {
|
|
|
|
write_rate_limiter->Request(
|
2020-02-12 22:44:46 +00:00
|
|
|
key.size() + val.size(), Env::IO_HIGH,
|
2017-06-13 21:51:22 +00:00
|
|
|
nullptr /* stats */, RateLimiter::OpType::kWrite);
|
2011-09-01 19:08:02 +00:00
|
|
|
}
|
|
|
|
}
|
2015-03-30 18:28:25 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2011-09-01 19:08:02 +00:00
|
|
|
}
|
|
|
|
|
2018-05-24 22:45:49 +00:00
|
|
|
void ReadWhileScanning(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
ReadRandom(thread);
|
|
|
|
} else {
|
|
|
|
BGScan(thread);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void BGScan(ThreadState* thread) {
|
|
|
|
if (FLAGS_num_multi_db > 0) {
|
|
|
|
fprintf(stderr, "Not supporting multiple DBs.\n");
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
assert(db_.db != nullptr);
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions read_options = read_options_;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
read_options.timestamp = &ts;
|
|
|
|
}
|
2018-05-24 22:45:49 +00:00
|
|
|
Iterator* iter = db_.db->NewIterator(read_options);
|
|
|
|
|
2018-05-31 00:45:02 +00:00
|
|
|
fprintf(stderr, "num reads to do %" PRIu64 "\n", reads_);
|
2018-05-24 22:45:49 +00:00
|
|
|
Duration duration(FLAGS_duration, reads_);
|
|
|
|
uint64_t num_seek_to_first = 0;
|
|
|
|
uint64_t num_next = 0;
|
|
|
|
while (!duration.Done(1)) {
|
|
|
|
if (!iter->Valid()) {
|
|
|
|
iter->SeekToFirst();
|
|
|
|
num_seek_to_first++;
|
|
|
|
} else if (!iter->status().ok()) {
|
|
|
|
fprintf(stderr, "Iterator error: %s\n",
|
|
|
|
iter->status().ToString().c_str());
|
|
|
|
abort();
|
|
|
|
} else {
|
|
|
|
iter->Next();
|
|
|
|
num_next++;
|
|
|
|
}
|
|
|
|
|
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kSeek);
|
|
|
|
}
|
|
|
|
delete iter;
|
|
|
|
}
|
|
|
|
|
2013-02-20 01:51:06 +00:00
|
|
|
// Given a key K and value V, this puts (K+"0", V), (K+"1", V), (K+"2", V)
|
2013-06-12 19:42:21 +00:00
|
|
|
// in DB atomically i.e in a single batch. Also refer GetMany.
|
2014-04-11 19:15:09 +00:00
|
|
|
Status PutMany(DB* db, const WriteOptions& writeoptions, const Slice& key,
|
|
|
|
const Slice& value) {
|
2013-02-20 01:51:06 +00:00
|
|
|
std::string suffixes[3] = {"2", "1", "0"};
|
|
|
|
std::string keys[3];
|
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
WriteBatch batch(/*reserved_bytes=*/0, /*max_bytes=*/0,
|
2022-06-15 20:43:58 +00:00
|
|
|
FLAGS_write_batch_protection_bytes_per_key,
|
|
|
|
user_timestamp_size_);
|
2013-02-20 01:51:06 +00:00
|
|
|
Status s;
|
|
|
|
for (int i = 0; i < 3; i++) {
|
|
|
|
keys[i] = key.ToString() + suffixes[i];
|
|
|
|
batch.Put(keys[i], value);
|
|
|
|
}
|
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
Slice ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = batch.UpdateTimestamps(
|
|
|
|
ts, [this](uint32_t) { return user_timestamp_size_; });
|
2020-09-16 03:04:58 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "assign timestamp to batch: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
s = db->Write(writeoptions, &batch);
|
2013-02-20 01:51:06 +00:00
|
|
|
return s;
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// Given a key K, this deletes (K+"0", V), (K+"1", V), (K+"2", V)
|
2013-06-12 19:42:21 +00:00
|
|
|
// in DB atomically i.e in a single batch. Also refer GetMany.
|
2014-04-11 19:15:09 +00:00
|
|
|
Status DeleteMany(DB* db, const WriteOptions& writeoptions,
|
|
|
|
const Slice& key) {
|
2013-02-20 01:51:06 +00:00
|
|
|
std::string suffixes[3] = {"1", "2", "0"};
|
|
|
|
std::string keys[3];
|
|
|
|
|
2022-06-15 20:43:58 +00:00
|
|
|
WriteBatch batch(0, 0, FLAGS_write_batch_protection_bytes_per_key,
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
user_timestamp_size_);
|
2013-02-20 01:51:06 +00:00
|
|
|
Status s;
|
|
|
|
for (int i = 0; i < 3; i++) {
|
|
|
|
keys[i] = key.ToString() + suffixes[i];
|
|
|
|
batch.Delete(keys[i]);
|
|
|
|
}
|
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
Slice ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = batch.UpdateTimestamps(
|
|
|
|
ts, [this](uint32_t) { return user_timestamp_size_; });
|
2020-09-16 03:04:58 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "assign timestamp to batch: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
ErrorExit();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
s = db->Write(writeoptions, &batch);
|
2013-02-20 01:51:06 +00:00
|
|
|
return s;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Given a key K and value V, this gets values for K+"0", K+"1" and K+"2"
|
|
|
|
// in the same snapshot, and verifies that all the values are identical.
|
2013-06-12 19:42:21 +00:00
|
|
|
// ASSUMES that PutMany was used to put (K, V) into the DB.
|
2022-02-01 03:45:17 +00:00
|
|
|
Status GetMany(DB* db, const Slice& key, std::string* value) {
|
2013-02-20 01:51:06 +00:00
|
|
|
std::string suffixes[3] = {"0", "1", "2"};
|
|
|
|
std::string keys[3];
|
|
|
|
Slice key_slices[3];
|
|
|
|
std::string values[3];
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions readoptionscopy = read_options_;
|
2020-09-16 03:04:58 +00:00
|
|
|
|
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
readoptionscopy.timestamp = &ts;
|
|
|
|
}
|
|
|
|
|
2014-04-11 19:15:09 +00:00
|
|
|
readoptionscopy.snapshot = db->GetSnapshot();
|
2013-02-20 01:51:06 +00:00
|
|
|
Status s;
|
|
|
|
for (int i = 0; i < 3; i++) {
|
|
|
|
keys[i] = key.ToString() + suffixes[i];
|
|
|
|
key_slices[i] = keys[i];
|
2014-04-11 19:15:09 +00:00
|
|
|
s = db->Get(readoptionscopy, key_slices[i], value);
|
2013-02-20 01:51:06 +00:00
|
|
|
if (!s.ok() && !s.IsNotFound()) {
|
|
|
|
fprintf(stderr, "get error: %s\n", s.ToString().c_str());
|
|
|
|
values[i] = "";
|
|
|
|
// we continue after error rather than exiting so that we can
|
|
|
|
// find more errors if any
|
|
|
|
} else if (s.IsNotFound()) {
|
|
|
|
values[i] = "";
|
|
|
|
} else {
|
|
|
|
values[i] = *value;
|
|
|
|
}
|
|
|
|
}
|
2014-04-11 19:15:09 +00:00
|
|
|
db->ReleaseSnapshot(readoptionscopy.snapshot);
|
2013-02-20 01:51:06 +00:00
|
|
|
|
|
|
|
if ((values[0] != values[1]) || (values[1] != values[2])) {
|
|
|
|
fprintf(stderr, "inconsistent values for key %s: %s, %s, %s\n",
|
|
|
|
key.ToString().c_str(), values[0].c_str(), values[1].c_str(),
|
|
|
|
values[2].c_str());
|
|
|
|
// we continue after error rather than exiting so that we can
|
|
|
|
// find more errors if any
|
|
|
|
}
|
|
|
|
|
|
|
|
return s;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Differs from readrandomwriterandom in the following ways:
|
2013-06-12 19:42:21 +00:00
|
|
|
// (a) Uses GetMany/PutMany to read/write key values. Refer to those funcs.
|
2013-02-20 01:51:06 +00:00
|
|
|
// (b) Does deletes as well (per FLAGS_deletepercent)
|
|
|
|
// (c) In order to achieve high % of 'found' during lookups, and to do
|
|
|
|
// multiple writes (including puts and deletes) it uses upto
|
|
|
|
// FLAGS_numdistinct distinct keys instead of FLAGS_num distinct keys.
|
2013-06-12 19:42:21 +00:00
|
|
|
// (d) Does not have a MultiGet option.
|
2013-02-20 01:51:06 +00:00
|
|
|
void RandomWithVerify(ThreadState* thread) {
|
|
|
|
RandomGenerator gen;
|
|
|
|
std::string value;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t found = 0;
|
2013-02-20 01:51:06 +00:00
|
|
|
int get_weight = 0;
|
|
|
|
int put_weight = 0;
|
|
|
|
int delete_weight = 0;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t gets_done = 0;
|
|
|
|
int64_t puts_done = 0;
|
|
|
|
int64_t deletes_done = 0;
|
2013-06-12 19:42:21 +00:00
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2013-02-20 01:51:06 +00:00
|
|
|
// the number of iterations is the larger of read_ or write_
|
2014-03-05 01:08:05 +00:00
|
|
|
for (int64_t i = 0; i < readwrites_; i++) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2013-02-20 01:51:06 +00:00
|
|
|
if (get_weight == 0 && put_weight == 0 && delete_weight == 0) {
|
2013-06-12 19:42:21 +00:00
|
|
|
// one batch completed, reinitialize for next batch
|
2013-02-20 01:51:06 +00:00
|
|
|
get_weight = FLAGS_readwritepercent;
|
|
|
|
delete_weight = FLAGS_deletepercent;
|
|
|
|
put_weight = 100 - get_weight - delete_weight;
|
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
GenerateKeyFromInt(thread->rand.Next() % FLAGS_numdistinct,
|
|
|
|
FLAGS_numdistinct, &key);
|
2013-02-20 01:51:06 +00:00
|
|
|
if (get_weight > 0) {
|
|
|
|
// do all the gets first
|
2022-02-01 03:45:17 +00:00
|
|
|
Status s = GetMany(db, key, &value);
|
2013-02-20 01:51:06 +00:00
|
|
|
if (!s.ok() && !s.IsNotFound()) {
|
2013-06-12 19:42:21 +00:00
|
|
|
fprintf(stderr, "getmany error: %s\n", s.ToString().c_str());
|
2013-02-20 01:51:06 +00:00
|
|
|
// we continue after error rather than exiting so that we can
|
|
|
|
// find more errors if any
|
|
|
|
} else if (!s.IsNotFound()) {
|
|
|
|
found++;
|
|
|
|
}
|
|
|
|
get_weight--;
|
|
|
|
gets_done++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kRead);
|
2013-02-20 01:51:06 +00:00
|
|
|
} else if (put_weight > 0) {
|
|
|
|
// then do all the corresponding number of puts
|
|
|
|
// for all the gets we have done earlier
|
2020-02-12 22:44:46 +00:00
|
|
|
Status s = PutMany(db, write_options_, key, gen.Generate());
|
2013-02-20 01:51:06 +00:00
|
|
|
if (!s.ok()) {
|
2013-06-12 19:42:21 +00:00
|
|
|
fprintf(stderr, "putmany error: %s\n", s.ToString().c_str());
|
2013-02-20 01:51:06 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
put_weight--;
|
|
|
|
puts_done++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kWrite);
|
2013-02-20 01:51:06 +00:00
|
|
|
} else if (delete_weight > 0) {
|
2014-04-11 19:15:09 +00:00
|
|
|
Status s = DeleteMany(db, write_options_, key);
|
2013-02-20 01:51:06 +00:00
|
|
|
if (!s.ok()) {
|
2013-06-12 19:42:21 +00:00
|
|
|
fprintf(stderr, "deletemany error: %s\n", s.ToString().c_str());
|
2013-02-20 01:51:06 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
delete_weight--;
|
|
|
|
deletes_done++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kDelete);
|
2013-02-20 01:51:06 +00:00
|
|
|
}
|
|
|
|
}
|
2017-07-11 17:28:18 +00:00
|
|
|
char msg[128];
|
2013-08-23 05:37:13 +00:00
|
|
|
snprintf(msg, sizeof(msg),
|
2014-03-05 01:08:05 +00:00
|
|
|
"( get:%" PRIu64 " put:%" PRIu64 " del:%" PRIu64 " total:%" \
|
|
|
|
PRIu64 " found:%" PRIu64 ")",
|
2013-02-20 01:51:06 +00:00
|
|
|
gets_done, puts_done, deletes_done, readwrites_, found);
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2013-08-13 20:58:02 +00:00
|
|
|
// This is different from ReadWhileWriting because it does not use
|
2012-09-26 15:06:19 +00:00
|
|
|
// an extra thread.
|
2012-08-31 06:06:17 +00:00
|
|
|
void ReadRandomWriteRandom(ThreadState* thread) {
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2012-08-31 06:06:17 +00:00
|
|
|
RandomGenerator gen;
|
|
|
|
std::string value;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t found = 0;
|
2012-08-31 06:06:17 +00:00
|
|
|
int get_weight = 0;
|
|
|
|
int put_weight = 0;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t reads_done = 0;
|
|
|
|
int64_t writes_done = 0;
|
2013-03-01 19:25:13 +00:00
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
|
|
|
|
2012-08-31 06:06:17 +00:00
|
|
|
// the number of iterations is the larger of read_ or write_
|
2013-03-01 19:25:13 +00:00
|
|
|
while (!duration.Done(1)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2014-04-08 18:21:09 +00:00
|
|
|
GenerateKeyFromInt(thread->rand.Next() % FLAGS_num, FLAGS_num, &key);
|
2012-08-31 06:06:17 +00:00
|
|
|
if (get_weight == 0 && put_weight == 0) {
|
2013-08-13 20:58:02 +00:00
|
|
|
// one batch completed, reinitialize for next batch
|
2012-08-31 06:06:17 +00:00
|
|
|
get_weight = FLAGS_readwritepercent;
|
|
|
|
put_weight = 100 - get_weight;
|
|
|
|
}
|
|
|
|
if (get_weight > 0) {
|
|
|
|
// do all the gets first
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand,
|
|
|
|
ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
2014-04-11 19:15:09 +00:00
|
|
|
Status s = db->Get(options, key, &value);
|
2013-02-20 01:51:06 +00:00
|
|
|
if (!s.ok() && !s.IsNotFound()) {
|
|
|
|
fprintf(stderr, "get error: %s\n", s.ToString().c_str());
|
|
|
|
// we continue after error rather than exiting so that we can
|
|
|
|
// find more errors if any
|
|
|
|
} else if (!s.IsNotFound()) {
|
|
|
|
found++;
|
|
|
|
}
|
2012-08-31 06:06:17 +00:00
|
|
|
get_weight--;
|
|
|
|
reads_done++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kRead);
|
2012-08-31 06:06:17 +00:00
|
|
|
} else if (put_weight > 0) {
|
|
|
|
// then do all the corresponding number of puts
|
|
|
|
// for all the gets we have done earlier
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Status s;
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Slice ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
s = db->Put(write_options_, key, ts, gen.Generate());
|
|
|
|
} else {
|
|
|
|
s = db->Put(write_options_, key, gen.Generate());
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
2012-08-31 06:06:17 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2012-08-31 06:06:17 +00:00
|
|
|
}
|
|
|
|
put_weight--;
|
|
|
|
writes_done++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kWrite);
|
2012-08-31 06:06:17 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
char msg[100];
|
2014-03-05 01:08:05 +00:00
|
|
|
snprintf(msg, sizeof(msg), "( reads:%" PRIu64 " writes:%" PRIu64 \
|
|
|
|
" total:%" PRIu64 " found:%" PRIu64 ")",
|
2013-02-20 01:51:06 +00:00
|
|
|
reads_done, writes_done, readwrites_, found);
|
2012-08-31 06:06:17 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2013-03-01 19:25:13 +00:00
|
|
|
//
|
|
|
|
// Read-modify-write for random keys
|
|
|
|
void UpdateRandom(ThreadState* thread) {
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2013-03-01 19:25:13 +00:00
|
|
|
RandomGenerator gen;
|
|
|
|
std::string value;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t found = 0;
|
2015-03-30 18:28:25 +00:00
|
|
|
int64_t bytes = 0;
|
2013-03-01 19:25:13 +00:00
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2013-03-01 19:25:13 +00:00
|
|
|
// the number of iterations is the larger of read_ or write_
|
|
|
|
while (!duration.Done(1)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2014-04-08 18:21:09 +00:00
|
|
|
GenerateKeyFromInt(thread->rand.Next() % FLAGS_num, FLAGS_num, &key);
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
// Read with newest timestamp because we are doing rmw.
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
2013-03-01 19:25:13 +00:00
|
|
|
|
2015-01-22 02:18:15 +00:00
|
|
|
auto status = db->Get(options, key, &value);
|
|
|
|
if (status.ok()) {
|
|
|
|
++found;
|
2020-09-16 03:04:58 +00:00
|
|
|
bytes += key.size() + value.size() + user_timestamp_size_;
|
2015-01-22 02:18:15 +00:00
|
|
|
} else if (!status.IsNotFound()) {
|
2015-01-22 02:23:12 +00:00
|
|
|
fprintf(stderr, "Get returned an error: %s\n",
|
|
|
|
status.ToString().c_str());
|
2015-01-22 02:18:15 +00:00
|
|
|
abort();
|
2013-03-01 19:25:13 +00:00
|
|
|
}
|
|
|
|
|
2017-07-13 23:25:53 +00:00
|
|
|
if (thread->shared->write_rate_limiter) {
|
|
|
|
thread->shared->write_rate_limiter->Request(
|
2020-02-12 22:44:46 +00:00
|
|
|
key.size() + value.size(), Env::IO_HIGH, nullptr /*stats*/,
|
2017-07-13 23:25:53 +00:00
|
|
|
RateLimiter::OpType::kWrite);
|
|
|
|
}
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice val = gen.Generate();
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Status s;
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = db->Put(write_options_, key, ts, val);
|
|
|
|
} else {
|
|
|
|
s = db->Put(write_options_, key, val);
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
2013-03-01 19:25:13 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
bytes += key.size() + val.size() + user_timestamp_size_;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kUpdate);
|
2013-03-01 19:25:13 +00:00
|
|
|
}
|
|
|
|
char msg[100];
|
2013-08-23 05:37:13 +00:00
|
|
|
snprintf(msg, sizeof(msg),
|
2014-03-05 01:08:05 +00:00
|
|
|
"( updates:%" PRIu64 " found:%" PRIu64 ")", readwrites_, found);
|
2015-03-30 18:28:25 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
2013-03-01 19:25:13 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2018-03-06 18:20:52 +00:00
|
|
|
// Read-XOR-write for random keys. Xors the existing value with a randomly
|
|
|
|
// generated value, and stores the result. Assuming A in the array of bytes
|
|
|
|
// representing the existing value, we generate an array B of the same size,
|
|
|
|
// then compute C = A^B as C[i]=A[i]^B[i], and store C
|
|
|
|
void XORUpdateRandom(ThreadState* thread) {
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
2018-03-06 18:20:52 +00:00
|
|
|
RandomGenerator gen;
|
|
|
|
std::string existing_value;
|
|
|
|
int64_t found = 0;
|
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
|
|
|
|
|
|
|
BytesXOROperator xor_operator;
|
|
|
|
|
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
2018-03-06 18:20:52 +00:00
|
|
|
// the number of iterations is the larger of read_ or write_
|
|
|
|
while (!duration.Done(1)) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
GenerateKeyFromInt(thread->rand.Next() % FLAGS_num, FLAGS_num, &key);
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
2018-03-06 18:20:52 +00:00
|
|
|
|
|
|
|
auto status = db->Get(options, key, &existing_value);
|
|
|
|
if (status.ok()) {
|
|
|
|
++found;
|
|
|
|
} else if (!status.IsNotFound()) {
|
|
|
|
fprintf(stderr, "Get returned an error: %s\n",
|
|
|
|
status.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice value = gen.Generate(static_cast<unsigned int>(existing_value.size()));
|
2018-03-06 18:20:52 +00:00
|
|
|
std::string new_value;
|
|
|
|
|
|
|
|
if (status.ok()) {
|
|
|
|
Slice existing_value_slice = Slice(existing_value);
|
|
|
|
xor_operator.XOR(&existing_value_slice, value, &new_value);
|
|
|
|
} else {
|
|
|
|
xor_operator.XOR(nullptr, value, &new_value);
|
|
|
|
}
|
|
|
|
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Status s;
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = db->Put(write_options_, key, ts, Slice(new_value));
|
|
|
|
} else {
|
|
|
|
s = db->Put(write_options_, key, Slice(new_value));
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
2018-03-06 18:20:52 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2018-03-06 18:20:52 +00:00
|
|
|
}
|
|
|
|
thread->stats.FinishedOps(nullptr, db, 1);
|
|
|
|
}
|
|
|
|
char msg[100];
|
|
|
|
snprintf(msg, sizeof(msg),
|
|
|
|
"( updates:%" PRIu64 " found:%" PRIu64 ")", readwrites_, found);
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
// Read-modify-write for random keys.
|
|
|
|
// Each operation causes the key grow by value_size (simulating an append).
|
|
|
|
// Generally used for benchmarking against merges of similar type
|
|
|
|
void AppendRandom(ThreadState* thread) {
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions options = read_options_;
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
RandomGenerator gen;
|
|
|
|
std::string value;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t found = 0;
|
2015-03-30 18:28:25 +00:00
|
|
|
int64_t bytes = 0;
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
// The number of iterations is the larger of read_ or write_
|
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
|
|
|
while (!duration.Done(1)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2014-04-08 18:21:09 +00:00
|
|
|
GenerateKeyFromInt(thread->rand.Next() % FLAGS_num, FLAGS_num, &key);
|
2020-09-16 03:04:58 +00:00
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
options.timestamp = &ts;
|
|
|
|
}
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
|
2015-01-22 02:18:15 +00:00
|
|
|
auto status = db->Get(options, key, &value);
|
|
|
|
if (status.ok()) {
|
|
|
|
++found;
|
2020-09-16 03:04:58 +00:00
|
|
|
bytes += key.size() + value.size() + user_timestamp_size_;
|
2015-01-22 02:18:15 +00:00
|
|
|
} else if (!status.IsNotFound()) {
|
2015-01-22 02:23:12 +00:00
|
|
|
fprintf(stderr, "Get returned an error: %s\n",
|
|
|
|
status.ToString().c_str());
|
2015-01-22 02:18:15 +00:00
|
|
|
abort();
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
} else {
|
|
|
|
// If not existing, then just assume an empty string of data
|
|
|
|
value.clear();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Update the value (by appending data)
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice operand = gen.Generate();
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
if (value.size() > 0) {
|
2015-08-11 18:46:15 +00:00
|
|
|
// Use a delimiter to match the semantics for StringAppendOperator
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
value.append(1,',');
|
|
|
|
}
|
|
|
|
value.append(operand.data(), operand.size());
|
|
|
|
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Status s;
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts = mock_app_clock_->Allocate(ts_guard.get());
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
s = db->Put(write_options_, key, ts, value);
|
|
|
|
} else {
|
|
|
|
// Write back to the database
|
|
|
|
s = db->Put(write_options_, key, value);
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
}
|
2020-09-16 03:04:58 +00:00
|
|
|
bytes += key.size() + value.size() + user_timestamp_size_;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kUpdate);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
char msg[100];
|
2014-03-05 01:08:05 +00:00
|
|
|
snprintf(msg, sizeof(msg), "( updates:%" PRIu64 " found:%" PRIu64 ")",
|
|
|
|
readwrites_, found);
|
2015-03-30 18:28:25 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
|
|
|
// Read-modify-write for random keys (using MergeOperator)
|
|
|
|
// The merge operator to use should be defined by FLAGS_merge_operator
|
|
|
|
// Adjust FLAGS_value_size so that the keys are reasonable for this operator
|
|
|
|
// Assumes that the merge operator is non-null (i.e.: is well-defined)
|
|
|
|
//
|
|
|
|
// For example, use FLAGS_merge_operator="uint64add" and FLAGS_value_size=8
|
|
|
|
// to simulate random additions over 64-bit integers using merge.
|
2014-01-11 01:33:56 +00:00
|
|
|
//
|
|
|
|
// The number of merges on the same key can be controlled by adjusting
|
|
|
|
// FLAGS_merge_keys.
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
void MergeRandom(ThreadState* thread) {
|
|
|
|
RandomGenerator gen;
|
2015-03-30 18:28:25 +00:00
|
|
|
int64_t bytes = 0;
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
// The number of iterations is the larger of read_ or write_
|
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
|
|
|
while (!duration.Done(1)) {
|
2018-07-20 22:44:00 +00:00
|
|
|
DBWithColumnFamilies* db_with_cfh = SelectDBWithCfh(thread);
|
|
|
|
int64_t key_rand = thread->rand.Next() % merge_keys_;
|
|
|
|
GenerateKeyFromInt(key_rand, merge_keys_, &key);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
|
2018-07-20 22:44:00 +00:00
|
|
|
Status s;
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice val = gen.Generate();
|
2018-07-20 22:44:00 +00:00
|
|
|
if (FLAGS_num_column_families > 1) {
|
|
|
|
s = db_with_cfh->db->Merge(write_options_,
|
|
|
|
db_with_cfh->GetCfh(key_rand), key,
|
2020-02-12 22:44:46 +00:00
|
|
|
val);
|
2018-07-20 22:44:00 +00:00
|
|
|
} else {
|
|
|
|
s = db_with_cfh->db->Merge(write_options_,
|
|
|
|
db_with_cfh->db->DefaultColumnFamily(), key,
|
2020-02-12 22:44:46 +00:00
|
|
|
val);
|
2018-07-20 22:44:00 +00:00
|
|
|
}
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "merge error: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
2020-02-12 22:44:46 +00:00
|
|
|
bytes += key.size() + val.size();
|
2018-07-20 22:44:00 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db_with_cfh->db, 1, kMerge);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// Print some statistics
|
|
|
|
char msg[100];
|
2014-03-05 01:08:05 +00:00
|
|
|
snprintf(msg, sizeof(msg), "( updates:%" PRIu64 ")", readwrites_);
|
2015-03-30 18:28:25 +00:00
|
|
|
thread->stats.AddBytes(bytes);
|
Benchmarking for Merge Operator
Summary:
Updated db_bench and utilities/merge_operators.h to allow for dynamic benchmarking
of merge operators in db_bench. Added a new test (--benchmarks=mergerandom), which performs
a bunch of random Merge() operations over random keys. Also added a "--merge_operator=" flag
so that the tester can easily benchmark different merge operators. Currently supports
the PutOperator and UInt64Add operator. Support for stringappend or list append may come later.
Test Plan:
1. make db_bench
2. Test the PutOperator (simulating Put) as follows:
./db_bench --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom --merge_operator=put
--threads=2
3. Test the UInt64AddOperator (simulating numeric addition) similarly:
./db_bench --value_size=8 --benchmarks=fillrandom,readrandom,updaterandom,readrandom,mergerandom,readrandom
--merge_operator=uint64add --threads=2
Reviewers: haobo, dhruba, zshao, MarkCallaghan
Reviewed By: haobo
CC: leveldb
Differential Revision: https://reviews.facebook.net/D11535
2013-08-16 00:13:07 +00:00
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2014-01-11 01:33:56 +00:00
|
|
|
// Read and merge random keys. The amount of reads and merges are controlled
|
|
|
|
// by adjusting FLAGS_num and FLAGS_mergereadpercent. The number of distinct
|
|
|
|
// keys (and thus also the number of reads and merges on the same key) can be
|
|
|
|
// adjusted with FLAGS_merge_keys.
|
|
|
|
//
|
|
|
|
// As with MergeRandom, the merge operator to use should be defined by
|
|
|
|
// FLAGS_merge_operator.
|
|
|
|
void ReadRandomMergeRandom(ThreadState* thread) {
|
|
|
|
RandomGenerator gen;
|
|
|
|
std::string value;
|
2014-03-05 01:08:05 +00:00
|
|
|
int64_t num_hits = 0;
|
|
|
|
int64_t num_gets = 0;
|
|
|
|
int64_t num_merges = 0;
|
2014-01-11 01:33:56 +00:00
|
|
|
size_t max_length = 0;
|
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2014-01-11 01:33:56 +00:00
|
|
|
// the number of iterations is the larger of read_ or write_
|
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
|
|
|
while (!duration.Done(1)) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2014-04-08 18:21:09 +00:00
|
|
|
GenerateKeyFromInt(thread->rand.Next() % merge_keys_, merge_keys_, &key);
|
2014-01-11 01:33:56 +00:00
|
|
|
|
|
|
|
bool do_merge = int(thread->rand.Next() % 100) < FLAGS_mergereadpercent;
|
|
|
|
|
|
|
|
if (do_merge) {
|
2020-02-12 22:44:46 +00:00
|
|
|
Status s = db->Merge(write_options_, key, gen.Generate());
|
2014-01-11 01:33:56 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "merge error: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
num_merges++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kMerge);
|
2014-01-11 01:33:56 +00:00
|
|
|
} else {
|
2022-02-01 03:45:17 +00:00
|
|
|
Status s = db->Get(read_options_, key, &value);
|
2014-01-11 01:33:56 +00:00
|
|
|
if (value.length() > max_length)
|
|
|
|
max_length = value.length();
|
|
|
|
|
|
|
|
if (!s.ok() && !s.IsNotFound()) {
|
|
|
|
fprintf(stderr, "get error: %s\n", s.ToString().c_str());
|
|
|
|
// we continue after error rather than exiting so that we can
|
|
|
|
// find more errors if any
|
|
|
|
} else if (!s.IsNotFound()) {
|
|
|
|
num_hits++;
|
|
|
|
}
|
|
|
|
num_gets++;
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kRead);
|
2014-01-11 01:33:56 +00:00
|
|
|
}
|
|
|
|
}
|
2014-04-08 18:21:09 +00:00
|
|
|
|
2014-01-11 01:33:56 +00:00
|
|
|
char msg[100];
|
|
|
|
snprintf(msg, sizeof(msg),
|
2015-07-13 19:11:05 +00:00
|
|
|
"(reads:%" PRIu64 " merges:%" PRIu64 " total:%" PRIu64
|
|
|
|
" hits:%" PRIu64 " maxlength:%" ROCKSDB_PRIszt ")",
|
2014-01-11 01:33:56 +00:00
|
|
|
num_gets, num_merges, readwrites_, num_hits, max_length);
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
void WriteSeqSeekSeq(ThreadState* thread) {
|
|
|
|
writes_ = FLAGS_num;
|
|
|
|
DoWrite(thread, SEQUENTIAL);
|
|
|
|
// exclude writes from the ops/sec calculation
|
|
|
|
thread->stats.Start(thread->tid);
|
|
|
|
|
|
|
|
DB* db = SelectDB(thread);
|
2022-02-01 03:45:17 +00:00
|
|
|
ReadOptions read_opts = read_options_;
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
Slice ts;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
ts = mock_app_clock_->GetTimestampForRead(thread->rand, ts_guard.get());
|
|
|
|
read_opts.timestamp = &ts;
|
|
|
|
}
|
|
|
|
std::unique_ptr<Iterator> iter(db->NewIterator(read_opts));
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
|
2015-02-19 22:27:48 +00:00
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
for (int64_t i = 0; i < FLAGS_num; ++i) {
|
|
|
|
GenerateKeyFromInt(i, FLAGS_num, &key);
|
|
|
|
iter->Seek(key);
|
|
|
|
assert(iter->Valid() && iter->key() == key);
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kSeek);
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
|
2014-10-17 17:20:25 +00:00
|
|
|
for (int j = 0; j < FLAGS_seek_nexts && i + 1 < FLAGS_num; ++j) {
|
2015-03-18 20:50:52 +00:00
|
|
|
if (!FLAGS_reverse_iterator) {
|
|
|
|
iter->Next();
|
|
|
|
} else {
|
|
|
|
iter->Prev();
|
|
|
|
}
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
GenerateKeyFromInt(++i, FLAGS_num, &key);
|
|
|
|
assert(iter->Valid() && iter->key() == key);
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kSeek);
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
iter->Seek(key);
|
|
|
|
assert(iter->Valid() && iter->key() == key);
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kSeek);
|
SkipListRep::LookaheadIterator
Summary:
This diff introduces the `lookahead` argument to `SkipListFactory()`. This is an
optimization for the tailing use case which includes many seeks. E.g. consider
the following operations on a skip list iterator:
Seek(x), Next(), Next(), Seek(x+2), Next(), Seek(x+3), Next(), Next(), ...
If `lookahead` is positive, `SkipListRep` will return an iterator which also
keeps track of the previously visited node. Seek() then first does a linear
search starting from that node (up to `lookahead` steps). As in the tailing
example above, this may require fewer than ~log(n) comparisons as with regular
skip list search.
Test Plan:
Added a new benchmark (`fillseekseq`) which simulates the usage pattern. It
first writes N records (with consecutive keys), then measures how much time it
takes to read them by calling `Seek()` and `Next()`.
$ time ./db_bench -num 10000000 -benchmarks fillseekseq -prefix_size 1 \
-key_size 8 -write_buffer_size $[1024*1024*1024] -value_size 50 \
-seekseq_next 2 -skip_list_lookahead=0
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.389 micros/op 2569047 ops/sec;
real 0m21.806s
user 0m12.106s
sys 0m9.672s
$ time ./db_bench [...] -skip_list_lookahead=2
[...]
DB path: [/dev/shm/rocksdbtest/dbbench]
fillseekseq : 0.153 micros/op 6540684 ops/sec;
real 0m19.469s
user 0m10.192s
sys 0m9.252s
Reviewers: ljin, sdong, igor
Reviewed By: igor
Subscribers: dhruba, leveldb, march, lovro
Differential Revision: https://reviews.facebook.net/D23997
2014-09-23 22:52:28 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
New API to get all merge operands for a Key (#5604)
Summary:
This is a new API added to db.h to allow for fetching all merge operands associated with a Key. The main motivation for this API is to support use cases where doing a full online merge is not necessary as it is performance sensitive. Example use-cases:
1. Update subset of columns and read subset of columns -
Imagine a SQL Table, a row is encoded as a K/V pair (as it is done in MyRocks). If there are many columns and users only updated one of them, we can use merge operator to reduce write amplification. While users only read one or two columns in the read query, this feature can avoid a full merging of the whole row, and save some CPU.
2. Updating very few attributes in a value which is a JSON-like document -
Updating one attribute can be done efficiently using merge operator, while reading back one attribute can be done more efficiently if we don't need to do a full merge.
----------------------------------------------------------------------------------------------------
API :
Status GetMergeOperands(
const ReadOptions& options, ColumnFamilyHandle* column_family,
const Slice& key, PinnableSlice* merge_operands,
GetMergeOperandsOptions* get_merge_operands_options,
int* number_of_operands)
Example usage :
int size = 100;
int number_of_operands = 0;
std::vector<PinnableSlice> values(size);
GetMergeOperandsOptions merge_operands_info;
db_->GetMergeOperands(ReadOptions(), db_->DefaultColumnFamily(), "k1", values.data(), merge_operands_info, &number_of_operands);
Description :
Returns all the merge operands corresponding to the key. If the number of merge operands in DB is greater than merge_operands_options.expected_max_number_of_operands no merge operands are returned and status is Incomplete. Merge operands returned are in the order of insertion.
merge_operands-> Points to an array of at-least merge_operands_options.expected_max_number_of_operands and the caller is responsible for allocating it. If the status returned is Incomplete then number_of_operands will contain the total number of merge operands found in DB for key.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/5604
Test Plan:
Added unit test and perf test in db_bench that can be run using the command:
./db_bench -benchmarks=getmergeoperands --merge_operator=sortlist
Differential Revision: D16657366
Pulled By: vjnadimpalli
fbshipit-source-id: 0faadd752351745224ee12d4ae9ef3cb529951bf
2019-08-06 21:22:34 +00:00
|
|
|
bool binary_search(std::vector<int>& data, int start, int end, int key) {
|
|
|
|
if (data.empty()) return false;
|
|
|
|
if (start > end) return false;
|
|
|
|
int mid = start + (end - start) / 2;
|
|
|
|
if (mid > static_cast<int>(data.size()) - 1) return false;
|
|
|
|
if (data[mid] == key) {
|
|
|
|
return true;
|
|
|
|
} else if (data[mid] > key) {
|
|
|
|
return binary_search(data, start, mid - 1, key);
|
|
|
|
} else {
|
|
|
|
return binary_search(data, mid + 1, end, key);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Does a bunch of merge operations for a key(key1) where the merge operand
|
|
|
|
// is a sorted list. Next performance comparison is done between doing a Get
|
|
|
|
// for key1 followed by searching for another key(key2) in the large sorted
|
|
|
|
// list vs calling GetMergeOperands for key1 and then searching for the key2
|
|
|
|
// in all the sorted sub-lists. Later case is expected to be a lot faster.
|
|
|
|
void GetMergeOperands(ThreadState* thread) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
const int kTotalValues = 100000;
|
|
|
|
const int kListSize = 100;
|
|
|
|
std::string key = "my_key";
|
|
|
|
std::string value;
|
|
|
|
|
|
|
|
for (int i = 1; i < kTotalValues; i++) {
|
|
|
|
if (i % kListSize == 0) {
|
|
|
|
// Remove trailing ','
|
|
|
|
value.pop_back();
|
|
|
|
db->Merge(WriteOptions(), key, value);
|
|
|
|
value.clear();
|
|
|
|
} else {
|
|
|
|
value.append(std::to_string(i)).append(",");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
SortList s;
|
|
|
|
std::vector<int> data;
|
|
|
|
// This value can be experimented with and it will demonstrate the
|
|
|
|
// perf difference between doing a Get and searching for lookup_key in the
|
|
|
|
// resultant large sorted list vs doing GetMergeOperands and searching
|
|
|
|
// for lookup_key within this resultant sorted sub-lists.
|
|
|
|
int lookup_key = 1;
|
|
|
|
|
|
|
|
// Get API call
|
|
|
|
std::cout << "--- Get API call --- \n";
|
|
|
|
PinnableSlice p_slice;
|
|
|
|
uint64_t st = FLAGS_env->NowNanos();
|
|
|
|
db->Get(ReadOptions(), db->DefaultColumnFamily(), key, &p_slice);
|
|
|
|
s.MakeVector(data, p_slice);
|
|
|
|
bool found =
|
|
|
|
binary_search(data, 0, static_cast<int>(data.size() - 1), lookup_key);
|
|
|
|
std::cout << "Found key? " << std::to_string(found) << "\n";
|
|
|
|
uint64_t sp = FLAGS_env->NowNanos();
|
|
|
|
std::cout << "Get: " << (sp - st) / 1000000000.0 << " seconds\n";
|
|
|
|
std::string* dat_ = p_slice.GetSelf();
|
|
|
|
std::cout << "Sample data from Get API call: " << dat_->substr(0, 10)
|
|
|
|
<< "\n";
|
|
|
|
data.clear();
|
|
|
|
|
|
|
|
// GetMergeOperands API call
|
|
|
|
std::cout << "--- GetMergeOperands API --- \n";
|
|
|
|
std::vector<PinnableSlice> a_slice((kTotalValues / kListSize) + 1);
|
|
|
|
st = FLAGS_env->NowNanos();
|
|
|
|
int number_of_operands = 0;
|
|
|
|
GetMergeOperandsOptions get_merge_operands_options;
|
|
|
|
get_merge_operands_options.expected_max_number_of_operands =
|
|
|
|
(kTotalValues / 100) + 1;
|
|
|
|
db->GetMergeOperands(ReadOptions(), db->DefaultColumnFamily(), key,
|
|
|
|
a_slice.data(), &get_merge_operands_options,
|
|
|
|
&number_of_operands);
|
|
|
|
for (PinnableSlice& psl : a_slice) {
|
|
|
|
s.MakeVector(data, psl);
|
|
|
|
found =
|
|
|
|
binary_search(data, 0, static_cast<int>(data.size() - 1), lookup_key);
|
|
|
|
data.clear();
|
|
|
|
if (found) break;
|
|
|
|
}
|
|
|
|
std::cout << "Found key? " << std::to_string(found) << "\n";
|
|
|
|
sp = FLAGS_env->NowNanos();
|
|
|
|
std::cout << "Get Merge operands: " << (sp - st) / 1000000000.0
|
|
|
|
<< " seconds \n";
|
|
|
|
int to_print = 0;
|
|
|
|
std::cout << "Sample data from GetMergeOperands API call: ";
|
|
|
|
for (PinnableSlice& psl : a_slice) {
|
|
|
|
std::cout << "List: " << to_print << " : " << *psl.GetSelf() << "\n";
|
|
|
|
if (to_print++ > 2) break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-10-14 19:43:00 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2022-02-17 07:17:03 +00:00
|
|
|
void VerifyChecksum(ThreadState* thread) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
ReadOptions ro;
|
|
|
|
ro.adaptive_readahead = FLAGS_adaptive_readahead;
|
2022-03-23 00:21:35 +00:00
|
|
|
ro.async_io = FLAGS_async_io;
|
2022-02-17 07:17:03 +00:00
|
|
|
ro.rate_limiter_priority =
|
|
|
|
FLAGS_rate_limit_user_ops ? Env::IO_USER : Env::IO_TOTAL;
|
|
|
|
ro.readahead_size = FLAGS_readahead_size;
|
|
|
|
Status s = db->VerifyChecksum(ro);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "VerifyChecksum() failed: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void VerifyFileChecksums(ThreadState* thread) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
ReadOptions ro;
|
|
|
|
ro.adaptive_readahead = FLAGS_adaptive_readahead;
|
2022-03-23 00:21:35 +00:00
|
|
|
ro.async_io = FLAGS_async_io;
|
2022-02-17 07:17:03 +00:00
|
|
|
ro.rate_limiter_priority =
|
|
|
|
FLAGS_rate_limit_user_ops ? Env::IO_USER : Env::IO_TOTAL;
|
|
|
|
ro.readahead_size = FLAGS_readahead_size;
|
|
|
|
Status s = db->VerifyFileChecksums(ro);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "VerifyFileChecksums() failed: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-29 21:36:35 +00:00
|
|
|
// This benchmark stress tests Transactions. For a given --duration (or
|
|
|
|
// total number of --writes, a Transaction will perform a read-modify-write
|
|
|
|
// to increment the value of a key in each of N(--transaction-sets) sets of
|
|
|
|
// keys (where each set has --num keys). If --threads is set, this will be
|
|
|
|
// done in parallel.
|
|
|
|
//
|
|
|
|
// To test transactions, use --transaction_db=true. Not setting this
|
|
|
|
// parameter
|
|
|
|
// will run the same benchmark without transactions.
|
|
|
|
//
|
|
|
|
// RandomTransactionVerify() will then validate the correctness of the results
|
|
|
|
// by checking if the sum of all keys in each set is the same.
|
|
|
|
void RandomTransaction(ThreadState* thread) {
|
|
|
|
Duration duration(FLAGS_duration, readwrites_);
|
2016-03-15 17:57:33 +00:00
|
|
|
uint16_t num_prefix_ranges = static_cast<uint16_t>(FLAGS_transaction_sets);
|
2016-03-03 19:20:25 +00:00
|
|
|
uint64_t transactions_done = 0;
|
2015-05-29 21:36:35 +00:00
|
|
|
|
|
|
|
if (num_prefix_ranges == 0 || num_prefix_ranges > 9999) {
|
|
|
|
fprintf(stderr, "invalid value for transaction_sets\n");
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
|
2016-03-03 19:20:25 +00:00
|
|
|
TransactionOptions txn_options;
|
|
|
|
txn_options.lock_timeout = FLAGS_transaction_lock_timeout;
|
|
|
|
txn_options.set_snapshot = FLAGS_transaction_set_snapshot;
|
|
|
|
|
|
|
|
RandomTransactionInserter inserter(&thread->rand, write_options_,
|
2022-02-01 03:45:17 +00:00
|
|
|
read_options_, FLAGS_num,
|
2016-03-03 19:20:25 +00:00
|
|
|
num_prefix_ranges);
|
|
|
|
|
2015-05-29 21:36:35 +00:00
|
|
|
if (FLAGS_num_multi_db > 1) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Cannot run RandomTransaction benchmark with "
|
|
|
|
"FLAGS_multi_db > 1.");
|
|
|
|
abort();
|
|
|
|
}
|
|
|
|
|
|
|
|
while (!duration.Done(1)) {
|
2016-03-03 19:20:25 +00:00
|
|
|
bool success;
|
2015-05-29 21:36:35 +00:00
|
|
|
|
2016-03-03 19:20:25 +00:00
|
|
|
// RandomTransactionInserter will attempt to insert a key for each
|
|
|
|
// # of FLAGS_transaction_sets
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
if (FLAGS_optimistic_transaction_db) {
|
2016-03-03 19:20:25 +00:00
|
|
|
success = inserter.OptimisticTransactionDBInsert(db_.opt_txn_db);
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
} else if (FLAGS_transaction_db) {
|
|
|
|
TransactionDB* txn_db = reinterpret_cast<TransactionDB*>(db_.db);
|
2016-03-03 19:20:25 +00:00
|
|
|
success = inserter.TransactionDBInsert(txn_db, txn_options);
|
2015-05-29 21:36:35 +00:00
|
|
|
} else {
|
2016-03-03 19:20:25 +00:00
|
|
|
success = inserter.DBInsert(db_.db);
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
|
|
|
|
2016-03-03 19:20:25 +00:00
|
|
|
if (!success) {
|
|
|
|
fprintf(stderr, "Unexpected error: %s\n",
|
|
|
|
inserter.GetLastStatus().ToString().c_str());
|
|
|
|
abort();
|
2015-08-28 23:09:34 +00:00
|
|
|
}
|
|
|
|
|
2016-03-03 19:20:25 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db_.db, 1, kOthers);
|
2015-05-29 21:36:35 +00:00
|
|
|
transactions_done++;
|
|
|
|
}
|
|
|
|
|
|
|
|
char msg[100];
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
if (FLAGS_optimistic_transaction_db || FLAGS_transaction_db) {
|
2015-05-29 21:36:35 +00:00
|
|
|
snprintf(msg, sizeof(msg),
|
|
|
|
"( transactions:%" PRIu64 " aborts:%" PRIu64 ")",
|
2016-03-03 19:20:25 +00:00
|
|
|
transactions_done, inserter.GetFailureCount());
|
2015-05-29 21:36:35 +00:00
|
|
|
} else {
|
|
|
|
snprintf(msg, sizeof(msg), "( batches:%" PRIu64 " )", transactions_done);
|
|
|
|
}
|
|
|
|
thread->stats.AddMessage(msg);
|
2017-10-17 01:29:50 +00:00
|
|
|
thread->stats.AddBytes(static_cast<int64_t>(inserter.GetBytesInserted()));
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// Verifies consistency of data after RandomTransaction() has been run.
|
|
|
|
// Since each iteration of RandomTransaction() incremented a key in each set
|
|
|
|
// by the same value, the sum of the keys in each set should be the same.
|
|
|
|
void RandomTransactionVerify() {
|
Pessimistic Transactions
Summary:
Initial implementation of Pessimistic Transactions. This diff contains the api changes discussed in D38913. This diff is pretty large, so let me know if people would prefer to meet up to discuss it.
MyRocks folks: please take a look at the API in include/rocksdb/utilities/transaction[_db].h and let me know if you have any issues.
Also, you'll notice a couple of TODOs in the implementation of RollbackToSavePoint(). After chatting with Siying, I'm going to send out a separate diff for an alternate implementation of this feature that implements the rollback inside of WriteBatch/WriteBatchWithIndex. We can then decide which route is preferable.
Next, I'm planning on doing some perf testing and then integrating this diff into MongoRocks for further testing.
Test Plan: Unit tests, db_bench parallel testing.
Reviewers: igor, rven, sdong, yhchiang, yoshinorim
Reviewed By: sdong
Subscribers: hermanlee4, maykov, spetrunia, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D40869
2015-05-26 00:37:33 +00:00
|
|
|
if (!FLAGS_transaction_db && !FLAGS_optimistic_transaction_db) {
|
2015-05-29 21:36:35 +00:00
|
|
|
// transactions not used, nothing to verify.
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2016-03-03 19:20:25 +00:00
|
|
|
Status s =
|
2016-03-15 17:57:33 +00:00
|
|
|
RandomTransactionInserter::Verify(db_.db,
|
|
|
|
static_cast<uint16_t>(FLAGS_transaction_sets));
|
2015-05-29 21:36:35 +00:00
|
|
|
|
2016-03-03 19:20:25 +00:00
|
|
|
if (s.ok()) {
|
|
|
|
fprintf(stdout, "RandomTransactionVerify Success.\n");
|
|
|
|
} else {
|
|
|
|
fprintf(stdout, "RandomTransactionVerify FAILED!!\n");
|
2015-05-29 21:36:35 +00:00
|
|
|
}
|
|
|
|
}
|
2015-10-14 19:43:00 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2015-05-29 21:36:35 +00:00
|
|
|
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
// Writes and deletes random keys without overwriting keys.
|
|
|
|
//
|
|
|
|
// This benchmark is intended to partially replicate the behavior of MyRocks
|
|
|
|
// secondary indices: All data is stored in keys and updates happen by
|
|
|
|
// deleting the old version of the key and inserting the new version.
|
|
|
|
void RandomReplaceKeys(ThreadState* thread) {
|
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
2020-09-16 03:04:58 +00:00
|
|
|
std::unique_ptr<char[]> ts_guard;
|
|
|
|
if (user_timestamp_size_ > 0) {
|
|
|
|
ts_guard.reset(new char[user_timestamp_size_]);
|
|
|
|
}
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
std::vector<uint32_t> counters(FLAGS_numdistinct, 0);
|
|
|
|
size_t max_counter = 50;
|
|
|
|
RandomGenerator gen;
|
|
|
|
|
|
|
|
Status s;
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
for (int64_t i = 0; i < FLAGS_numdistinct; i++) {
|
|
|
|
GenerateKeyFromInt(i * max_counter, FLAGS_num, &key);
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Slice ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
s = db->Put(write_options_, key, ts, gen.Generate());
|
|
|
|
} else {
|
|
|
|
s = db->Put(write_options_, key, gen.Generate());
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Operation failed: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
db->GetSnapshot();
|
|
|
|
|
|
|
|
std::default_random_engine generator;
|
|
|
|
std::normal_distribution<double> distribution(FLAGS_numdistinct / 2.0,
|
|
|
|
FLAGS_stddev);
|
|
|
|
Duration duration(FLAGS_duration, FLAGS_num);
|
|
|
|
while (!duration.Done(1)) {
|
|
|
|
int64_t rnd_id = static_cast<int64_t>(distribution(generator));
|
|
|
|
int64_t key_id = std::max(std::min(FLAGS_numdistinct - 1, rnd_id),
|
|
|
|
static_cast<int64_t>(0));
|
|
|
|
GenerateKeyFromInt(key_id * max_counter + counters[key_id], FLAGS_num,
|
|
|
|
&key);
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Slice ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
s = FLAGS_use_single_deletes ? db->SingleDelete(write_options_, key, ts)
|
|
|
|
: db->Delete(write_options_, key, ts);
|
|
|
|
} else {
|
|
|
|
s = FLAGS_use_single_deletes ? db->SingleDelete(write_options_, key)
|
|
|
|
: db->Delete(write_options_, key);
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
if (s.ok()) {
|
|
|
|
counters[key_id] = (counters[key_id] + 1) % max_counter;
|
|
|
|
GenerateKeyFromInt(key_id * max_counter + counters[key_id], FLAGS_num,
|
|
|
|
&key);
|
2020-09-16 03:04:58 +00:00
|
|
|
if (user_timestamp_size_ > 0) {
|
Revise APIs related to user-defined timestamp (#8946)
Summary:
ajkr reminded me that we have a rule of not including per-kv related data in `WriteOptions`.
Namely, `WriteOptions` should not include information about "what-to-write", but should just
include information about "how-to-write".
According to this rule, `WriteOptions::timestamp` (experimental) is clearly a violation. Therefore,
this PR removes `WriteOptions::timestamp` for compliance.
After the removal, we need to pass timestamp info via another set of APIs. This PR proposes a set
of overloaded functions `Put(write_opts, key, value, ts)`, `Delete(write_opts, key, ts)`, and
`SingleDelete(write_opts, key, ts)`. Planned to add `Write(write_opts, batch, ts)`, but its complexity
made me reconsider doing it in another PR (maybe).
For better checking and returning error early, we also add a new set of APIs to `WriteBatch` that take
extra `timestamp` information when writing to `WriteBatch`es.
These set of APIs in `WriteBatchWithIndex` are currently not supported, and are on our TODO list.
Removed `WriteBatch::AssignTimestamps()` and renamed `WriteBatch::AssignTimestamp()` to
`WriteBatch::UpdateTimestamps()` since this method require that all keys have space for timestamps
allocated already and multiple timestamps can be updated.
The constructor of `WriteBatch` now takes a fourth argument `default_cf_ts_sz` which is the timestamp
size of the default column family. This will be used to allocate space when calling APIs that do not
specify a column family handle.
Also, updated `DB::Get()`, `DB::MultiGet()`, `DB::NewIterator()`, `DB::NewIterators()` methods, replacing
some assertions about timestamp to returning Status code.
Pull Request resolved: https://github.com/facebook/rocksdb/pull/8946
Test Plan:
make check
./db_bench -benchmarks=fillseq,fillrandom,readrandom,readseq,deleterandom -user_timestamp_size=8
./db_stress --user_timestamp_size=8 -nooverwritepercent=0 -test_secondary=0 -secondary_catch_up_one_in=0 -continuous_verification_interval=0
Make sure there is no perf regression by running the following
```
./db_bench_opt -db=/dev/shm/rocksdb -use_existing_db=0 -level0_stop_writes_trigger=256 -level0_slowdown_writes_trigger=256 -level0_file_num_compaction_trigger=256 -disable_wal=1 -duration=10 -benchmarks=fillrandom
```
Before this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.831 micros/op 546235 ops/sec; 60.4 MB/s
```
After this PR
```
DB path: [/dev/shm/rocksdb]
fillrandom : 1.820 micros/op 549404 ops/sec; 60.8 MB/s
```
Reviewed By: ltamasi
Differential Revision: D33721359
Pulled By: riversand963
fbshipit-source-id: c131561534272c120ffb80711d42748d21badf09
2022-02-02 06:17:46 +00:00
|
|
|
Slice ts = mock_app_clock_->Allocate(ts_guard.get());
|
|
|
|
s = db->Put(write_options_, key, ts, Slice());
|
|
|
|
} else {
|
|
|
|
s = db->Put(write_options_, key, Slice());
|
2020-09-16 03:04:58 +00:00
|
|
|
}
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Operation failed: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2015-12-08 01:33:18 +00:00
|
|
|
thread->stats.FinishedOps(nullptr, db, 1, kOthers);
|
Support for SingleDelete()
Summary:
This patch fixes #7460559. It introduces SingleDelete as a new database
operation. This operation can be used to delete keys that were never
overwritten (no put following another put of the same key). If an overwritten
key is single deleted the behavior is undefined. Single deletion of a
non-existent key has no effect but multiple consecutive single deletions are
not allowed (see limitations).
In contrast to the conventional Delete() operation, the deletion entry is
removed along with the value when the two are lined up in a compaction. Note:
The semantics are similar to @igor's prototype that allowed to have this
behavior on the granularity of a column family (
https://reviews.facebook.net/D42093 ). This new patch, however, is more
aggressive when it comes to removing tombstones: It removes the SingleDelete
together with the value whenever there is no snapshot between them while the
older patch only did this when the sequence number of the deletion was older
than the earliest snapshot.
Most of the complex additions are in the Compaction Iterator, all other changes
should be relatively straightforward. The patch also includes basic support for
single deletions in db_stress and db_bench.
Limitations:
- Not compatible with cuckoo hash tables
- Single deletions cannot be used in combination with merges and normal
deletions on the same key (other keys are not affected by this)
- Consecutive single deletions are currently not allowed (and older version of
this patch supported this so it could be resurrected if needed)
Test Plan: make all check
Reviewers: yhchiang, sdong, rven, anthony, yoshinorim, igor
Reviewed By: igor
Subscribers: maykov, dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D43179
2015-09-17 18:42:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
char msg[200];
|
|
|
|
snprintf(msg, sizeof(msg),
|
|
|
|
"use single deletes: %d, "
|
|
|
|
"standard deviation: %lf\n",
|
|
|
|
FLAGS_use_single_deletes, FLAGS_stddev);
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
2016-08-01 19:28:51 +00:00
|
|
|
void TimeSeriesReadOrDelete(ThreadState* thread, bool do_deletion) {
|
|
|
|
int64_t read = 0;
|
|
|
|
int64_t found = 0;
|
|
|
|
int64_t bytes = 0;
|
|
|
|
|
|
|
|
Iterator* iter = nullptr;
|
|
|
|
// Only work on single database
|
|
|
|
assert(db_.db != nullptr);
|
2022-02-01 03:45:17 +00:00
|
|
|
iter = db_.db->NewIterator(read_options_);
|
2016-08-01 19:28:51 +00:00
|
|
|
|
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
|
|
|
|
|
|
|
char value_buffer[256];
|
|
|
|
while (true) {
|
|
|
|
{
|
|
|
|
MutexLock l(&thread->shared->mu);
|
|
|
|
if (thread->shared->num_done >= 1) {
|
|
|
|
// Write thread have finished
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (!FLAGS_use_tailing_iterator) {
|
|
|
|
delete iter;
|
2022-02-01 03:45:17 +00:00
|
|
|
iter = db_.db->NewIterator(read_options_);
|
2016-08-01 19:28:51 +00:00
|
|
|
}
|
|
|
|
// Pick a Iterator to use
|
|
|
|
|
|
|
|
int64_t key_id = thread->rand.Next() % FLAGS_key_id_range;
|
|
|
|
GenerateKeyFromInt(key_id, FLAGS_num, &key);
|
|
|
|
// Reset last 8 bytes to 0
|
|
|
|
char* start = const_cast<char*>(key.data());
|
|
|
|
start += key.size() - 8;
|
|
|
|
memset(start, 0, 8);
|
|
|
|
++read;
|
|
|
|
|
|
|
|
bool key_found = false;
|
|
|
|
// Seek the prefix
|
|
|
|
for (iter->Seek(key); iter->Valid() && iter->key().starts_with(key);
|
|
|
|
iter->Next()) {
|
|
|
|
key_found = true;
|
|
|
|
// Copy out iterator's value to make sure we read them.
|
|
|
|
if (do_deletion) {
|
|
|
|
bytes += iter->key().size();
|
|
|
|
if (KeyExpired(timestamp_emulator_.get(), iter->key())) {
|
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kDelete);
|
|
|
|
db_.db->Delete(write_options_, iter->key());
|
|
|
|
} else {
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
bytes += iter->key().size() + iter->value().size();
|
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kRead);
|
|
|
|
Slice value = iter->value();
|
|
|
|
memcpy(value_buffer, value.data(),
|
|
|
|
std::min(value.size(), sizeof(value_buffer)));
|
|
|
|
|
|
|
|
assert(iter->status().ok());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
found += key_found;
|
2016-12-19 20:25:35 +00:00
|
|
|
|
|
|
|
if (thread->shared->read_rate_limiter.get() != nullptr) {
|
2017-06-13 21:51:22 +00:00
|
|
|
thread->shared->read_rate_limiter->Request(
|
|
|
|
1, Env::IO_HIGH, nullptr /* stats */, RateLimiter::OpType::kRead);
|
2016-12-19 20:25:35 +00:00
|
|
|
}
|
2016-08-01 19:28:51 +00:00
|
|
|
}
|
|
|
|
delete iter;
|
|
|
|
|
|
|
|
char msg[100];
|
|
|
|
snprintf(msg, sizeof(msg), "(%" PRIu64 " of %" PRIu64 " found)", found,
|
|
|
|
read);
|
|
|
|
thread->stats.AddBytes(bytes);
|
|
|
|
thread->stats.AddMessage(msg);
|
|
|
|
}
|
|
|
|
|
|
|
|
void TimeSeriesWrite(ThreadState* thread) {
|
|
|
|
// Special thread that keeps writing until other threads are done.
|
|
|
|
RandomGenerator gen;
|
|
|
|
int64_t bytes = 0;
|
|
|
|
|
|
|
|
// Don't merge stats from this thread with the readers.
|
|
|
|
thread->stats.SetExcludeFromMerge();
|
|
|
|
|
|
|
|
std::unique_ptr<RateLimiter> write_rate_limiter;
|
|
|
|
if (FLAGS_benchmark_write_rate_limit > 0) {
|
|
|
|
write_rate_limiter.reset(
|
|
|
|
NewGenericRateLimiter(FLAGS_benchmark_write_rate_limit));
|
|
|
|
}
|
|
|
|
|
|
|
|
std::unique_ptr<const char[]> key_guard;
|
|
|
|
Slice key = AllocateKey(&key_guard);
|
|
|
|
|
|
|
|
Duration duration(FLAGS_duration, writes_);
|
|
|
|
while (!duration.Done(1)) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
|
|
|
|
uint64_t key_id = thread->rand.Next() % FLAGS_key_id_range;
|
|
|
|
// Write key id
|
|
|
|
GenerateKeyFromInt(key_id, FLAGS_num, &key);
|
|
|
|
// Write timestamp
|
|
|
|
|
|
|
|
char* start = const_cast<char*>(key.data());
|
|
|
|
char* pos = start + 8;
|
|
|
|
int bytes_to_fill =
|
|
|
|
std::min(key_size_ - static_cast<int>(pos - start), 8);
|
|
|
|
uint64_t timestamp_value = timestamp_emulator_->Get();
|
|
|
|
if (port::kLittleEndian) {
|
|
|
|
for (int i = 0; i < bytes_to_fill; ++i) {
|
|
|
|
pos[i] = (timestamp_value >> ((bytes_to_fill - i - 1) << 3)) & 0xFF;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
memcpy(pos, static_cast<void*>(×tamp_value), bytes_to_fill);
|
|
|
|
}
|
|
|
|
|
|
|
|
timestamp_emulator_->Inc();
|
|
|
|
|
|
|
|
Status s;
|
2020-02-12 22:44:46 +00:00
|
|
|
Slice val = gen.Generate();
|
|
|
|
s = db->Put(write_options_, key, val);
|
2016-08-01 19:28:51 +00:00
|
|
|
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "put error: %s\n", s.ToString().c_str());
|
2020-09-03 21:34:42 +00:00
|
|
|
ErrorExit();
|
2016-08-01 19:28:51 +00:00
|
|
|
}
|
2020-02-12 22:44:46 +00:00
|
|
|
bytes = key.size() + val.size();
|
2016-08-01 19:28:51 +00:00
|
|
|
thread->stats.FinishedOps(&db_, db_.db, 1, kWrite);
|
|
|
|
thread->stats.AddBytes(bytes);
|
|
|
|
|
|
|
|
if (FLAGS_benchmark_write_rate_limit > 0) {
|
|
|
|
write_rate_limiter->Request(
|
2020-02-12 22:44:46 +00:00
|
|
|
key.size() + val.size(), Env::IO_HIGH,
|
2017-06-13 21:51:22 +00:00
|
|
|
nullptr /* stats */, RateLimiter::OpType::kWrite);
|
2016-08-01 19:28:51 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void TimeSeries(ThreadState* thread) {
|
|
|
|
if (thread->tid > 0) {
|
|
|
|
bool do_deletion = FLAGS_expire_style == "delete" &&
|
|
|
|
thread->tid <= FLAGS_num_deletion_threads;
|
|
|
|
TimeSeriesReadOrDelete(thread, do_deletion);
|
|
|
|
} else {
|
|
|
|
TimeSeriesWrite(thread);
|
|
|
|
thread->stats.Stop();
|
|
|
|
thread->stats.Report("timeseries write");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-08-22 21:08:51 +00:00
|
|
|
void Compact(ThreadState* thread) {
|
2014-04-11 19:15:09 +00:00
|
|
|
DB* db = SelectDB(thread);
|
2017-11-07 18:42:47 +00:00
|
|
|
CompactRangeOptions cro;
|
2019-04-17 06:29:32 +00:00
|
|
|
cro.bottommost_level_compaction =
|
|
|
|
BottommostLevelCompaction::kForceOptimized;
|
2017-11-07 18:42:47 +00:00
|
|
|
db->CompactRange(cro, nullptr, nullptr);
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
|
|
|
|
2017-05-30 23:33:26 +00:00
|
|
|
void CompactAll() {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
db_.db->CompactRange(CompactRangeOptions(), nullptr, nullptr);
|
|
|
|
}
|
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
db_with_cfh.db->CompactRange(CompactRangeOptions(), nullptr, nullptr);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-03-17 16:10:24 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
void WaitForCompactionHelper(DBWithColumnFamilies& db) {
|
|
|
|
// This is an imperfect way of waiting for compaction. The loop and sleep
|
|
|
|
// is done because a thread that finishes a compaction job should get a
|
|
|
|
// chance to pickup a new compaction job.
|
|
|
|
|
|
|
|
std::vector<std::string> keys = {DB::Properties::kMemTableFlushPending,
|
|
|
|
DB::Properties::kNumRunningFlushes,
|
|
|
|
DB::Properties::kCompactionPending,
|
|
|
|
DB::Properties::kNumRunningCompactions};
|
|
|
|
|
|
|
|
fprintf(stdout, "waitforcompaction(%s): started\n",
|
|
|
|
db.db->GetName().c_str());
|
|
|
|
|
|
|
|
while (true) {
|
|
|
|
bool retry = false;
|
|
|
|
|
|
|
|
for (const auto& k : keys) {
|
|
|
|
uint64_t v;
|
|
|
|
if (!db.db->GetIntProperty(k, &v)) {
|
|
|
|
fprintf(stderr, "waitforcompaction(%s): GetIntProperty(%s) failed\n",
|
|
|
|
db.db->GetName().c_str(), k.c_str());
|
|
|
|
exit(1);
|
|
|
|
} else if (v > 0) {
|
|
|
|
fprintf(stdout,
|
|
|
|
"waitforcompaction(%s): active(%s). Sleep 10 seconds\n",
|
|
|
|
db.db->GetName().c_str(), k.c_str());
|
2021-07-13 19:39:42 +00:00
|
|
|
FLAGS_env->SleepForMicroseconds(10 * 1000000);
|
2021-03-17 16:10:24 +00:00
|
|
|
retry = true;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!retry) {
|
|
|
|
fprintf(stdout, "waitforcompaction(%s): finished\n",
|
|
|
|
db.db->GetName().c_str());
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void WaitForCompaction() {
|
|
|
|
// Give background threads a chance to wake
|
2021-07-13 19:39:42 +00:00
|
|
|
FLAGS_env->SleepForMicroseconds(5 * 1000000);
|
2021-03-17 16:10:24 +00:00
|
|
|
|
|
|
|
// I am skeptical that this check race free. I hope that checking twice
|
|
|
|
// reduces the chance.
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
WaitForCompactionHelper(db_);
|
|
|
|
WaitForCompactionHelper(db_);
|
|
|
|
} else {
|
|
|
|
for (auto& db_with_cfh : multi_dbs_) {
|
|
|
|
WaitForCompactionHelper(db_with_cfh);
|
|
|
|
WaitForCompactionHelper(db_with_cfh);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
bool CompactLevelHelper(DBWithColumnFamilies& db_with_cfh, int from_level) {
|
|
|
|
std::vector<LiveFileMetaData> files;
|
|
|
|
db_with_cfh.db->GetLiveFilesMetaData(&files);
|
|
|
|
|
|
|
|
assert(from_level == 0 || from_level == 1);
|
|
|
|
|
|
|
|
int real_from_level = from_level;
|
|
|
|
if (real_from_level > 0) {
|
|
|
|
// With dynamic leveled compaction the first level with data beyond L0
|
|
|
|
// might not be L1.
|
|
|
|
real_from_level = std::numeric_limits<int>::max();
|
|
|
|
|
|
|
|
for (auto& f : files) {
|
|
|
|
if (f.level > 0 && f.level < real_from_level) real_from_level = f.level;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (real_from_level == std::numeric_limits<int>::max()) {
|
|
|
|
fprintf(stdout, "compact%d found 0 files to compact\n", from_level);
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// The goal is to compact from from_level to the level that follows it,
|
|
|
|
// and with dynamic leveled compaction the next level might not be
|
|
|
|
// real_from_level+1
|
|
|
|
int next_level = std::numeric_limits<int>::max();
|
|
|
|
|
|
|
|
std::vector<std::string> files_to_compact;
|
|
|
|
for (auto& f : files) {
|
|
|
|
if (f.level == real_from_level)
|
|
|
|
files_to_compact.push_back(f.name);
|
|
|
|
else if (f.level > real_from_level && f.level < next_level)
|
|
|
|
next_level = f.level;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (files_to_compact.empty()) {
|
|
|
|
fprintf(stdout, "compact%d found 0 files to compact\n", from_level);
|
|
|
|
return true;
|
|
|
|
} else if (next_level == std::numeric_limits<int>::max()) {
|
|
|
|
// There is no data beyond real_from_level. So we are done.
|
|
|
|
fprintf(stdout, "compact%d found no data beyond L%d\n", from_level,
|
|
|
|
real_from_level);
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
fprintf(stdout, "compact%d found %d files to compact from L%d to L%d\n",
|
|
|
|
from_level, static_cast<int>(files_to_compact.size()),
|
|
|
|
real_from_level, next_level);
|
|
|
|
|
|
|
|
ROCKSDB_NAMESPACE::CompactionOptions options;
|
|
|
|
// Lets RocksDB use the configured compression for this level
|
|
|
|
options.compression = ROCKSDB_NAMESPACE::kDisableCompressionOption;
|
|
|
|
|
|
|
|
ROCKSDB_NAMESPACE::ColumnFamilyDescriptor cfDesc;
|
|
|
|
db_with_cfh.db->DefaultColumnFamily()->GetDescriptor(&cfDesc);
|
|
|
|
options.output_file_size_limit = cfDesc.options.target_file_size_base;
|
|
|
|
|
|
|
|
Status status =
|
|
|
|
db_with_cfh.db->CompactFiles(options, files_to_compact, next_level);
|
|
|
|
if (!status.ok()) {
|
|
|
|
// This can fail for valid reasons including the operation was aborted
|
|
|
|
// or a filename is invalid because background compaction removed it.
|
|
|
|
// Having read the current cases for which an error is raised I prefer
|
|
|
|
// not to figure out whether an exception should be thrown here.
|
|
|
|
fprintf(stderr, "compact%d CompactFiles failed: %s\n", from_level,
|
|
|
|
status.ToString().c_str());
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
void CompactLevel(int from_level) {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
while (!CompactLevelHelper(db_, from_level)) WaitForCompaction();
|
|
|
|
}
|
|
|
|
for (auto& db_with_cfh : multi_dbs_) {
|
|
|
|
while (!CompactLevelHelper(db_with_cfh, from_level)) WaitForCompaction();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
void Flush() {
|
|
|
|
FlushOptions flush_opt;
|
|
|
|
flush_opt.wait = true;
|
|
|
|
|
|
|
|
if (db_.db != nullptr) {
|
2022-05-03 16:37:49 +00:00
|
|
|
Status s;
|
|
|
|
if (FLAGS_num_column_families > 1) {
|
|
|
|
s = db_.db->Flush(flush_opt, db_.cfh);
|
|
|
|
} else {
|
|
|
|
s = db_.db->Flush(flush_opt, db_.db->DefaultColumnFamily());
|
|
|
|
}
|
|
|
|
|
2021-03-17 16:10:24 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Flush failed: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
2022-05-03 16:37:49 +00:00
|
|
|
Status s;
|
|
|
|
if (FLAGS_num_column_families > 1) {
|
|
|
|
s = db_with_cfh.db->Flush(flush_opt, db_with_cfh.cfh);
|
|
|
|
} else {
|
|
|
|
s = db_with_cfh.db->Flush(flush_opt,
|
|
|
|
db_with_cfh.db->DefaultColumnFamily());
|
|
|
|
}
|
|
|
|
|
2021-03-17 16:10:24 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Flush failed: %s\n", s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
fprintf(stdout, "flush memtable\n");
|
|
|
|
}
|
|
|
|
|
2017-04-18 23:30:51 +00:00
|
|
|
void ResetStats() {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
db_.db->ResetStats();
|
|
|
|
}
|
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
db_with_cfh.db->ResetStats();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-07-04 02:03:29 +00:00
|
|
|
void PrintStatsHistory() {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
PrintStatsHistoryImpl(db_.db, false);
|
|
|
|
}
|
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
PrintStatsHistoryImpl(db_with_cfh.db, true);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void PrintStatsHistoryImpl(DB* db, bool print_header) {
|
|
|
|
if (print_header) {
|
|
|
|
fprintf(stdout, "\n==== DB: %s ===\n", db->GetName().c_str());
|
|
|
|
}
|
|
|
|
|
|
|
|
std::unique_ptr<StatsHistoryIterator> shi;
|
2022-05-05 20:08:21 +00:00
|
|
|
Status s =
|
|
|
|
db->GetStatsHistory(0, std::numeric_limits<uint64_t>::max(), &shi);
|
2019-07-04 02:03:29 +00:00
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stdout, "%s\n", s.ToString().c_str());
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
assert(shi);
|
|
|
|
while (shi->Valid()) {
|
|
|
|
uint64_t stats_time = shi->GetStatsTime();
|
|
|
|
fprintf(stdout, "------ %s ------\n",
|
|
|
|
TimeToHumanString(static_cast<int>(stats_time)).c_str());
|
|
|
|
for (auto& entry : shi->GetStatsMap()) {
|
|
|
|
fprintf(stdout, " %" PRIu64 " %s %" PRIu64 "\n", stats_time,
|
|
|
|
entry.first.c_str(), entry.second);
|
|
|
|
}
|
|
|
|
shi->Next();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-04-17 15:36:46 +00:00
|
|
|
void PrintStats(const char* key) {
|
2014-08-19 01:15:01 +00:00
|
|
|
if (db_.db != nullptr) {
|
|
|
|
PrintStats(db_.db, key, false);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
2014-08-19 01:15:01 +00:00
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
PrintStats(db_with_cfh.db, key, true);
|
2014-04-11 19:15:09 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void PrintStats(DB* db, const char* key, bool print_header = false) {
|
|
|
|
if (print_header) {
|
|
|
|
fprintf(stdout, "\n==== DB: %s ===\n", db->GetName().c_str());
|
|
|
|
}
|
2011-04-12 19:38:58 +00:00
|
|
|
std::string stats;
|
2014-04-11 19:15:09 +00:00
|
|
|
if (!db->GetProperty(key, &stats)) {
|
2011-08-22 21:08:51 +00:00
|
|
|
stats = "(failed)";
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
2011-08-22 21:08:51 +00:00
|
|
|
fprintf(stdout, "\n%s\n", stats.c_str());
|
2011-04-12 19:38:58 +00:00
|
|
|
}
|
2018-08-01 07:14:43 +00:00
|
|
|
|
2021-03-17 16:10:24 +00:00
|
|
|
void PrintStats(const std::vector<std::string>& keys) {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
PrintStats(db_.db, keys);
|
|
|
|
}
|
|
|
|
for (const auto& db_with_cfh : multi_dbs_) {
|
|
|
|
PrintStats(db_with_cfh.db, keys, true);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void PrintStats(DB* db, const std::vector<std::string>& keys,
|
|
|
|
bool print_header = false) {
|
|
|
|
if (print_header) {
|
|
|
|
fprintf(stdout, "\n==== DB: %s ===\n", db->GetName().c_str());
|
|
|
|
}
|
|
|
|
|
|
|
|
for (const auto& key : keys) {
|
|
|
|
std::string stats;
|
|
|
|
if (!db->GetProperty(key, &stats)) {
|
|
|
|
stats = "(failed)";
|
|
|
|
}
|
|
|
|
fprintf(stdout, "%s: %s\n", key.c_str(), stats.c_str());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-08-12 02:31:44 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
|
2018-08-01 07:14:43 +00:00
|
|
|
void Replay(ThreadState* thread) {
|
|
|
|
if (db_.db != nullptr) {
|
|
|
|
Replay(thread, &db_);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void Replay(ThreadState* /*thread*/, DBWithColumnFamilies* db_with_cfh) {
|
|
|
|
Status s;
|
2018-11-09 19:17:34 +00:00
|
|
|
std::unique_ptr<TraceReader> trace_reader;
|
2018-08-01 07:14:43 +00:00
|
|
|
s = NewFileTraceReader(FLAGS_env, EnvOptions(), FLAGS_trace_file,
|
|
|
|
&trace_reader);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(
|
|
|
|
stderr,
|
|
|
|
"Encountered an error creating a TraceReader from the trace file. "
|
|
|
|
"Error: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
2021-08-12 02:31:44 +00:00
|
|
|
std::unique_ptr<Replayer> replayer;
|
|
|
|
s = db_with_cfh->db->NewDefaultReplayer(db_with_cfh->cfh,
|
|
|
|
std::move(trace_reader), &replayer);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Encountered an error creating a default Replayer. "
|
|
|
|
"Error: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
s = replayer->Prepare();
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Prepare for replay failed. Error: %s\n",
|
|
|
|
s.ToString().c_str());
|
|
|
|
}
|
|
|
|
s = replayer->Replay(
|
|
|
|
ReplayOptions(static_cast<uint32_t>(FLAGS_trace_replay_threads),
|
2021-08-19 00:04:36 +00:00
|
|
|
FLAGS_trace_replay_fast_forward),
|
|
|
|
nullptr);
|
2021-08-12 02:31:44 +00:00
|
|
|
replayer.reset();
|
2018-08-01 07:14:43 +00:00
|
|
|
if (s.ok()) {
|
2021-08-12 02:31:44 +00:00
|
|
|
fprintf(stdout, "Replay completed from trace_file: %s\n",
|
2018-08-01 07:14:43 +00:00
|
|
|
FLAGS_trace_file.c_str());
|
|
|
|
} else {
|
2021-08-12 02:31:44 +00:00
|
|
|
fprintf(stderr, "Replay failed. Error: %s\n", s.ToString().c_str());
|
2018-08-01 07:14:43 +00:00
|
|
|
}
|
|
|
|
}
|
2021-08-12 02:31:44 +00:00
|
|
|
|
2022-05-24 17:28:57 +00:00
|
|
|
void Backup(ThreadState* thread) {
|
|
|
|
DB* db = SelectDB(thread);
|
|
|
|
std::unique_ptr<BackupEngineOptions> engine_options(
|
|
|
|
new BackupEngineOptions(FLAGS_backup_dir));
|
|
|
|
Status s;
|
|
|
|
BackupEngine* backup_engine;
|
|
|
|
if (FLAGS_backup_rate_limit > 0) {
|
|
|
|
engine_options->backup_rate_limiter.reset(NewGenericRateLimiter(
|
|
|
|
FLAGS_backup_rate_limit, 100000 /* refill_period_us */,
|
|
|
|
10 /* fairness */, RateLimiter::Mode::kAllIo));
|
|
|
|
}
|
|
|
|
// Build new backup of the entire DB
|
|
|
|
engine_options->destroy_old_data = true;
|
|
|
|
s = BackupEngine::Open(FLAGS_env, *engine_options, &backup_engine);
|
|
|
|
assert(s.ok());
|
|
|
|
s = backup_engine->CreateNewBackup(db);
|
|
|
|
assert(s.ok());
|
|
|
|
std::vector<BackupInfo> backup_info;
|
|
|
|
backup_engine->GetBackupInfo(&backup_info);
|
|
|
|
// Verify that a new backup is created
|
|
|
|
assert(backup_info.size() == 1);
|
|
|
|
}
|
|
|
|
|
|
|
|
void Restore(ThreadState* /* thread */) {
|
|
|
|
std::unique_ptr<BackupEngineOptions> engine_options(
|
|
|
|
new BackupEngineOptions(FLAGS_backup_dir));
|
|
|
|
if (FLAGS_restore_rate_limit > 0) {
|
|
|
|
engine_options->restore_rate_limiter.reset(NewGenericRateLimiter(
|
|
|
|
FLAGS_restore_rate_limit, 100000 /* refill_period_us */,
|
|
|
|
10 /* fairness */, RateLimiter::Mode::kAllIo));
|
|
|
|
}
|
|
|
|
BackupEngineReadOnly* backup_engine;
|
|
|
|
Status s =
|
|
|
|
BackupEngineReadOnly::Open(FLAGS_env, *engine_options, &backup_engine);
|
|
|
|
assert(s.ok());
|
|
|
|
s = backup_engine->RestoreDBFromLatestBackup(FLAGS_restore_dir,
|
|
|
|
FLAGS_restore_dir);
|
|
|
|
assert(s.ok());
|
|
|
|
delete backup_engine;
|
|
|
|
}
|
|
|
|
|
2021-08-12 02:31:44 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2011-03-18 22:37:00 +00:00
|
|
|
};
|
|
|
|
|
2016-02-16 14:17:31 +00:00
|
|
|
int db_bench_tool(int argc, char** argv) {
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::port::InstallStackTraceHandler();
|
2021-09-10 16:46:47 +00:00
|
|
|
ConfigOptions config_options;
|
2016-06-02 23:24:14 +00:00
|
|
|
static bool initialized = false;
|
|
|
|
if (!initialized) {
|
|
|
|
SetUsageMessage(std::string("\nUSAGE:\n") + std::string(argv[0]) +
|
|
|
|
" [OPTIONS]...");
|
2022-07-06 16:58:45 +00:00
|
|
|
SetVersionString(GetRocksVersionAsString(true));
|
2016-06-02 23:24:14 +00:00
|
|
|
initialized = true;
|
|
|
|
}
|
2014-05-09 00:25:13 +00:00
|
|
|
ParseCommandLineFlags(&argc, &argv, true);
|
2020-02-20 20:07:53 +00:00
|
|
|
FLAGS_compaction_style_e =
|
|
|
|
(ROCKSDB_NAMESPACE::CompactionStyle)FLAGS_compaction_style;
|
2017-01-26 23:18:07 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
|
|
|
if (FLAGS_statistics && !FLAGS_statistics_string.empty()) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"Cannot provide both --statistics and --statistics_string.\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
if (!FLAGS_statistics_string.empty()) {
|
2021-09-10 16:46:47 +00:00
|
|
|
Status s = Statistics::CreateFromString(config_options,
|
|
|
|
FLAGS_statistics_string, &dbstats);
|
2017-01-26 23:18:07 +00:00
|
|
|
if (dbstats == nullptr) {
|
2019-07-24 00:08:26 +00:00
|
|
|
fprintf(stderr,
|
|
|
|
"No Statistics registered matching string: %s status=%s\n",
|
|
|
|
FLAGS_statistics_string.c_str(), s.ToString().c_str());
|
2017-01-26 23:18:07 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
#endif // ROCKSDB_LITE
|
2013-10-24 14:43:14 +00:00
|
|
|
if (FLAGS_statistics) {
|
2020-02-20 20:07:53 +00:00
|
|
|
dbstats = ROCKSDB_NAMESPACE::CreateDBStatistics();
|
2011-03-18 22:37:00 +00:00
|
|
|
}
|
2019-02-28 18:14:19 +00:00
|
|
|
if (dbstats) {
|
2019-03-01 18:39:00 +00:00
|
|
|
dbstats->set_stats_level(static_cast<StatsLevel>(FLAGS_stats_level));
|
2019-02-28 18:14:19 +00:00
|
|
|
}
|
2020-02-20 20:07:53 +00:00
|
|
|
FLAGS_compaction_pri_e =
|
|
|
|
(ROCKSDB_NAMESPACE::CompactionPri)FLAGS_compaction_pri;
|
2011-03-18 22:37:00 +00:00
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
std::vector<std::string> fanout = ROCKSDB_NAMESPACE::StringSplit(
|
2014-11-21 16:05:28 +00:00
|
|
|
FLAGS_max_bytes_for_level_multiplier_additional, ',');
|
2015-12-15 23:26:20 +00:00
|
|
|
for (size_t j = 0; j < fanout.size(); j++) {
|
2013-10-24 14:43:14 +00:00
|
|
|
FLAGS_max_bytes_for_level_multiplier_additional_v.push_back(
|
2015-06-08 18:43:55 +00:00
|
|
|
#ifndef CYGWIN
|
|
|
|
std::stoi(fanout[j]));
|
|
|
|
#else
|
|
|
|
stoi(fanout[j]));
|
|
|
|
#endif
|
2013-10-24 14:43:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
FLAGS_compression_type_e =
|
|
|
|
StringToCompressionType(FLAGS_compression_type.c_str());
|
|
|
|
|
2022-01-26 21:57:30 +00:00
|
|
|
FLAGS_wal_compression_e =
|
|
|
|
StringToCompressionType(FLAGS_wal_compression.c_str());
|
|
|
|
|
2022-04-11 20:28:33 +00:00
|
|
|
FLAGS_compressed_secondary_cache_compression_type_e = StringToCompressionType(
|
|
|
|
FLAGS_compressed_secondary_cache_compression_type.c_str());
|
2022-02-24 00:06:27 +00:00
|
|
|
|
2020-02-13 18:50:03 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2021-02-17 19:08:12 +00:00
|
|
|
// Stacked BlobDB
|
2020-02-12 22:44:46 +00:00
|
|
|
FLAGS_blob_db_compression_type_e =
|
|
|
|
StringToCompressionType(FLAGS_blob_db_compression_type.c_str());
|
|
|
|
|
2022-01-25 03:56:37 +00:00
|
|
|
int env_opts = !FLAGS_env_uri.empty() + !FLAGS_fs_uri.empty();
|
2020-08-17 18:51:45 +00:00
|
|
|
if (env_opts > 1) {
|
2022-01-25 03:56:37 +00:00
|
|
|
fprintf(stderr, "Error: --env_uri and --fs_uri are mutually exclusive\n");
|
2016-06-10 00:53:03 +00:00
|
|
|
exit(1);
|
2020-08-17 18:51:45 +00:00
|
|
|
}
|
|
|
|
|
2021-06-15 10:42:52 +00:00
|
|
|
if (env_opts == 1) {
|
2021-09-10 16:46:47 +00:00
|
|
|
Status s = Env::CreateFromUri(config_options, FLAGS_env_uri, FLAGS_fs_uri,
|
2021-06-15 10:42:52 +00:00
|
|
|
&FLAGS_env, &env_guard);
|
|
|
|
if (!s.ok()) {
|
|
|
|
fprintf(stderr, "Failed creating env: %s\n", s.ToString().c_str());
|
2020-08-17 18:51:45 +00:00
|
|
|
exit(1);
|
|
|
|
}
|
2021-12-29 19:13:49 +00:00
|
|
|
} else if (FLAGS_simulate_hdd || FLAGS_simulate_hybrid_fs_file != "") {
|
2021-06-15 10:42:52 +00:00
|
|
|
//**TODO: Make the simulate fs something that can be loaded
|
|
|
|
// from the ObjectRegistry...
|
|
|
|
static std::shared_ptr<ROCKSDB_NAMESPACE::Env> composite_env =
|
|
|
|
NewCompositeEnv(std::make_shared<SimulatedHybridFileSystem>(
|
2021-12-29 19:13:49 +00:00
|
|
|
FileSystem::Default(), FLAGS_simulate_hybrid_fs_file,
|
|
|
|
/*throughput_multiplier=*/
|
|
|
|
int{FLAGS_simulate_hybrid_hdd_multipliers},
|
|
|
|
/*is_full_fs_warm=*/FLAGS_simulate_hdd));
|
2021-06-15 10:42:52 +00:00
|
|
|
FLAGS_env = composite_env.get();
|
2016-06-10 00:53:03 +00:00
|
|
|
}
|
Hide deprecated, inefficient block-based filter from public API (#9535)
Summary:
This change removes the ability to configure the deprecated,
inefficient block-based filter in the public API. Options that would
have enabled it now use "full" (and optionally partitioned) filters.
Existing block-based filters can still be read and used, and a "back
door" way to build them still exists, for testing and in case of trouble.
About the only way this removal would cause an issue for users is if
temporary memory for filter construction greatly increases. In
HISTORY.md we suggest a few possible mitigations: partitioned filters,
smaller SST files, or setting reserve_table_builder_memory=true.
Or users who have customized a FilterPolicy using the
CreateFilter/KeyMayMatch mechanism removed in https://github.com/facebook/rocksdb/issues/9501 will have to upgrade
their code. (It's long past time for people to move to the new
builder/reader customization interface.)
This change also introduces some internal-use-only configuration strings
for testing specific filter implementations while bypassing some
compatibility / intelligence logic. This is intended to hint at a path
toward making FilterPolicy Customizable, but it also gives us a "back
door" way to configure block-based filter.
Aside: updated db_bench so that -readonly implies -use_existing_db
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9535
Test Plan:
Unit tests updated. Specifically,
* BlockBasedTableTest.BlockReadCountTest is tweaked to validate the back
door configuration interface and ignoring of `use_block_based_builder`.
* BlockBasedTableTest.TracingGetTest is migrated from testing
block-based filter access pattern to full filter access patter, by
re-ordering some things.
* Options test (pretty self-explanatory)
Performance test - create with `./db_bench -db=/dev/shm/rocksdb1 -bloom_bits=10 -cache_index_and_filter_blocks=1 -benchmarks=fillrandom -num=10000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=0` with and without `-use_block_based_filter`, which creates a DB with 21 SST files in L0. Read with `./db_bench -db=/dev/shm/rocksdb1 -readonly -bloom_bits=10 -cache_index_and_filter_blocks=1 -benchmarks=readrandom -num=10000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=0 -duration=30`
Without -use_block_based_filter: readrandom 464 ops/sec, 689280 KB DB
With -use_block_based_filter: readrandom 169 ops/sec, 690996 KB DB
No consistent difference with fillrandom
Reviewed By: jay-zhuang
Differential Revision: D34153871
Pulled By: pdillinger
fbshipit-source-id: 31f4a933c542f8f09aca47fa64aec67832a69738
2022-02-12 15:04:09 +00:00
|
|
|
|
|
|
|
// Let -readonly imply -use_existing_db
|
|
|
|
FLAGS_use_existing_db |= FLAGS_readonly;
|
2016-06-10 00:53:03 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
Hide deprecated, inefficient block-based filter from public API (#9535)
Summary:
This change removes the ability to configure the deprecated,
inefficient block-based filter in the public API. Options that would
have enabled it now use "full" (and optionally partitioned) filters.
Existing block-based filters can still be read and used, and a "back
door" way to build them still exists, for testing and in case of trouble.
About the only way this removal would cause an issue for users is if
temporary memory for filter construction greatly increases. In
HISTORY.md we suggest a few possible mitigations: partitioned filters,
smaller SST files, or setting reserve_table_builder_memory=true.
Or users who have customized a FilterPolicy using the
CreateFilter/KeyMayMatch mechanism removed in https://github.com/facebook/rocksdb/issues/9501 will have to upgrade
their code. (It's long past time for people to move to the new
builder/reader customization interface.)
This change also introduces some internal-use-only configuration strings
for testing specific filter implementations while bypassing some
compatibility / intelligence logic. This is intended to hint at a path
toward making FilterPolicy Customizable, but it also gives us a "back
door" way to configure block-based filter.
Aside: updated db_bench so that -readonly implies -use_existing_db
Pull Request resolved: https://github.com/facebook/rocksdb/pull/9535
Test Plan:
Unit tests updated. Specifically,
* BlockBasedTableTest.BlockReadCountTest is tweaked to validate the back
door configuration interface and ignoring of `use_block_based_builder`.
* BlockBasedTableTest.TracingGetTest is migrated from testing
block-based filter access pattern to full filter access patter, by
re-ordering some things.
* Options test (pretty self-explanatory)
Performance test - create with `./db_bench -db=/dev/shm/rocksdb1 -bloom_bits=10 -cache_index_and_filter_blocks=1 -benchmarks=fillrandom -num=10000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=0` with and without `-use_block_based_filter`, which creates a DB with 21 SST files in L0. Read with `./db_bench -db=/dev/shm/rocksdb1 -readonly -bloom_bits=10 -cache_index_and_filter_blocks=1 -benchmarks=readrandom -num=10000000 -compaction_style=2 -fifo_compaction_max_table_files_size_mb=10000 -fifo_compaction_allow_compaction=0 -duration=30`
Without -use_block_based_filter: readrandom 464 ops/sec, 689280 KB DB
With -use_block_based_filter: readrandom 169 ops/sec, 690996 KB DB
No consistent difference with fillrandom
Reviewed By: jay-zhuang
Differential Revision: D34153871
Pulled By: pdillinger
fbshipit-source-id: 31f4a933c542f8f09aca47fa64aec67832a69738
2022-02-12 15:04:09 +00:00
|
|
|
|
2022-07-06 16:58:45 +00:00
|
|
|
if (FLAGS_build_info) {
|
|
|
|
std::string build_info;
|
|
|
|
std::cout << GetRocksBuildInfoAsString(build_info, true) << std::endl;
|
|
|
|
// Similar to --version, nothing else will be done when this flag is set
|
|
|
|
exit(0);
|
|
|
|
}
|
|
|
|
|
2022-03-25 17:12:27 +00:00
|
|
|
if (!FLAGS_seed) {
|
|
|
|
uint64_t now = FLAGS_env->GetSystemClock()->NowMicros();
|
|
|
|
seed_base = static_cast<int64_t>(now);
|
|
|
|
fprintf(stdout, "Set seed to %" PRIu64 " because --seed was 0\n",
|
|
|
|
seed_base);
|
|
|
|
} else {
|
|
|
|
seed_base = FLAGS_seed;
|
|
|
|
}
|
|
|
|
|
2019-03-01 19:14:28 +00:00
|
|
|
if (FLAGS_use_existing_keys && !FLAGS_use_existing_db) {
|
|
|
|
fprintf(stderr,
|
|
|
|
"`-use_existing_db` must be true for `-use_existing_keys` to be "
|
|
|
|
"settable\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2013-10-24 14:43:14 +00:00
|
|
|
if (!strcasecmp(FLAGS_compaction_fadvice.c_str(), "NONE"))
|
2020-02-20 20:07:53 +00:00
|
|
|
FLAGS_compaction_fadvice_e = ROCKSDB_NAMESPACE::Options::NONE;
|
2013-10-24 14:43:14 +00:00
|
|
|
else if (!strcasecmp(FLAGS_compaction_fadvice.c_str(), "NORMAL"))
|
2020-02-20 20:07:53 +00:00
|
|
|
FLAGS_compaction_fadvice_e = ROCKSDB_NAMESPACE::Options::NORMAL;
|
2013-10-24 14:43:14 +00:00
|
|
|
else if (!strcasecmp(FLAGS_compaction_fadvice.c_str(), "SEQUENTIAL"))
|
2020-02-20 20:07:53 +00:00
|
|
|
FLAGS_compaction_fadvice_e = ROCKSDB_NAMESPACE::Options::SEQUENTIAL;
|
2013-10-24 14:43:14 +00:00
|
|
|
else if (!strcasecmp(FLAGS_compaction_fadvice.c_str(), "WILLNEED"))
|
2020-02-20 20:07:53 +00:00
|
|
|
FLAGS_compaction_fadvice_e = ROCKSDB_NAMESPACE::Options::WILLNEED;
|
2013-10-24 14:43:14 +00:00
|
|
|
else {
|
|
|
|
fprintf(stdout, "Unknown compaction fadvice:%s\n",
|
|
|
|
FLAGS_compaction_fadvice.c_str());
|
2022-03-24 18:46:27 +00:00
|
|
|
exit(1);
|
2013-10-24 14:43:14 +00:00
|
|
|
}
|
|
|
|
|
2020-02-12 22:44:46 +00:00
|
|
|
FLAGS_value_size_distribution_type_e =
|
|
|
|
StringToDistributionType(FLAGS_value_size_distribution_type.c_str());
|
|
|
|
|
2017-08-04 04:30:37 +00:00
|
|
|
// Note options sanitization may increase thread pool sizes according to
|
|
|
|
// max_background_flushes/max_background_compactions/max_background_jobs
|
|
|
|
FLAGS_env->SetBackgroundThreads(FLAGS_num_high_pri_threads,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Env::Priority::HIGH);
|
2017-08-03 22:36:28 +00:00
|
|
|
FLAGS_env->SetBackgroundThreads(FLAGS_num_bottom_pri_threads,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Env::Priority::BOTTOM);
|
2017-08-04 04:30:37 +00:00
|
|
|
FLAGS_env->SetBackgroundThreads(FLAGS_num_low_pri_threads,
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Env::Priority::LOW);
|
2014-10-10 03:07:12 +00:00
|
|
|
|
2012-08-27 06:45:35 +00:00
|
|
|
// Choose a location for the test database if none given with --db=<path>
|
2013-10-24 14:43:14 +00:00
|
|
|
if (FLAGS_db.empty()) {
|
|
|
|
std::string default_db_path;
|
2019-10-22 18:42:00 +00:00
|
|
|
FLAGS_env->GetTestDirectory(&default_db_path);
|
2013-10-24 14:43:14 +00:00
|
|
|
default_db_path += "/dbbench";
|
|
|
|
FLAGS_db = default_db_path;
|
2012-08-27 06:45:35 +00:00
|
|
|
}
|
|
|
|
|
2022-05-24 17:28:57 +00:00
|
|
|
if (FLAGS_backup_dir.empty()) {
|
|
|
|
FLAGS_backup_dir = FLAGS_db + "/backup";
|
|
|
|
}
|
|
|
|
|
|
|
|
if (FLAGS_restore_dir.empty()) {
|
|
|
|
FLAGS_restore_dir = FLAGS_db + "/restore";
|
|
|
|
}
|
|
|
|
|
2015-03-30 19:58:32 +00:00
|
|
|
if (FLAGS_stats_interval_seconds > 0) {
|
|
|
|
// When both are set then FLAGS_stats_interval determines the frequency
|
|
|
|
// at which the timer is checked for FLAGS_stats_interval_seconds
|
|
|
|
FLAGS_stats_interval = 1000;
|
|
|
|
}
|
|
|
|
|
2019-04-15 17:49:47 +00:00
|
|
|
if (FLAGS_seek_missing_prefix && FLAGS_prefix_size <= 8) {
|
|
|
|
fprintf(stderr, "prefix_size > 8 required by --seek_missing_prefix\n");
|
|
|
|
exit(1);
|
|
|
|
}
|
|
|
|
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::Benchmark benchmark;
|
2011-03-18 22:37:00 +00:00
|
|
|
benchmark.Run();
|
2018-10-24 18:36:19 +00:00
|
|
|
|
2018-10-25 03:13:06 +00:00
|
|
|
#ifndef ROCKSDB_LITE
|
2018-10-24 18:36:19 +00:00
|
|
|
if (FLAGS_print_malloc_stats) {
|
|
|
|
std::string stats_string;
|
2020-02-20 20:07:53 +00:00
|
|
|
ROCKSDB_NAMESPACE::DumpMallocStats(&stats_string);
|
2018-10-24 18:36:19 +00:00
|
|
|
fprintf(stdout, "Malloc stats:\n%s\n", stats_string.c_str());
|
|
|
|
}
|
2018-10-25 03:13:06 +00:00
|
|
|
#endif // ROCKSDB_LITE
|
2018-10-24 18:36:19 +00:00
|
|
|
|
2011-03-18 22:37:00 +00:00
|
|
|
return 0;
|
|
|
|
}
|
2020-02-20 20:07:53 +00:00
|
|
|
} // namespace ROCKSDB_NAMESPACE
|
2016-02-16 20:16:47 +00:00
|
|
|
#endif
|