// 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). #ifndef ROCKSDB_LITE #include "rocksdb/sst_file_reader.h" #include #include "port/stack_trace.h" #include "rocksdb/convenience.h" #include "rocksdb/db.h" #include "rocksdb/sst_file_writer.h" #include "table/sst_file_writer_collectors.h" #include "test_util/testharness.h" #include "test_util/testutil.h" #include "utilities/merge_operators.h" namespace ROCKSDB_NAMESPACE { std::string EncodeAsString(uint64_t v) { char buf[16]; snprintf(buf, sizeof(buf), "%08" PRIu64, v); return std::string(buf); } std::string EncodeAsUint64(uint64_t v) { std::string dst; PutFixed64(&dst, v); return dst; } class SstFileReaderTest : public testing::Test { public: SstFileReaderTest() { options_.merge_operator = MergeOperators::CreateUInt64AddOperator(); sst_name_ = test::PerThreadDBPath("sst_file"); Env* base_env = Env::Default(); EXPECT_OK( test::CreateEnvFromSystem(ConfigOptions(), &base_env, &env_guard_)); EXPECT_NE(nullptr, base_env); env_ = base_env; options_.env = env_; } ~SstFileReaderTest() { Status s = env_->DeleteFile(sst_name_); EXPECT_OK(s); } void CreateFile(const std::string& file_name, const std::vector& keys) { SstFileWriter writer(soptions_, options_); ASSERT_OK(writer.Open(file_name)); for (size_t i = 0; i + 2 < keys.size(); i += 3) { ASSERT_OK(writer.Put(keys[i], keys[i])); ASSERT_OK(writer.Merge(keys[i + 1], EncodeAsUint64(i + 1))); ASSERT_OK(writer.Delete(keys[i + 2])); } ASSERT_OK(writer.Finish()); } void CheckFile(const std::string& file_name, const std::vector& keys, bool check_global_seqno = false) { ReadOptions ropts; SstFileReader reader(options_); ASSERT_OK(reader.Open(file_name)); ASSERT_OK(reader.VerifyChecksum()); std::unique_ptr iter(reader.NewIterator(ropts)); iter->SeekToFirst(); for (size_t i = 0; i + 2 < keys.size(); i += 3) { ASSERT_TRUE(iter->Valid()); ASSERT_EQ(iter->key().compare(keys[i]), 0); ASSERT_EQ(iter->value().compare(keys[i]), 0); iter->Next(); ASSERT_TRUE(iter->Valid()); ASSERT_EQ(iter->key().compare(keys[i + 1]), 0); ASSERT_EQ(iter->value().compare(EncodeAsUint64(i + 1)), 0); iter->Next(); } ASSERT_FALSE(iter->Valid()); if (check_global_seqno) { auto properties = reader.GetTableProperties(); ASSERT_TRUE(properties); std::string hostname; ASSERT_OK(env_->GetHostNameString(&hostname)); ASSERT_EQ(properties->db_host_id, hostname); auto& user_properties = properties->user_collected_properties; ASSERT_TRUE( user_properties.count(ExternalSstFilePropertyNames::kGlobalSeqno)); } } void CreateFileAndCheck(const std::vector& keys) { CreateFile(sst_name_, keys); CheckFile(sst_name_, keys); } protected: Options options_; EnvOptions soptions_; std::string sst_name_; std::shared_ptr env_guard_; Env* env_; }; const uint64_t kNumKeys = 100; TEST_F(SstFileReaderTest, Basic) { std::vector keys; for (uint64_t i = 0; i < kNumKeys; i++) { keys.emplace_back(EncodeAsString(i)); } CreateFileAndCheck(keys); } TEST_F(SstFileReaderTest, Uint64Comparator) { options_.comparator = test::Uint64Comparator(); std::vector keys; for (uint64_t i = 0; i < kNumKeys; i++) { keys.emplace_back(EncodeAsUint64(i)); } CreateFileAndCheck(keys); } TEST_F(SstFileReaderTest, ReadOptionsOutOfScope) { // Repro a bug where the SstFileReader depended on its configured ReadOptions // outliving it. options_.comparator = test::Uint64Comparator(); std::vector keys; for (uint64_t i = 0; i < kNumKeys; i++) { keys.emplace_back(EncodeAsUint64(i)); } CreateFile(sst_name_, keys); SstFileReader reader(options_); ASSERT_OK(reader.Open(sst_name_)); std::unique_ptr iter; { // Make sure ReadOptions go out of scope ASAP so we know the iterator // operations do not depend on it. ReadOptions ropts; iter.reset(reader.NewIterator(ropts)); } iter->SeekToFirst(); while (iter->Valid()) { iter->Next(); } } TEST_F(SstFileReaderTest, ReadFileWithGlobalSeqno) { std::vector keys; for (uint64_t i = 0; i < kNumKeys; i++) { keys.emplace_back(EncodeAsString(i)); } // Generate a SST file. CreateFile(sst_name_, keys); // Ingest the file into a db, to assign it a global sequence number. Options options; options.create_if_missing = true; std::string db_name = test::PerThreadDBPath("test_db"); DB* db; ASSERT_OK(DB::Open(options, db_name, &db)); // Bump sequence number. ASSERT_OK(db->Put(WriteOptions(), keys[0], "foo")); ASSERT_OK(db->Flush(FlushOptions())); // Ingest the file. IngestExternalFileOptions ingest_options; ingest_options.write_global_seqno = true; ASSERT_OK(db->IngestExternalFile({sst_name_}, ingest_options)); std::vector live_files; uint64_t manifest_file_size = 0; ASSERT_OK(db->GetLiveFiles(live_files, &manifest_file_size)); // Get the ingested file. std::string ingested_file; for (auto& live_file : live_files) { if (live_file.substr(live_file.size() - 4, std::string::npos) == ".sst") { if (ingested_file.empty() || ingested_file < live_file) { ingested_file = live_file; } } } ASSERT_FALSE(ingested_file.empty()); delete db; // Verify the file can be open and read by SstFileReader. CheckFile(db_name + ingested_file, keys, true /* check_global_seqno */); // Cleanup. ASSERT_OK(DestroyDB(db_name, options)); } TEST_F(SstFileReaderTest, TimestampSizeMismatch) { SstFileWriter writer(soptions_, options_); ASSERT_OK(writer.Open(sst_name_)); // Comparator is not timestamp-aware; calls to APIs taking timestamps should // fail. ASSERT_NOK(writer.Put("key", EncodeAsUint64(100), "value")); ASSERT_NOK(writer.Delete("another_key", EncodeAsUint64(200))); } class SstFileReaderTimestampTest : public testing::Test { public: SstFileReaderTimestampTest() { Env* env = Env::Default(); EXPECT_OK(test::CreateEnvFromSystem(ConfigOptions(), &env, &env_guard_)); EXPECT_NE(nullptr, env); options_.env = env; options_.comparator = test::BytewiseComparatorWithU64TsWrapper(); sst_name_ = test::PerThreadDBPath("sst_file_ts"); } ~SstFileReaderTimestampTest() { EXPECT_OK(options_.env->DeleteFile(sst_name_)); } struct KeyValueDesc { KeyValueDesc(std::string k, std::string ts, std::string v) : key(std::move(k)), timestamp(std::move(ts)), value(std::move(v)) {} std::string key; std::string timestamp; std::string value; }; struct InputKeyValueDesc : public KeyValueDesc { InputKeyValueDesc(std::string k, std::string ts, std::string v, bool is_del, bool use_contig_buf) : KeyValueDesc(std::move(k), std::move(ts), std::move(v)), is_delete(is_del), use_contiguous_buffer(use_contig_buf) {} bool is_delete = false; bool use_contiguous_buffer = false; }; struct OutputKeyValueDesc : public KeyValueDesc { OutputKeyValueDesc(std::string k, std::string ts, std::string v) : KeyValueDesc(std::move(k), std::string(ts), std::string(v)) {} }; void CreateFile(const std::vector& descs) { SstFileWriter writer(soptions_, options_); ASSERT_OK(writer.Open(sst_name_)); for (const auto& desc : descs) { if (desc.is_delete) { if (desc.use_contiguous_buffer) { std::string key_with_ts(desc.key + desc.timestamp); ASSERT_OK(writer.Delete(Slice(key_with_ts.data(), desc.key.size()), Slice(key_with_ts.data() + desc.key.size(), desc.timestamp.size()))); } else { ASSERT_OK(writer.Delete(desc.key, desc.timestamp)); } } else { if (desc.use_contiguous_buffer) { std::string key_with_ts(desc.key + desc.timestamp); ASSERT_OK(writer.Put(Slice(key_with_ts.data(), desc.key.size()), Slice(key_with_ts.data() + desc.key.size(), desc.timestamp.size()), desc.value)); } else { ASSERT_OK(writer.Put(desc.key, desc.timestamp, desc.value)); } } } ASSERT_OK(writer.Finish()); } void CheckFile(const std::string& timestamp, const std::vector& descs) { SstFileReader reader(options_); ASSERT_OK(reader.Open(sst_name_)); ASSERT_OK(reader.VerifyChecksum()); Slice ts_slice(timestamp); ReadOptions read_options; read_options.timestamp = &ts_slice; std::unique_ptr iter(reader.NewIterator(read_options)); iter->SeekToFirst(); for (const auto& desc : descs) { ASSERT_TRUE(iter->Valid()); ASSERT_EQ(iter->key(), desc.key); ASSERT_EQ(iter->timestamp(), desc.timestamp); ASSERT_EQ(iter->value(), desc.value); iter->Next(); } ASSERT_FALSE(iter->Valid()); } protected: std::shared_ptr env_guard_; Options options_; EnvOptions soptions_; std::string sst_name_; }; TEST_F(SstFileReaderTimestampTest, Basic) { std::vector input_descs; for (uint64_t k = 0; k < kNumKeys; k += 4) { // A Put with key k, timestamp k that gets overwritten by a subsequent Put // with timestamp (k + 1). Note that the comparator uses descending order // for the timestamp part, so we add the later Put first. input_descs.emplace_back( /* key */ EncodeAsString(k), /* timestamp */ EncodeAsUint64(k + 1), /* value */ EncodeAsString(k * 2), /* is_delete */ false, /* use_contiguous_buffer */ false); input_descs.emplace_back( /* key */ EncodeAsString(k), /* timestamp */ EncodeAsUint64(k), /* value */ EncodeAsString(k * 3), /* is_delete */ false, /* use_contiguous_buffer */ true); // A Put with key (k + 2), timestamp (k + 2) that gets cancelled out by a // Delete with timestamp (k + 3). Note that the comparator uses descending // order for the timestamp part, so we add the Delete first. input_descs.emplace_back(/* key */ EncodeAsString(k + 2), /* timestamp */ EncodeAsUint64(k + 3), /* value */ std::string(), /* is_delete */ true, /* use_contiguous_buffer */ (k % 8) == 0); input_descs.emplace_back( /* key */ EncodeAsString(k + 2), /* timestamp */ EncodeAsUint64(k + 2), /* value */ EncodeAsString(k * 5), /* is_delete */ false, /* use_contiguous_buffer */ (k % 8) != 0); } CreateFile(input_descs); // Note: below, we check the results as of each timestamp in the range, // updating the expected result as needed. std::vector output_descs; for (uint64_t ts = 0; ts < kNumKeys; ++ts) { const uint64_t k = ts - (ts % 4); switch (ts % 4) { case 0: // Initial Put for key k output_descs.emplace_back(/* key */ EncodeAsString(k), /* timestamp */ EncodeAsUint64(ts), /* value */ EncodeAsString(k * 3)); break; case 1: // Second Put for key k assert(output_descs.back().key == EncodeAsString(k)); assert(output_descs.back().timestamp == EncodeAsUint64(ts - 1)); assert(output_descs.back().value == EncodeAsString(k * 3)); output_descs.back().timestamp = EncodeAsUint64(ts); output_descs.back().value = EncodeAsString(k * 2); break; case 2: // Put for key (k + 2) output_descs.emplace_back(/* key */ EncodeAsString(k + 2), /* timestamp */ EncodeAsUint64(ts), /* value */ EncodeAsString(k * 5)); break; case 3: // Delete for key (k + 2) assert(output_descs.back().key == EncodeAsString(k + 2)); assert(output_descs.back().timestamp == EncodeAsUint64(ts - 1)); assert(output_descs.back().value == EncodeAsString(k * 5)); output_descs.pop_back(); break; } CheckFile(EncodeAsUint64(ts), output_descs); } } TEST_F(SstFileReaderTimestampTest, TimestampsOutOfOrder) { SstFileWriter writer(soptions_, options_); ASSERT_OK(writer.Open(sst_name_)); // Note: KVs that have the same user key disregarding timestamps should be in // descending order of timestamps. ASSERT_OK(writer.Put("key", EncodeAsUint64(1), "value1")); ASSERT_NOK(writer.Put("key", EncodeAsUint64(2), "value2")); } TEST_F(SstFileReaderTimestampTest, TimestampSizeMismatch) { SstFileWriter writer(soptions_, options_); ASSERT_OK(writer.Open(sst_name_)); // Comparator expects 64-bit timestamps; timestamps with other sizes as well // as calls to the timestamp-less APIs should be rejected. ASSERT_NOK(writer.Put("key", "not_an_actual_64_bit_timestamp", "value")); ASSERT_NOK(writer.Delete("another_key", "timestamp_of_unexpected_size")); ASSERT_NOK(writer.Put("key_without_timestamp", "value")); ASSERT_NOK(writer.Merge("another_key_missing_a_timestamp", "merge_operand")); ASSERT_NOK(writer.Delete("yet_another_key_still_no_timestamp")); ASSERT_NOK(writer.DeleteRange("begin_key_timestamp_absent", "end_key_with_a_complete_lack_of_timestamps")); } } // namespace ROCKSDB_NAMESPACE int main(int argc, char** argv) { ROCKSDB_NAMESPACE::port::InstallStackTraceHandler(); ::testing::InitGoogleTest(&argc, argv); RegisterCustomObjects(argc, argv); return RUN_ALL_TESTS(); } #else #include int main(int /*argc*/, char** /*argv*/) { fprintf(stderr, "SKIPPED as SstFileReader is not supported in ROCKSDB_LITE\n"); return 0; } #endif // ROCKSDB_LITE