// Copyright (c) 2011-present, Facebook, Inc. All rights reserved. // 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/blob/blob_index.h" #include "db/db_test_util.h" #include "port/stack_trace.h" #include "test_util/sync_point.h" #include "utilities/fault_injection_env.h" namespace ROCKSDB_NAMESPACE { class DBBlobCompactionTest : public DBTestBase { public: explicit DBBlobCompactionTest() : DBTestBase("/db_blob_compaction_test", /*env_do_fsync=*/false) {} // TODO: copied from DBCompactionTest. Should be de-duplicated in the future. std::vector GetBlobFileNumbers() { VersionSet* const versions = dbfull()->TEST_GetVersionSet(); assert(versions); ColumnFamilyData* const cfd = versions->GetColumnFamilySet()->GetDefault(); assert(cfd); Version* const current = cfd->current(); assert(current); const VersionStorageInfo* const storage_info = current->storage_info(); assert(storage_info); const auto& blob_files = storage_info->GetBlobFiles(); std::vector result; result.reserve(blob_files.size()); for (const auto& blob_file : blob_files) { result.emplace_back(blob_file.first); } return result; } #ifndef ROCKSDB_LITE const std::vector& GetCompactionStats() { VersionSet* const versions = dbfull()->TEST_GetVersionSet(); assert(versions); assert(versions->GetColumnFamilySet()); ColumnFamilyData* const cfd = versions->GetColumnFamilySet()->GetDefault(); assert(cfd); const InternalStats* const internal_stats = cfd->internal_stats(); assert(internal_stats); return internal_stats->TEST_GetCompactionStats(); } #endif // ROCKSDB_LITE }; namespace { class FilterByKeyLength : public CompactionFilter { public: explicit FilterByKeyLength(size_t len) : length_threshold_(len) {} const char* Name() const override { return "rocksdb.compaction.filter.by.key.length"; } CompactionFilter::Decision FilterBlobByKey( int /*level*/, const Slice& key, std::string* /*new_value*/, std::string* /*skip_until*/) const override { if (key.size() < length_threshold_) { return CompactionFilter::Decision::kRemove; } return CompactionFilter::Decision::kKeep; } private: size_t length_threshold_; }; class BadBlobCompactionFilter : public CompactionFilter { public: explicit BadBlobCompactionFilter(std::string prefix, CompactionFilter::Decision filter_by_key, CompactionFilter::Decision filter_v2) : prefix_(std::move(prefix)), filter_blob_by_key_(filter_by_key), filter_v2_(filter_v2) {} const char* Name() const override { return "rocksdb.compaction.filter.bad"; } CompactionFilter::Decision FilterBlobByKey( int /*level*/, const Slice& key, std::string* /*new_value*/, std::string* /*skip_until*/) const override { if (key.size() >= prefix_.size() && 0 == strncmp(prefix_.data(), key.data(), prefix_.size())) { return CompactionFilter::Decision::kUndetermined; } return filter_blob_by_key_; } CompactionFilter::Decision FilterV2( int /*level*/, const Slice& /*key*/, ValueType /*value_type*/, const Slice& /*existing_value*/, std::string* /*new_value*/, std::string* /*skip_until*/) const override { return filter_v2_; } private: const std::string prefix_; const CompactionFilter::Decision filter_blob_by_key_; const CompactionFilter::Decision filter_v2_; }; class ValueBlindWriteFilter : public CompactionFilter { public: explicit ValueBlindWriteFilter(std::string new_val) : new_value_(std::move(new_val)) {} const char* Name() const override { return "rocksdb.compaction.filter.blind.write"; } CompactionFilter::Decision FilterBlobByKey( int level, const Slice& key, std::string* new_value, std::string* skip_until) const override; private: const std::string new_value_; }; CompactionFilter::Decision ValueBlindWriteFilter::FilterBlobByKey( int /*level*/, const Slice& /*key*/, std::string* new_value, std::string* /*skip_until*/) const { assert(new_value); new_value->assign(new_value_); return CompactionFilter::Decision::kChangeValue; } class ValueMutationFilter : public CompactionFilter { public: explicit ValueMutationFilter(std::string padding) : padding_(std::move(padding)) {} const char* Name() const override { return "rocksdb.compaction.filter.value.mutation"; } CompactionFilter::Decision FilterV2(int level, const Slice& key, ValueType value_type, const Slice& existing_value, std::string* new_value, std::string* skip_until) const override; private: const std::string padding_; }; CompactionFilter::Decision ValueMutationFilter::FilterV2( int /*level*/, const Slice& /*key*/, ValueType value_type, const Slice& existing_value, std::string* new_value, std::string* /*skip_until*/) const { assert(CompactionFilter::ValueType::kBlobIndex != value_type); if (CompactionFilter::ValueType::kValue != value_type) { return CompactionFilter::Decision::kKeep; } assert(new_value); new_value->assign(existing_value.data(), existing_value.size()); new_value->append(padding_); return CompactionFilter::Decision::kChangeValue; } class AlwaysKeepFilter : public CompactionFilter { public: explicit AlwaysKeepFilter() = default; const char* Name() const override { return "rocksdb.compaction.filter.always.keep"; } CompactionFilter::Decision FilterV2( int /*level*/, const Slice& /*key*/, ValueType /*value_type*/, const Slice& /*existing_value*/, std::string* /*new_value*/, std::string* /*skip_until*/) const override { return CompactionFilter::Decision::kKeep; } }; } // anonymous namespace class DBBlobBadCompactionFilterTest : public DBBlobCompactionTest, public testing::WithParamInterface< std::tuple> { public: explicit DBBlobBadCompactionFilterTest() : compaction_filter_guard_(new BadBlobCompactionFilter( std::get<0>(GetParam()), std::get<1>(GetParam()), std::get<2>(GetParam()))) {} protected: std::unique_ptr compaction_filter_guard_; }; INSTANTIATE_TEST_CASE_P( BadCompactionFilter, DBBlobBadCompactionFilterTest, testing::Combine( testing::Values("a"), testing::Values(CompactionFilter::Decision::kChangeBlobIndex, CompactionFilter::Decision::kIOError), testing::Values(CompactionFilter::Decision::kUndetermined, CompactionFilter::Decision::kChangeBlobIndex, CompactionFilter::Decision::kIOError))); TEST_F(DBBlobCompactionTest, FilterByKeyLength) { Options options = GetDefaultOptions(); options.enable_blob_files = true; options.min_blob_size = 0; options.create_if_missing = true; constexpr size_t kKeyLength = 2; std::unique_ptr compaction_filter_guard( new FilterByKeyLength(kKeyLength)); options.compaction_filter = compaction_filter_guard.get(); constexpr char short_key[] = "a"; constexpr char long_key[] = "abc"; constexpr char blob_value[] = "value"; DestroyAndReopen(options); ASSERT_OK(Put(short_key, blob_value)); ASSERT_OK(Put(long_key, blob_value)); ASSERT_OK(Flush()); CompactRangeOptions cro; ASSERT_OK(db_->CompactRange(cro, /*begin=*/nullptr, /*end=*/nullptr)); std::string value; ASSERT_TRUE(db_->Get(ReadOptions(), short_key, &value).IsNotFound()); value.clear(); ASSERT_OK(db_->Get(ReadOptions(), long_key, &value)); ASSERT_EQ("value", value); #ifndef ROCKSDB_LITE const auto& compaction_stats = GetCompactionStats(); ASSERT_GE(compaction_stats.size(), 2); // Filter decides between kKeep and kRemove solely based on key; // this involves neither reading nor writing blobs ASSERT_EQ(compaction_stats[1].bytes_read_blob, 0); ASSERT_EQ(compaction_stats[1].bytes_written_blob, 0); #endif // ROCKSDB_LITE Close(); } TEST_F(DBBlobCompactionTest, BlindWriteFilter) { Options options = GetDefaultOptions(); options.enable_blob_files = true; options.min_blob_size = 0; options.create_if_missing = true; constexpr char new_blob_value[] = "new_blob_value"; std::unique_ptr compaction_filter_guard( new ValueBlindWriteFilter(new_blob_value)); options.compaction_filter = compaction_filter_guard.get(); DestroyAndReopen(options); const std::vector keys = {"a", "b", "c"}; const std::vector values = {"a_value", "b_value", "c_value"}; assert(keys.size() == values.size()); for (size_t i = 0; i < keys.size(); ++i) { ASSERT_OK(Put(keys[i], values[i])); } ASSERT_OK(Flush()); ASSERT_OK(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr)); for (const auto& key : keys) { ASSERT_EQ(new_blob_value, Get(key)); } #ifndef ROCKSDB_LITE const auto& compaction_stats = GetCompactionStats(); ASSERT_GE(compaction_stats.size(), 2); // Filter unconditionally changes value in FilterBlobByKey; // this involves writing but not reading blobs ASSERT_EQ(compaction_stats[1].bytes_read_blob, 0); ASSERT_GT(compaction_stats[1].bytes_written_blob, 0); #endif // ROCKSDB_LITE Close(); } TEST_P(DBBlobBadCompactionFilterTest, BadDecisionFromCompactionFilter) { Options options = GetDefaultOptions(); options.enable_blob_files = true; options.min_blob_size = 0; options.create_if_missing = true; options.compaction_filter = compaction_filter_guard_.get(); DestroyAndReopen(options); ASSERT_OK(Put("b", "value")); ASSERT_OK(Flush()); ASSERT_TRUE(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr) .IsNotSupported()); Close(); DestroyAndReopen(options); std::string key(std::get<0>(GetParam())); ASSERT_OK(Put(key, "value")); ASSERT_OK(Flush()); ASSERT_TRUE(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr) .IsNotSupported()); Close(); } TEST_F(DBBlobCompactionTest, CompactionFilter_InlinedTTLIndex) { Options options = GetDefaultOptions(); options.create_if_missing = true; options.enable_blob_files = true; options.min_blob_size = 0; std::unique_ptr compaction_filter_guard( new ValueMutationFilter("")); options.compaction_filter = compaction_filter_guard.get(); DestroyAndReopen(options); constexpr char key[] = "key"; constexpr char blob[] = "blob"; // Fake an inlined TTL blob index. std::string blob_index; constexpr uint64_t expiration = 1234567890; BlobIndex::EncodeInlinedTTL(&blob_index, expiration, blob); WriteBatch batch; ASSERT_OK(WriteBatchInternal::PutBlobIndex(&batch, 0, key, blob_index)); ASSERT_OK(db_->Write(WriteOptions(), &batch)); ASSERT_OK(Flush()); ASSERT_TRUE(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr) .IsCorruption()); Close(); } TEST_F(DBBlobCompactionTest, CompactionFilter) { Options options = GetDefaultOptions(); options.create_if_missing = true; options.enable_blob_files = true; options.min_blob_size = 0; constexpr char padding[] = "_delta"; std::unique_ptr compaction_filter_guard( new ValueMutationFilter(padding)); options.compaction_filter = compaction_filter_guard.get(); DestroyAndReopen(options); const std::vector> kvs = { {"a", "a_value"}, {"b", "b_value"}, {"c", "c_value"}}; for (const auto& kv : kvs) { ASSERT_OK(Put(kv.first, kv.second)); } ASSERT_OK(Flush()); ASSERT_OK(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr)); for (const auto& kv : kvs) { ASSERT_EQ(kv.second + std::string(padding), Get(kv.first)); } #ifndef ROCKSDB_LITE const auto& compaction_stats = GetCompactionStats(); ASSERT_GE(compaction_stats.size(), 2); // Filter changes the value using the previous value in FilterV2; // this involves reading and writing blobs ASSERT_GT(compaction_stats[1].bytes_read_blob, 0); ASSERT_GT(compaction_stats[1].bytes_written_blob, 0); #endif // ROCKSDB_LITE Close(); } TEST_F(DBBlobCompactionTest, CorruptedBlobIndex) { Options options = GetDefaultOptions(); options.create_if_missing = true; options.enable_blob_files = true; options.min_blob_size = 0; std::unique_ptr compaction_filter_guard( new ValueMutationFilter("")); options.compaction_filter = compaction_filter_guard.get(); DestroyAndReopen(options); // Mock a corrupted blob index constexpr char key[] = "key"; std::string blob_idx("blob_idx"); WriteBatch write_batch; ASSERT_OK(WriteBatchInternal::PutBlobIndex(&write_batch, 0, key, blob_idx)); ASSERT_OK(db_->Write(WriteOptions(), &write_batch)); ASSERT_OK(Flush()); ASSERT_TRUE(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr) .IsCorruption()); Close(); } TEST_F(DBBlobCompactionTest, CompactionFilterReadBlobAndKeep) { Options options = GetDefaultOptions(); options.create_if_missing = true; options.enable_blob_files = true; options.min_blob_size = 0; std::unique_ptr compaction_filter_guard( new AlwaysKeepFilter()); options.compaction_filter = compaction_filter_guard.get(); DestroyAndReopen(options); ASSERT_OK(Put("foo", "foo_value")); ASSERT_OK(Flush()); std::vector blob_files = GetBlobFileNumbers(); ASSERT_EQ(1, blob_files.size()); ASSERT_OK(db_->CompactRange(CompactRangeOptions(), /*begin=*/nullptr, /*end=*/nullptr)); ASSERT_EQ(blob_files, GetBlobFileNumbers()); #ifndef ROCKSDB_LITE const auto& compaction_stats = GetCompactionStats(); ASSERT_GE(compaction_stats.size(), 2); // Filter decides to keep the existing value in FilterV2; // this involves reading but not writing blobs ASSERT_GT(compaction_stats[1].bytes_read_blob, 0); ASSERT_EQ(compaction_stats[1].bytes_written_blob, 0); #endif // ROCKSDB_LITE Close(); } } // namespace ROCKSDB_NAMESPACE int main(int argc, char** argv) { ROCKSDB_NAMESPACE::port::InstallStackTraceHandler(); ::testing::InitGoogleTest(&argc, argv); return RUN_ALL_TESTS(); }