// Copyright (c) 2013, Facebook, Inc. All rights reserved. // This source code is licensed under the BSD-style license found in the // LICENSE file in the root directory of this source tree. An additional grant // of patent rights can be found in the PATENTS file in the same directory. // #include "rocksdb/sst_dump_tool.h" #include #include #include #include #include "db/dbformat.h" #include "db/memtable.h" #include "db/write_batch_internal.h" #include "rocksdb/db.h" #include "rocksdb/env.h" #include "rocksdb/immutable_options.h" #include "rocksdb/iterator.h" #include "rocksdb/slice_transform.h" #include "rocksdb/status.h" #include "rocksdb/table.h" #include "rocksdb/table_properties.h" #include "table/block.h" #include "table/block_based_table_factory.h" #include "table/block_builder.h" #include "table/format.h" #include "table/meta_blocks.h" #include "table/plain_table_factory.h" #include "util/ldb_cmd.h" #include "util/random.h" #include "util/testharness.h" #include "util/testutil.h" namespace rocksdb { class SstFileReader { public: explicit SstFileReader(const std::string& file_name, bool verify_checksum, bool output_hex); Status ReadSequential(bool print_kv, uint64_t read_num, bool has_from, const std::string& from_key, bool has_to, const std::string& to_key); Status ReadTableProperties( std::shared_ptr* table_properties); uint64_t GetReadNumber() { return read_num_; } TableProperties* GetInitTableProperties() { return table_properties_.get(); } private: Status NewTableReader(const std::string& file_path); Status ReadTableProperties(uint64_t table_magic_number, RandomAccessFile* file, uint64_t file_size); Status SetTableOptionsByMagicNumber(uint64_t table_magic_number); Status SetOldTableOptions(); std::string file_name_; uint64_t read_num_; bool verify_checksum_; bool output_hex_; EnvOptions soptions_; Status init_result_; unique_ptr table_reader_; unique_ptr file_; // options_ and internal_comparator_ will also be used in // ReadSequential internally (specifically, seek-related operations) Options options_; const ImmutableCFOptions ioptions_; InternalKeyComparator internal_comparator_; unique_ptr table_properties_; }; SstFileReader::SstFileReader(const std::string& file_path, bool verify_checksum, bool output_hex) :file_name_(file_path), read_num_(0), verify_checksum_(verify_checksum), output_hex_(output_hex), ioptions_(options_), internal_comparator_(BytewiseComparator()) { fprintf(stdout, "Process %s\n", file_path.c_str()); init_result_ = NewTableReader(file_name_); } extern uint64_t kBlockBasedTableMagicNumber; extern uint64_t kLegacyBlockBasedTableMagicNumber; extern uint64_t kPlainTableMagicNumber; extern uint64_t kLegacyPlainTableMagicNumber; Status SstFileReader::NewTableReader(const std::string& file_path) { uint64_t magic_number; // read table magic number Footer footer; unique_ptr file; uint64_t file_size; Status s = options_.env->NewRandomAccessFile(file_path, &file_, soptions_); if (s.ok()) { s = options_.env->GetFileSize(file_path, &file_size); } if (s.ok()) { s = ReadFooterFromFile(file_.get(), file_size, &footer); } if (s.ok()) { magic_number = footer.table_magic_number(); } if (s.ok()) { if (magic_number == kPlainTableMagicNumber || magic_number == kLegacyPlainTableMagicNumber) { soptions_.use_mmap_reads = true; options_.env->NewRandomAccessFile(file_path, &file_, soptions_); } options_.comparator = &internal_comparator_; // For old sst format, ReadTableProperties might fail but file can be read if (ReadTableProperties(magic_number, file_.get(), file_size).ok()) { SetTableOptionsByMagicNumber(magic_number); } else { SetOldTableOptions(); } } if (s.ok()) { s = options_.table_factory->NewTableReader( ioptions_, soptions_, internal_comparator_, std::move(file_), file_size, &table_reader_); } return s; } Status SstFileReader::ReadTableProperties(uint64_t table_magic_number, RandomAccessFile* file, uint64_t file_size) { TableProperties* table_properties = nullptr; Status s = rocksdb::ReadTableProperties(file, file_size, table_magic_number, options_.env, options_.info_log.get(), &table_properties); if (s.ok()) { table_properties_.reset(table_properties); } else { fprintf(stdout, "Not able to read table properties\n"); } return s; } Status SstFileReader::SetTableOptionsByMagicNumber( uint64_t table_magic_number) { assert(table_properties_); if (table_magic_number == kBlockBasedTableMagicNumber || table_magic_number == kLegacyBlockBasedTableMagicNumber) { options_.table_factory = std::make_shared(); fprintf(stdout, "Sst file format: block-based\n"); auto& props = table_properties_->user_collected_properties; auto pos = props.find(BlockBasedTablePropertyNames::kIndexType); if (pos != props.end()) { auto index_type_on_file = static_cast( DecodeFixed32(pos->second.c_str())); if (index_type_on_file == BlockBasedTableOptions::IndexType::kHashSearch) { options_.prefix_extractor.reset(NewNoopTransform()); } } } else if (table_magic_number == kPlainTableMagicNumber || table_magic_number == kLegacyPlainTableMagicNumber) { options_.allow_mmap_reads = true; PlainTableOptions plain_table_options; plain_table_options.user_key_len = kPlainTableVariableLength; plain_table_options.bloom_bits_per_key = 0; plain_table_options.hash_table_ratio = 0; plain_table_options.index_sparseness = 1; plain_table_options.huge_page_tlb_size = 0; plain_table_options.encoding_type = kPlain; plain_table_options.full_scan_mode = true; options_.table_factory.reset(NewPlainTableFactory(plain_table_options)); fprintf(stdout, "Sst file format: plain table\n"); } else { char error_msg_buffer[80]; snprintf(error_msg_buffer, sizeof(error_msg_buffer) - 1, "Unsupported table magic number --- %lx", (long)table_magic_number); return Status::InvalidArgument(error_msg_buffer); } return Status::OK(); } Status SstFileReader::SetOldTableOptions() { assert(table_properties_ == nullptr); options_.table_factory = std::make_shared(); fprintf(stdout, "Sst file format: block-based(old version)\n"); return Status::OK(); } Status SstFileReader::ReadSequential(bool print_kv, uint64_t read_num, bool has_from, const std::string& from_key, bool has_to, const std::string& to_key) { if (!table_reader_) { return init_result_; } Iterator* iter = table_reader_->NewIterator(ReadOptions(verify_checksum_, false)); uint64_t i = 0; if (has_from) { InternalKey ikey(from_key, kMaxSequenceNumber, kValueTypeForSeek); iter->Seek(ikey.Encode()); } else { iter->SeekToFirst(); } for (; iter->Valid(); iter->Next()) { Slice key = iter->key(); Slice value = iter->value(); ++i; if (read_num > 0 && i > read_num) break; ParsedInternalKey ikey; if (!ParseInternalKey(key, &ikey)) { std::cerr << "Internal Key [" << key.ToString(true /* in hex*/) << "] parse error!\n"; continue; } // If end marker was specified, we stop before it if (has_to && BytewiseComparator()->Compare(ikey.user_key, to_key) >= 0) { break; } if (print_kv) { fprintf(stdout, "%s => %s\n", ikey.DebugString(output_hex_).c_str(), value.ToString(output_hex_).c_str()); } } read_num_ += i; Status ret = iter->status(); delete iter; return ret; } Status SstFileReader::ReadTableProperties( std::shared_ptr* table_properties) { if (!table_reader_) { return init_result_; } *table_properties = table_reader_->GetTableProperties(); return init_result_; } namespace { void print_help() { fprintf(stderr, "sst_dump [--command=check|scan|none] [--verify_checksum] " "--file=data_dir_OR_sst_file" " [--output_hex]" " [--input_key_hex]" " [--from=]" " [--to=]" " [--read_num=NUM]" " [--show_properties]\n"); } string HexToString(const string& str) { string parsed; if (str[0] != '0' || str[1] != 'x') { fprintf(stderr, "Invalid hex input %s. Must start with 0x\n", str.c_str()); throw "Invalid hex input"; } for (unsigned int i = 2; i < str.length();) { int c; sscanf(str.c_str() + i, "%2X", &c); parsed.push_back(c); i += 2; } return parsed; } } // namespace void SSTDumpTool::Run(int argc, char** argv) { const char* dir_or_file = nullptr; uint64_t read_num = -1; std::string command; char junk; uint64_t n; bool verify_checksum = false; bool output_hex = false; bool input_key_hex = false; bool has_from = false; bool has_to = false; bool show_properties = false; std::string from_key; std::string to_key; for (int i = 1; i < argc; i++) { if (strncmp(argv[i], "--file=", 7) == 0) { dir_or_file = argv[i] + 7; } else if (strcmp(argv[i], "--output_hex") == 0) { output_hex = true; } else if (strcmp(argv[i], "--input_key_hex") == 0) { input_key_hex = true; } else if (sscanf(argv[i], "--read_num=%lu%c", (unsigned long*)&n, &junk) == 1) { read_num = n; } else if (strcmp(argv[i], "--verify_checksum") == 0) { verify_checksum = true; } else if (strncmp(argv[i], "--command=", 10) == 0) { command = argv[i] + 10; } else if (strncmp(argv[i], "--from=", 7) == 0) { from_key = argv[i] + 7; has_from = true; } else if (strncmp(argv[i], "--to=", 5) == 0) { to_key = argv[i] + 5; has_to = true; } else if (strcmp(argv[i], "--show_properties") == 0) { show_properties = true; } else { print_help(); exit(1); } } if (input_key_hex) { if (has_from) { from_key = HexToString(from_key); } if (has_to) { to_key = HexToString(to_key); } } if (dir_or_file == nullptr) { print_help(); exit(1); } std::vector filenames; rocksdb::Env* env = rocksdb::Env::Default(); rocksdb::Status st = env->GetChildren(dir_or_file, &filenames); bool dir = true; if (!st.ok()) { filenames.clear(); filenames.push_back(dir_or_file); dir = false; } fprintf(stdout, "from [%s] to [%s]\n", rocksdb::Slice(from_key).ToString(true).c_str(), rocksdb::Slice(to_key).ToString(true).c_str()); uint64_t total_read = 0; for (size_t i = 0; i < filenames.size(); i++) { std::string filename = filenames.at(i); if (filename.length() <= 4 || filename.rfind(".sst") != filename.length() - 4) { // ignore continue; } if (dir) { filename = std::string(dir_or_file) + "/" + filename; } rocksdb::SstFileReader reader(filename, verify_checksum, output_hex); // scan all files in give file path. if (command == "" || command == "scan" || command == "check") { st = reader.ReadSequential(command != "check", read_num > 0 ? (read_num - total_read) : read_num, has_from, from_key, has_to, to_key); if (!st.ok()) { fprintf(stderr, "%s: %s\n", filename.c_str(), st.ToString().c_str()); } total_read += reader.GetReadNumber(); if (read_num > 0 && total_read > read_num) { break; } } if (show_properties) { const rocksdb::TableProperties* table_properties; std::shared_ptr table_properties_from_reader; st = reader.ReadTableProperties(&table_properties_from_reader); if (!st.ok()) { fprintf(stderr, "%s: %s\n", filename.c_str(), st.ToString().c_str()); fprintf(stderr, "Try to use initial table properties\n"); table_properties = reader.GetInitTableProperties(); } else { table_properties = table_properties_from_reader.get(); } if (table_properties != nullptr) { fprintf(stdout, "Table Properties:\n" "------------------------------\n" " %s", table_properties->ToString("\n ", ": ").c_str()); fprintf(stdout, "# deleted keys: %" PRIu64 "\n", rocksdb::GetDeletedKeys( table_properties->user_collected_properties)); } } } } } // namespace rocksdb