mirror of
https://github.com/facebook/rocksdb.git
synced 2024-11-30 22:41:48 +00:00
b7319d8a10
Summary: Thanks to how we are using `DBIter` as child iterators in MultiCfIterators (both `CoalescingIterator` and `AttributeGroupIterator`), we got the lower/upper bound feature for free. This PR simply adds unit test coverage to ensure that the lower/upper bounds are working as expected in the MultiCfIterators. Pull Request resolved: https://github.com/facebook/rocksdb/pull/12548 Test Plan: UnitTest Added ``` ./multi_cf_iterator_test ``` Reviewed By: ltamasi Differential Revision: D56197966 Pulled By: jaykorean fbshipit-source-id: fa51cc70705dbc5efd836ac006a7c6a49d05707a
812 lines
32 KiB
C++
812 lines
32 KiB
C++
// Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
// 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).
|
|
|
|
#include "db/db_test_util.h"
|
|
#include "rocksdb/attribute_groups.h"
|
|
|
|
namespace ROCKSDB_NAMESPACE {
|
|
|
|
class CoalescingIteratorTest : public DBTestBase {
|
|
public:
|
|
CoalescingIteratorTest()
|
|
: DBTestBase("coalescing_iterator_test", /*env_do_fsync=*/true) {}
|
|
|
|
// Verify Iteration of CoalescingIterator
|
|
// by SeekToFirst() + Next() and SeekToLast() + Prev()
|
|
void verifyCoalescingIterator(const std::vector<ColumnFamilyHandle*>& cfhs,
|
|
const std::vector<Slice>& expected_keys,
|
|
const std::vector<Slice>& expected_values,
|
|
const std::optional<std::vector<WideColumns>>&
|
|
expected_wide_columns = std::nullopt,
|
|
const Slice* lower_bound = nullptr,
|
|
const Slice* upper_bound = nullptr) {
|
|
int i = 0;
|
|
ReadOptions read_options;
|
|
read_options.iterate_lower_bound = lower_bound;
|
|
read_options.iterate_upper_bound = upper_bound;
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(read_options, cfhs);
|
|
for (iter->SeekToFirst(); iter->Valid(); iter->Next()) {
|
|
ASSERT_EQ(expected_keys[i], iter->key());
|
|
ASSERT_EQ(expected_values[i], iter->value());
|
|
if (expected_wide_columns.has_value()) {
|
|
ASSERT_EQ(expected_wide_columns.value()[i], iter->columns());
|
|
}
|
|
++i;
|
|
}
|
|
ASSERT_EQ(expected_keys.size(), i);
|
|
ASSERT_OK(iter->status());
|
|
|
|
int rev_i = i - 1;
|
|
for (iter->SeekToLast(); iter->Valid(); iter->Prev()) {
|
|
ASSERT_EQ(expected_keys[rev_i], iter->key());
|
|
ASSERT_EQ(expected_values[rev_i], iter->value());
|
|
if (expected_wide_columns.has_value()) {
|
|
ASSERT_EQ(expected_wide_columns.value()[rev_i], iter->columns());
|
|
}
|
|
rev_i--;
|
|
}
|
|
ASSERT_OK(iter->status());
|
|
}
|
|
|
|
void verifyExpectedKeys(ColumnFamilyHandle* cfh,
|
|
const std::vector<Slice>& expected_keys) {
|
|
int i = 0;
|
|
Iterator* iter = db_->NewIterator(ReadOptions(), cfh);
|
|
for (iter->SeekToFirst(); iter->Valid(); iter->Next()) {
|
|
ASSERT_EQ(expected_keys[i], iter->key());
|
|
++i;
|
|
}
|
|
ASSERT_EQ(expected_keys.size(), i);
|
|
ASSERT_OK(iter->status());
|
|
delete iter;
|
|
}
|
|
};
|
|
|
|
TEST_F(CoalescingIteratorTest, InvalidArguments) {
|
|
Options options = GetDefaultOptions();
|
|
{
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
// Invalid - No CF is provided
|
|
std::unique_ptr<Iterator> iter_with_no_cf =
|
|
db_->NewCoalescingIterator(ReadOptions(), {});
|
|
ASSERT_NOK(iter_with_no_cf->status());
|
|
ASSERT_TRUE(iter_with_no_cf->status().IsInvalidArgument());
|
|
}
|
|
}
|
|
|
|
TEST_F(CoalescingIteratorTest, SimpleValues) {
|
|
Options options = GetDefaultOptions();
|
|
{
|
|
// Case 1: Unique key per CF
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
ASSERT_OK(Put(0, "key_1", "key_1_cf_0_val"));
|
|
ASSERT_OK(Put(1, "key_2", "key_2_cf_1_val"));
|
|
ASSERT_OK(Put(2, "key_3", "key_3_cf_2_val"));
|
|
ASSERT_OK(Put(3, "key_4", "key_4_cf_3_val"));
|
|
|
|
std::vector<Slice> expected_keys = {"key_1", "key_2", "key_3", "key_4"};
|
|
std::vector<Slice> expected_values = {"key_1_cf_0_val", "key_2_cf_1_val",
|
|
"key_3_cf_2_val", "key_4_cf_3_val"};
|
|
|
|
// Test for iteration over CF default->1->2->3
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_0_1_2_3 = {
|
|
handles_[0], handles_[1], handles_[2], handles_[3]};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values);
|
|
|
|
// Test for iteration over CF 3->1->default_cf->2
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_3_1_0_2 = {
|
|
handles_[3], handles_[1], handles_[0], handles_[2]};
|
|
// Iteration order and the return values should be the same since keys are
|
|
// unique per CF
|
|
verifyCoalescingIterator(cfhs_order_3_1_0_2, expected_keys,
|
|
expected_values);
|
|
|
|
// Verify Seek()
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), cfhs_order_0_1_2_3);
|
|
iter->Seek("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_0_val");
|
|
iter->Seek("key_1");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_0_val");
|
|
iter->Seek("key_2");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_2_val");
|
|
iter->Seek("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
// Verify SeekForPrev()
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), cfhs_order_0_1_2_3);
|
|
iter->SeekForPrev("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("key_1");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_0_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->SeekForPrev("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_4->key_4_cf_3_val");
|
|
iter->Prev();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_2_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_4->key_4_cf_3_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
}
|
|
{
|
|
// Case 2: Same key in multiple CFs
|
|
options = CurrentOptions(options);
|
|
DestroyAndReopen(options);
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
ASSERT_OK(Put(0, "key_1", "key_1_cf_0_val"));
|
|
ASSERT_OK(Put(3, "key_1", "key_1_cf_3_val"));
|
|
ASSERT_OK(Put(1, "key_2", "key_2_cf_1_val"));
|
|
ASSERT_OK(Put(2, "key_2", "key_2_cf_2_val"));
|
|
ASSERT_OK(Put(0, "key_3", "key_3_cf_0_val"));
|
|
ASSERT_OK(Put(1, "key_3", "key_3_cf_1_val"));
|
|
ASSERT_OK(Put(3, "key_3", "key_3_cf_3_val"));
|
|
|
|
std::vector<Slice> expected_keys = {"key_1", "key_2", "key_3"};
|
|
|
|
// Test for iteration over CFs default->1->2->3
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_0_1_2_3 = {
|
|
handles_[0], handles_[1], handles_[2], handles_[3]};
|
|
std::vector<Slice> expected_values = {"key_1_cf_3_val", "key_2_cf_2_val",
|
|
"key_3_cf_3_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values);
|
|
|
|
// Test for iteration over CFs 3->2->default_cf->1
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_3_2_0_1 = {
|
|
handles_[3], handles_[2], handles_[0], handles_[1]};
|
|
expected_values = {"key_1_cf_0_val", "key_2_cf_1_val", "key_3_cf_1_val"};
|
|
verifyCoalescingIterator(cfhs_order_3_2_0_1, expected_keys,
|
|
expected_values);
|
|
|
|
// Verify Seek()
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), cfhs_order_3_2_0_1);
|
|
iter->Seek("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_0_val");
|
|
iter->Seek("key_1");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_0_val");
|
|
iter->Seek("key_2");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_1_val");
|
|
iter->Seek("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
// Verify SeekForPrev()
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), cfhs_order_3_2_0_1);
|
|
iter->SeekForPrev("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("key_1");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_0_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->SeekForPrev("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
}
|
|
}
|
|
|
|
TEST_F(CoalescingIteratorTest, LowerAndUpperBounds) {
|
|
Options options = GetDefaultOptions();
|
|
{
|
|
// Case 1: Unique key per CF
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
ASSERT_OK(Put(0, "key_1", "key_1_cf_0_val"));
|
|
ASSERT_OK(Put(1, "key_2", "key_2_cf_1_val"));
|
|
ASSERT_OK(Put(2, "key_3", "key_3_cf_2_val"));
|
|
ASSERT_OK(Put(3, "key_4", "key_4_cf_3_val"));
|
|
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_0_1_2_3 = {
|
|
handles_[0], handles_[1], handles_[2], handles_[3]};
|
|
|
|
// with lower_bound
|
|
{
|
|
// lower_bound is inclusive
|
|
Slice lb = Slice("key_2");
|
|
std::vector<Slice> expected_keys = {"key_2", "key_3", "key_4"};
|
|
std::vector<Slice> expected_values = {"key_2_cf_1_val", "key_3_cf_2_val",
|
|
"key_4_cf_3_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values, std::nullopt, &lb);
|
|
}
|
|
// with upper_bound
|
|
{
|
|
// upper_bound is exclusive
|
|
Slice ub = Slice("key_3");
|
|
std::vector<Slice> expected_keys = {"key_1", "key_2"};
|
|
std::vector<Slice> expected_values = {"key_1_cf_0_val", "key_2_cf_1_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values, std::nullopt, nullptr, &ub);
|
|
}
|
|
// with lower and upper bound
|
|
{
|
|
Slice lb = Slice("key_2");
|
|
Slice ub = Slice("key_4");
|
|
std::vector<Slice> expected_keys = {"key_2", "key_3"};
|
|
std::vector<Slice> expected_values = {"key_2_cf_1_val", "key_3_cf_2_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values, std::nullopt, &lb, &ub);
|
|
}
|
|
|
|
{
|
|
Slice lb = Slice("key_2");
|
|
Slice ub = Slice("key_4");
|
|
ReadOptions read_options;
|
|
read_options.iterate_lower_bound = &lb;
|
|
read_options.iterate_upper_bound = &ub;
|
|
// Verify Seek() with bounds
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(read_options, cfhs_order_0_1_2_3);
|
|
iter->Seek("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_2_val");
|
|
iter->Seek("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
// Verify SeekForPrev() with bounds
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(read_options, cfhs_order_0_1_2_3);
|
|
iter->SeekForPrev("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("key_1");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("key_2");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_2_val");
|
|
iter->SeekForPrev("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_2_val");
|
|
iter->Prev();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_3->key_3_cf_2_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
}
|
|
}
|
|
{
|
|
// Case 2: Same key in multiple CFs
|
|
options = CurrentOptions(options);
|
|
DestroyAndReopen(options);
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
ASSERT_OK(Put(0, "key_1", "key_1_cf_0_val"));
|
|
ASSERT_OK(Put(3, "key_1", "key_1_cf_3_val"));
|
|
ASSERT_OK(Put(1, "key_2", "key_2_cf_1_val"));
|
|
ASSERT_OK(Put(2, "key_2", "key_2_cf_2_val"));
|
|
ASSERT_OK(Put(0, "key_3", "key_3_cf_0_val"));
|
|
ASSERT_OK(Put(1, "key_3", "key_3_cf_1_val"));
|
|
ASSERT_OK(Put(3, "key_3", "key_3_cf_3_val"));
|
|
|
|
// Test for iteration over CFs default->1->2->3
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_0_1_2_3 = {
|
|
handles_[0], handles_[1], handles_[2], handles_[3]};
|
|
// with lower_bound
|
|
{
|
|
// lower_bound is inclusive
|
|
Slice lb = Slice("key_2");
|
|
std::vector<Slice> expected_keys = {"key_2", "key_3"};
|
|
std::vector<Slice> expected_values = {"key_2_cf_2_val", "key_3_cf_3_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values, std::nullopt, &lb);
|
|
}
|
|
// with upper_bound
|
|
{
|
|
// upper_bound is exclusive
|
|
Slice ub = Slice("key_3");
|
|
std::vector<Slice> expected_keys = {"key_1", "key_2"};
|
|
std::vector<Slice> expected_values = {"key_1_cf_3_val", "key_2_cf_2_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values, std::nullopt, nullptr, &ub);
|
|
}
|
|
// with lower and upper bound
|
|
{
|
|
Slice lb = Slice("key_2");
|
|
Slice ub = Slice("key_3");
|
|
std::vector<Slice> expected_keys = {"key_2"};
|
|
std::vector<Slice> expected_values = {"key_2_cf_2_val"};
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_values, std::nullopt, &lb, &ub);
|
|
}
|
|
|
|
// Test for iteration over CFs 3->2->default_cf->1
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_3_2_0_1 = {
|
|
handles_[3], handles_[2], handles_[0], handles_[1]};
|
|
{
|
|
// lower_bound is inclusive
|
|
Slice lb = Slice("key_2");
|
|
std::vector<Slice> expected_keys = {"key_2", "key_3"};
|
|
std::vector<Slice> expected_values = {"key_2_cf_1_val", "key_3_cf_1_val"};
|
|
verifyCoalescingIterator(cfhs_order_3_2_0_1, expected_keys,
|
|
expected_values, std::nullopt, &lb);
|
|
}
|
|
// with upper_bound
|
|
{
|
|
// upper_bound is exclusive
|
|
Slice ub = Slice("key_3");
|
|
std::vector<Slice> expected_keys = {"key_1", "key_2"};
|
|
std::vector<Slice> expected_values = {"key_1_cf_0_val", "key_2_cf_1_val"};
|
|
verifyCoalescingIterator(cfhs_order_3_2_0_1, expected_keys,
|
|
expected_values, std::nullopt, nullptr, &ub);
|
|
}
|
|
// with lower and upper bound
|
|
{
|
|
Slice lb = Slice("key_2");
|
|
Slice ub = Slice("key_3");
|
|
std::vector<Slice> expected_keys = {"key_2"};
|
|
std::vector<Slice> expected_values = {"key_2_cf_1_val"};
|
|
verifyCoalescingIterator(cfhs_order_3_2_0_1, expected_keys,
|
|
expected_values, std::nullopt, &lb, &ub);
|
|
}
|
|
{
|
|
Slice lb = Slice("key_2");
|
|
Slice ub = Slice("key_3");
|
|
ReadOptions read_options;
|
|
read_options.iterate_lower_bound = &lb;
|
|
read_options.iterate_upper_bound = &ub;
|
|
// Verify Seek() with bounds
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(read_options, cfhs_order_3_2_0_1);
|
|
iter->Seek("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->Seek("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
// Verify SeekForPrev() with bounds
|
|
{
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(read_options, cfhs_order_3_2_0_1);
|
|
iter->SeekForPrev("");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("key_1");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("key_2");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->SeekForPrev("key_x");
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_2->key_2_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
TEST_F(CoalescingIteratorTest, EmptyCfs) {
|
|
Options options = GetDefaultOptions();
|
|
{
|
|
// Case 1: No keys in any of the CFs
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), handles_);
|
|
iter->SeekToFirst();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekToLast();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->Seek("foo");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekForPrev("foo");
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
|
|
ASSERT_OK(iter->status());
|
|
}
|
|
{
|
|
// Case 2: A single key exists in only one of the CF. Rest CFs are empty.
|
|
ASSERT_OK(Put(1, "key_1", "key_1_cf_1_val"));
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), handles_);
|
|
iter->SeekToFirst();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_1_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekToLast();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_1_val");
|
|
iter->Prev();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
{
|
|
// Case 3: same key exists in all of the CFs except one (cf_2)
|
|
ASSERT_OK(Put(0, "key_1", "key_1_cf_0_val"));
|
|
ASSERT_OK(Put(3, "key_1", "key_1_cf_3_val"));
|
|
// handles_ are in the order of 0->1->2->3
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), handles_);
|
|
iter->SeekToFirst();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_3_val");
|
|
iter->Next();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
iter->SeekToLast();
|
|
ASSERT_EQ(IterStatus(iter.get()), "key_1->key_1_cf_3_val");
|
|
iter->Prev();
|
|
ASSERT_EQ(IterStatus(iter.get()), "(invalid)");
|
|
}
|
|
}
|
|
|
|
TEST_F(CoalescingIteratorTest, WideColumns) {
|
|
// Set up the DB and Column Families
|
|
Options options = GetDefaultOptions();
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
constexpr char key_1[] = "key_1";
|
|
WideColumns key_1_columns_in_cf_2{
|
|
{kDefaultWideColumnName, "cf_2_col_val_0_key_1"},
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_1"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_1"},
|
|
{"cf_overlap_col_name", "cf_2_overlap_value_key_1"}};
|
|
WideColumns key_1_columns_in_cf_3{
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_1"},
|
|
{"cf_3_col_name_2", "cf_3_col_val_2_key_1"},
|
|
{"cf_3_col_name_3", "cf_3_col_val_3_key_1"},
|
|
{"cf_overlap_col_name", "cf_3_overlap_value_key_1"}};
|
|
WideColumns key_1_expected_columns_cfh_order_2_3{
|
|
{kDefaultWideColumnName, "cf_2_col_val_0_key_1"},
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_1"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_1"},
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_1"},
|
|
{"cf_3_col_name_2", "cf_3_col_val_2_key_1"},
|
|
{"cf_3_col_name_3", "cf_3_col_val_3_key_1"},
|
|
{"cf_overlap_col_name", "cf_3_overlap_value_key_1"}};
|
|
WideColumns key_1_expected_columns_cfh_order_3_2{
|
|
{kDefaultWideColumnName, "cf_2_col_val_0_key_1"},
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_1"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_1"},
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_1"},
|
|
{"cf_3_col_name_2", "cf_3_col_val_2_key_1"},
|
|
{"cf_3_col_name_3", "cf_3_col_val_3_key_1"},
|
|
{"cf_overlap_col_name", "cf_2_overlap_value_key_1"}};
|
|
|
|
constexpr char key_2[] = "key_2";
|
|
WideColumns key_2_columns_in_cf_1{
|
|
{"cf_overlap_col_name", "cf_1_overlap_value_key_2"}};
|
|
WideColumns key_2_columns_in_cf_2{
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_2"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_2"},
|
|
{"cf_overlap_col_name", "cf_2_overlap_value_key_2"}};
|
|
WideColumns key_2_expected_columns_cfh_order_1_2{
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_2"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_2"},
|
|
{"cf_overlap_col_name", "cf_2_overlap_value_key_2"}};
|
|
WideColumns key_2_expected_columns_cfh_order_2_1{
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_2"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_2"},
|
|
{"cf_overlap_col_name", "cf_1_overlap_value_key_2"}};
|
|
|
|
constexpr char key_3[] = "key_3";
|
|
WideColumns key_3_columns_in_cf_1{
|
|
{"cf_1_col_name_1", "cf_1_col_val_1_key_3"}};
|
|
WideColumns key_3_columns_in_cf_3{
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_3"}};
|
|
WideColumns key_3_expected_columns{
|
|
{"cf_1_col_name_1", "cf_1_col_val_1_key_3"},
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_3"},
|
|
};
|
|
|
|
constexpr char key_4[] = "key_4";
|
|
WideColumns key_4_columns_in_cf_0{
|
|
{"cf_0_col_name_1", "cf_0_col_val_1_key_4"}};
|
|
WideColumns key_4_columns_in_cf_2{
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_4"}};
|
|
WideColumns key_4_expected_columns{
|
|
{"cf_0_col_name_1", "cf_0_col_val_1_key_4"},
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_4"},
|
|
};
|
|
|
|
// Use AttributeGroup PutEntity API to insert them together
|
|
AttributeGroups key_1_attribute_groups{
|
|
AttributeGroup(handles_[2], key_1_columns_in_cf_2),
|
|
AttributeGroup(handles_[3], key_1_columns_in_cf_3)};
|
|
AttributeGroups key_2_attribute_groups{
|
|
AttributeGroup(handles_[1], key_2_columns_in_cf_1),
|
|
AttributeGroup(handles_[2], key_2_columns_in_cf_2)};
|
|
AttributeGroups key_3_attribute_groups{
|
|
AttributeGroup(handles_[1], key_3_columns_in_cf_1),
|
|
AttributeGroup(handles_[3], key_3_columns_in_cf_3)};
|
|
AttributeGroups key_4_attribute_groups{
|
|
AttributeGroup(handles_[0], key_4_columns_in_cf_0),
|
|
AttributeGroup(handles_[2], key_4_columns_in_cf_2)};
|
|
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_1, key_1_attribute_groups));
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_2, key_2_attribute_groups));
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_3, key_3_attribute_groups));
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_4, key_4_attribute_groups));
|
|
|
|
// Keys should be returned in order regardless of cfh order
|
|
std::vector<Slice> expected_keys = {key_1, key_2, key_3, key_4};
|
|
|
|
// Since value for kDefaultWideColumnName only exists for key_1, rest will
|
|
// return empty value after coalesced
|
|
std::vector<Slice> expected_values = {"cf_2_col_val_0_key_1", "", "", ""};
|
|
|
|
// Test for iteration over CF default->1->2->3
|
|
{
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_0_1_2_3 = {
|
|
handles_[0], handles_[1], handles_[2], handles_[3]};
|
|
|
|
// Coalesced columns
|
|
std::vector<WideColumns> expected_wide_columns_0_1_2_3 = {
|
|
key_1_expected_columns_cfh_order_2_3,
|
|
key_2_expected_columns_cfh_order_1_2, key_3_expected_columns,
|
|
key_4_expected_columns};
|
|
|
|
verifyCoalescingIterator(cfhs_order_0_1_2_3, expected_keys, expected_values,
|
|
expected_wide_columns_0_1_2_3);
|
|
}
|
|
|
|
// Test for iteration over CF 3->2->default->1
|
|
{
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_3_2_0_1 = {
|
|
handles_[3], handles_[2], handles_[0], handles_[1]};
|
|
|
|
// Coalesced columns
|
|
std::vector<WideColumns> expected_wide_columns_3_2_0_1 = {
|
|
key_1_expected_columns_cfh_order_3_2,
|
|
key_2_expected_columns_cfh_order_2_1, key_3_expected_columns,
|
|
key_4_expected_columns};
|
|
|
|
verifyCoalescingIterator(cfhs_order_3_2_0_1, expected_keys, expected_values,
|
|
expected_wide_columns_3_2_0_1);
|
|
}
|
|
}
|
|
|
|
TEST_F(CoalescingIteratorTest, DifferentComparatorsInMultiCFs) {
|
|
// This test creates two column families with two different comparators.
|
|
// Attempting to create the CoalescingIterator should fail.
|
|
Options options = GetDefaultOptions();
|
|
options.create_if_missing = true;
|
|
DestroyAndReopen(options);
|
|
options.comparator = BytewiseComparator();
|
|
CreateColumnFamilies({"cf_forward"}, options);
|
|
options.comparator = ReverseBytewiseComparator();
|
|
CreateColumnFamilies({"cf_reverse"}, options);
|
|
|
|
ASSERT_OK(Put(0, "key_1", "value_1"));
|
|
ASSERT_OK(Put(0, "key_2", "value_2"));
|
|
ASSERT_OK(Put(0, "key_3", "value_3"));
|
|
ASSERT_OK(Put(1, "key_1", "value_1"));
|
|
ASSERT_OK(Put(1, "key_2", "value_2"));
|
|
ASSERT_OK(Put(1, "key_3", "value_3"));
|
|
|
|
verifyExpectedKeys(handles_[0], {"key_1", "key_2", "key_3"});
|
|
verifyExpectedKeys(handles_[1], {"key_3", "key_2", "key_1"});
|
|
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), handles_);
|
|
ASSERT_NOK(iter->status());
|
|
ASSERT_TRUE(iter->status().IsInvalidArgument());
|
|
}
|
|
|
|
TEST_F(CoalescingIteratorTest, CustomComparatorsInMultiCFs) {
|
|
// This test creates two column families with the same custom test
|
|
// comparators (but instantiated independently). Attempting to create the
|
|
// CoalescingIterator should not fail.
|
|
Options options = GetDefaultOptions();
|
|
options.create_if_missing = true;
|
|
DestroyAndReopen(options);
|
|
static auto comparator_1 =
|
|
std::make_unique<test::SimpleSuffixReverseComparator>(
|
|
test::SimpleSuffixReverseComparator());
|
|
static auto comparator_2 =
|
|
std::make_unique<test::SimpleSuffixReverseComparator>(
|
|
test::SimpleSuffixReverseComparator());
|
|
ASSERT_NE(comparator_1, comparator_2);
|
|
|
|
options.comparator = comparator_1.get();
|
|
CreateColumnFamilies({"cf_1"}, options);
|
|
options.comparator = comparator_2.get();
|
|
CreateColumnFamilies({"cf_2"}, options);
|
|
|
|
ASSERT_OK(Put(0, "key_001_001", "value_0_3"));
|
|
ASSERT_OK(Put(0, "key_001_002", "value_0_2"));
|
|
ASSERT_OK(Put(0, "key_001_003", "value_0_1"));
|
|
ASSERT_OK(Put(0, "key_002_001", "value_0_6"));
|
|
ASSERT_OK(Put(0, "key_002_002", "value_0_5"));
|
|
ASSERT_OK(Put(0, "key_002_003", "value_0_4"));
|
|
ASSERT_OK(Put(1, "key_001_001", "value_1_3"));
|
|
ASSERT_OK(Put(1, "key_001_002", "value_1_2"));
|
|
ASSERT_OK(Put(1, "key_001_003", "value_1_1"));
|
|
ASSERT_OK(Put(1, "key_003_004", "value_1_6"));
|
|
ASSERT_OK(Put(1, "key_003_005", "value_1_5"));
|
|
ASSERT_OK(Put(1, "key_003_006", "value_1_4"));
|
|
|
|
verifyExpectedKeys(
|
|
handles_[0], {"key_001_003", "key_001_002", "key_001_001", "key_002_003",
|
|
"key_002_002", "key_002_001"});
|
|
verifyExpectedKeys(
|
|
handles_[1], {"key_001_003", "key_001_002", "key_001_001", "key_003_006",
|
|
"key_003_005", "key_003_004"});
|
|
|
|
std::vector<Slice> expected_keys = {
|
|
"key_001_003", "key_001_002", "key_001_001", "key_002_003", "key_002_002",
|
|
"key_002_001", "key_003_006", "key_003_005", "key_003_004"};
|
|
std::vector<Slice> expected_values = {"value_1_1", "value_1_2", "value_1_3",
|
|
"value_0_4", "value_0_5", "value_0_6",
|
|
"value_1_4", "value_1_5", "value_1_6"};
|
|
int i = 0;
|
|
std::unique_ptr<Iterator> iter =
|
|
db_->NewCoalescingIterator(ReadOptions(), handles_);
|
|
for (iter->SeekToFirst(); iter->Valid(); iter->Next()) {
|
|
ASSERT_EQ(expected_keys[i], iter->key());
|
|
ASSERT_EQ(expected_values[i], iter->value());
|
|
++i;
|
|
}
|
|
ASSERT_OK(iter->status());
|
|
}
|
|
|
|
class AttributeGroupIteratorTest : public DBTestBase {
|
|
public:
|
|
AttributeGroupIteratorTest()
|
|
: DBTestBase("attribute_group_iterator_test", /*env_do_fsync=*/true) {}
|
|
|
|
void verifyAttributeGroupIterator(
|
|
const std::vector<ColumnFamilyHandle*>& cfhs,
|
|
const std::vector<Slice>& expected_keys,
|
|
const std::vector<AttributeGroups>& expected_attribute_groups,
|
|
const Slice* lower_bound = nullptr, const Slice* upper_bound = nullptr) {
|
|
int i = 0;
|
|
ReadOptions read_options;
|
|
read_options.iterate_lower_bound = lower_bound;
|
|
read_options.iterate_upper_bound = upper_bound;
|
|
std::unique_ptr<AttributeGroupIterator> iter =
|
|
db_->NewAttributeGroupIterator(read_options, cfhs);
|
|
for (iter->SeekToFirst(); iter->Valid(); iter->Next()) {
|
|
ASSERT_EQ(expected_keys[i], iter->key());
|
|
auto iterator_attribute_groups = iter->attribute_groups();
|
|
ASSERT_EQ(expected_attribute_groups[i].size(),
|
|
iterator_attribute_groups.size());
|
|
for (size_t cfh_i = 0; cfh_i < iterator_attribute_groups.size();
|
|
cfh_i++) {
|
|
ASSERT_EQ(expected_attribute_groups[i][cfh_i].column_family(),
|
|
iterator_attribute_groups[cfh_i].column_family());
|
|
ASSERT_EQ(expected_attribute_groups[i][cfh_i].columns(),
|
|
iterator_attribute_groups[cfh_i].columns());
|
|
}
|
|
++i;
|
|
}
|
|
ASSERT_EQ(expected_keys.size(), i);
|
|
ASSERT_OK(iter->status());
|
|
|
|
int rev_i = i - 1;
|
|
for (iter->SeekToLast(); iter->Valid(); iter->Prev()) {
|
|
ASSERT_EQ(expected_keys[rev_i], iter->key());
|
|
auto iterator_attribute_groups = iter->attribute_groups();
|
|
ASSERT_EQ(expected_attribute_groups[rev_i].size(),
|
|
iterator_attribute_groups.size());
|
|
for (size_t cfh_i = 0; cfh_i < iterator_attribute_groups.size();
|
|
cfh_i++) {
|
|
ASSERT_EQ(expected_attribute_groups[rev_i][cfh_i].column_family(),
|
|
iterator_attribute_groups[cfh_i].column_family());
|
|
ASSERT_EQ(expected_attribute_groups[rev_i][cfh_i].columns(),
|
|
iterator_attribute_groups[cfh_i].columns());
|
|
}
|
|
rev_i--;
|
|
}
|
|
ASSERT_OK(iter->status());
|
|
}
|
|
};
|
|
|
|
TEST_F(AttributeGroupIteratorTest, IterateAttributeGroups) {
|
|
// Set up the DB and Column Families
|
|
Options options = GetDefaultOptions();
|
|
CreateAndReopenWithCF({"cf_1", "cf_2", "cf_3"}, options);
|
|
|
|
constexpr char key_1[] = "key_1";
|
|
WideColumns key_1_columns_in_cf_2{
|
|
{kDefaultWideColumnName, "cf_2_col_val_0_key_1"},
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_1"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_1"}};
|
|
WideColumns key_1_columns_in_cf_3{
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_1"},
|
|
{"cf_3_col_name_2", "cf_3_col_val_2_key_1"},
|
|
{"cf_3_col_name_3", "cf_3_col_val_3_key_1"}};
|
|
|
|
constexpr char key_2[] = "key_2";
|
|
WideColumns key_2_columns_in_cf_1{
|
|
{"cf_1_col_name_1", "cf_1_col_val_1_key_2"}};
|
|
WideColumns key_2_columns_in_cf_2{
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_2"},
|
|
{"cf_2_col_name_2", "cf_2_col_val_2_key_2"}};
|
|
|
|
constexpr char key_3[] = "key_3";
|
|
WideColumns key_3_columns_in_cf_1{
|
|
{"cf_1_col_name_1", "cf_1_col_val_1_key_3"}};
|
|
WideColumns key_3_columns_in_cf_3{
|
|
{"cf_3_col_name_1", "cf_3_col_val_1_key_3"}};
|
|
|
|
constexpr char key_4[] = "key_4";
|
|
WideColumns key_4_columns_in_cf_0{
|
|
{"cf_0_col_name_1", "cf_0_col_val_1_key_4"}};
|
|
WideColumns key_4_columns_in_cf_2{
|
|
{"cf_2_col_name_1", "cf_2_col_val_1_key_4"}};
|
|
|
|
AttributeGroups key_1_attribute_groups{
|
|
AttributeGroup(handles_[2], key_1_columns_in_cf_2),
|
|
AttributeGroup(handles_[3], key_1_columns_in_cf_3)};
|
|
AttributeGroups key_2_attribute_groups{
|
|
AttributeGroup(handles_[1], key_2_columns_in_cf_1),
|
|
AttributeGroup(handles_[2], key_2_columns_in_cf_2)};
|
|
AttributeGroups key_3_attribute_groups{
|
|
AttributeGroup(handles_[1], key_3_columns_in_cf_1),
|
|
AttributeGroup(handles_[3], key_3_columns_in_cf_3)};
|
|
AttributeGroups key_4_attribute_groups{
|
|
AttributeGroup(handles_[0], key_4_columns_in_cf_0),
|
|
AttributeGroup(handles_[2], key_4_columns_in_cf_2)};
|
|
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_1, key_1_attribute_groups));
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_2, key_2_attribute_groups));
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_3, key_3_attribute_groups));
|
|
ASSERT_OK(db_->PutEntity(WriteOptions(), key_4, key_4_attribute_groups));
|
|
|
|
// Test for iteration over CF default->1->2->3
|
|
std::vector<ColumnFamilyHandle*> cfhs_order_0_1_2_3 = {
|
|
handles_[0], handles_[1], handles_[2], handles_[3]};
|
|
{
|
|
std::vector<Slice> expected_keys = {key_1, key_2, key_3, key_4};
|
|
std::vector<AttributeGroups> expected_attribute_groups = {
|
|
key_1_attribute_groups, key_2_attribute_groups, key_3_attribute_groups,
|
|
key_4_attribute_groups};
|
|
verifyAttributeGroupIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_attribute_groups);
|
|
}
|
|
Slice lb = Slice("key_2");
|
|
Slice ub = Slice("key_4");
|
|
// Test for lower bound only
|
|
{
|
|
std::vector<Slice> expected_keys = {key_2, key_3, key_4};
|
|
std::vector<AttributeGroups> expected_attribute_groups = {
|
|
key_2_attribute_groups, key_3_attribute_groups, key_4_attribute_groups};
|
|
verifyAttributeGroupIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_attribute_groups, &lb);
|
|
}
|
|
// Test for upper bound only
|
|
{
|
|
std::vector<Slice> expected_keys = {key_1, key_2, key_3};
|
|
std::vector<AttributeGroups> expected_attribute_groups = {
|
|
key_1_attribute_groups, key_2_attribute_groups, key_3_attribute_groups};
|
|
verifyAttributeGroupIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_attribute_groups, nullptr, &ub);
|
|
}
|
|
// Test for lower and upper bound
|
|
{
|
|
std::vector<Slice> expected_keys = {key_2, key_3};
|
|
std::vector<AttributeGroups> expected_attribute_groups = {
|
|
key_2_attribute_groups, key_3_attribute_groups};
|
|
verifyAttributeGroupIterator(cfhs_order_0_1_2_3, expected_keys,
|
|
expected_attribute_groups, &lb, &ub);
|
|
}
|
|
}
|
|
|
|
} // namespace ROCKSDB_NAMESPACE
|
|
|
|
int main(int argc, char** argv) {
|
|
ROCKSDB_NAMESPACE::port::InstallStackTraceHandler();
|
|
::testing::InitGoogleTest(&argc, argv);
|
|
return RUN_ALL_TESTS();
|
|
}
|