2013-10-29 00:54:09 +00:00
|
|
|
// 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.
|
|
|
|
//
|
|
|
|
// 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.
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
|
|
|
2014-05-15 21:09:03 +00:00
|
|
|
#include <memory>
|
|
|
|
#include <string>
|
|
|
|
|
2013-11-20 06:00:48 +00:00
|
|
|
#include "rocksdb/flush_block_policy.h"
|
2013-10-29 00:54:09 +00:00
|
|
|
#include "rocksdb/table.h"
|
2014-08-25 21:22:05 +00:00
|
|
|
#include "db/dbformat.h"
|
2013-10-29 00:54:09 +00:00
|
|
|
|
|
|
|
namespace rocksdb {
|
|
|
|
|
|
|
|
struct EnvOptions;
|
|
|
|
|
|
|
|
using std::unique_ptr;
|
|
|
|
class BlockBasedTableBuilder;
|
|
|
|
|
2014-01-28 05:58:46 +00:00
|
|
|
class BlockBasedTableFactory : public TableFactory {
|
2014-01-24 18:57:15 +00:00
|
|
|
public:
|
2014-01-28 05:58:46 +00:00
|
|
|
explicit BlockBasedTableFactory(
|
2014-03-01 00:39:27 +00:00
|
|
|
const BlockBasedTableOptions& table_options = BlockBasedTableOptions());
|
2013-11-21 02:42:12 +00:00
|
|
|
|
2014-01-24 18:57:15 +00:00
|
|
|
~BlockBasedTableFactory() {}
|
2013-11-20 06:00:48 +00:00
|
|
|
|
2014-01-24 18:57:15 +00:00
|
|
|
const char* Name() const override { return "BlockBasedTable"; }
|
2013-11-20 06:00:48 +00:00
|
|
|
|
2015-09-11 18:36:33 +00:00
|
|
|
Status NewTableReader(const TableReaderOptions& table_reader_options,
|
Move rate_limiter, write buffering, most perf context instrumentation and most random kill out of Env
Summary: We want to keep Env a think layer for better portability. Less platform dependent codes should be moved out of Env. In this patch, I create a wrapper of file readers and writers, and put rate limiting, write buffering, as well as most perf context instrumentation and random kill out of Env. It will make it easier to maintain multiple Env in the future.
Test Plan: Run all existing unit tests.
Reviewers: anthony, kradhakrishnan, IslamAbdelRahman, yhchiang, igor
Reviewed By: igor
Subscribers: leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D42321
2015-07-17 23:16:11 +00:00
|
|
|
unique_ptr<RandomAccessFileReader>&& file,
|
|
|
|
uint64_t file_size,
|
2015-09-11 18:36:33 +00:00
|
|
|
unique_ptr<TableReader>* table_reader) const override;
|
2015-02-26 00:34:26 +00:00
|
|
|
|
|
|
|
// This is a variant of virtual member function NewTableReader function with
|
|
|
|
// added capability to disable pre-fetching of blocks on BlockBasedTable::Open
|
2015-09-11 18:36:33 +00:00
|
|
|
Status NewTableReader(const TableReaderOptions& table_reader_options,
|
Move rate_limiter, write buffering, most perf context instrumentation and most random kill out of Env
Summary: We want to keep Env a think layer for better portability. Less platform dependent codes should be moved out of Env. In this patch, I create a wrapper of file readers and writers, and put rate limiting, write buffering, as well as most perf context instrumentation and random kill out of Env. It will make it easier to maintain multiple Env in the future.
Test Plan: Run all existing unit tests.
Reviewers: anthony, kradhakrishnan, IslamAbdelRahman, yhchiang, igor
Reviewed By: igor
Subscribers: leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D42321
2015-07-17 23:16:11 +00:00
|
|
|
unique_ptr<RandomAccessFileReader>&& file,
|
|
|
|
uint64_t file_size,
|
2015-02-26 00:34:26 +00:00
|
|
|
unique_ptr<TableReader>* table_reader,
|
|
|
|
bool prefetch_index_and_filter) const;
|
2013-10-29 00:54:09 +00:00
|
|
|
|
2014-01-27 21:53:22 +00:00
|
|
|
TableBuilder* NewTableBuilder(
|
A new call back to TablePropertiesCollector to allow users know the entry is add, delete or merge
Summary:
Currently users have no idea a key is add, delete or merge from TablePropertiesCollector call back. Add a new function to add it.
Also refactor the codes so that
(1) make table property collector and internal table property collector two separate data structures with the later one now exposed
(2) table builders only receive internal table properties
Test Plan: Add cases in table_properties_collector_test to cover both of old and new ways of using TablePropertiesCollector.
Reviewers: yhchiang, igor.sugak, rven, igor
Reviewed By: rven, igor
Subscribers: meyering, yoshinorim, maykov, leveldb, dhruba
Differential Revision: https://reviews.facebook.net/D35373
2015-04-06 17:04:30 +00:00
|
|
|
const TableBuilderOptions& table_builder_options,
|
2015-10-08 23:57:35 +00:00
|
|
|
uint32_t column_family_id, WritableFileWriter* file) const override;
|
2013-11-20 06:00:48 +00:00
|
|
|
|
2014-08-20 22:53:39 +00:00
|
|
|
// Sanitizes the specified DB Options.
|
2014-10-18 04:18:36 +00:00
|
|
|
Status SanitizeOptions(const DBOptions& db_opts,
|
|
|
|
const ColumnFamilyOptions& cf_opts) const override;
|
2014-08-20 22:53:39 +00:00
|
|
|
|
2014-08-25 21:24:09 +00:00
|
|
|
std::string GetPrintableTableOptions() const override;
|
|
|
|
|
2015-10-30 22:58:46 +00:00
|
|
|
const BlockBasedTableOptions& table_options() const;
|
2014-11-21 03:24:39 +00:00
|
|
|
|
Add OptionsUtil::LoadOptionsFromFile() API
Summary:
This patch adds OptionsUtil::LoadOptionsFromFile() and
OptionsUtil::LoadLatestOptionsFromDB(), which allow developers
to construct DBOptions and ColumnFamilyOptions from a RocksDB
options file. Note that most pointer-typed options such as
merge_operator will not be constructed.
With this API, developers no longer need to remember all the
options in order to reopen an existing rocksdb instance like
the following:
DBOptions db_options;
std::vector<std::string> cf_names;
std::vector<ColumnFamilyOptions> cf_opts;
// Load primitive-typed options from an existing DB
OptionsUtil::LoadLatestOptionsFromDB(
dbname, &db_options, &cf_names, &cf_opts);
// Initialize necessary pointer-typed options
cf_opts[0].merge_operator.reset(new MyMergeOperator());
...
// Construct the vector of ColumnFamilyDescriptor
std::vector<ColumnFamilyDescriptor> cf_descs;
for (size_t i = 0; i < cf_opts.size(); ++i) {
cf_descs.emplace_back(cf_names[i], cf_opts[i]);
}
// Open the DB
DB* db = nullptr;
std::vector<ColumnFamilyHandle*> cf_handles;
auto s = DB::Open(db_options, dbname, cf_descs,
&handles, &db);
Test Plan:
Augment existing tests in column_family_test
options_test
db_test
Reviewers: igor, IslamAbdelRahman, sdong, anthony
Reviewed By: anthony
Subscribers: dhruba, leveldb
Differential Revision: https://reviews.facebook.net/D49095
2015-11-12 14:52:43 +00:00
|
|
|
void* GetOptions() override { return &table_options_; }
|
|
|
|
|
2013-11-20 06:00:48 +00:00
|
|
|
private:
|
2014-01-24 18:57:15 +00:00
|
|
|
BlockBasedTableOptions table_options_;
|
2013-10-29 00:54:09 +00:00
|
|
|
};
|
|
|
|
|
2014-05-15 21:09:03 +00:00
|
|
|
extern const std::string kHashIndexPrefixesBlock;
|
|
|
|
extern const std::string kHashIndexPrefixesMetadataBlock;
|
2015-02-05 01:03:57 +00:00
|
|
|
extern const std::string kPropTrue;
|
|
|
|
extern const std::string kPropFalse;
|
2014-05-15 21:09:03 +00:00
|
|
|
|
2013-10-29 00:54:09 +00:00
|
|
|
} // namespace rocksdb
|