038a477b53
Summary: This diff is addressing multiple things with a single goal -- to make RocksDB easier to use: * Add some functions to Options that make RocksDB easier to tune. * Add example code for both simple RocksDB and RocksDB with Column Families. * Rewrite our README.md Regarding Options, I took a stab at something we talked about for a long time: * https://www.facebook.com/groups/rocksdb.dev/permalink/563169950448190/ I added functions: * IncreaseParallelism() -- easy, increases the thread pool and max_background_compactions * OptimizeLevelStyleCompaction(memtable_memory_budget) -- the easiest way to optimize rocksdb for less stalls with level style compaction. This is very likely not ideal configuration. Feel free to suggest improvements. I used some of Mark's suggestions from here: https://github.com/facebook/rocksdb/issues/54 * OptimizeUniversalStyleCompaction(memtable_memory_budget) -- optimize for universal compaction. Test Plan: compiled rocksdb. ran examples. Reviewers: dhruba, MarkCallaghan, haobo, sdong, yhchiang Reviewed By: dhruba CC: leveldb Differential Revision: https://reviews.facebook.net/D18621
73 lines
2.0 KiB
C++
73 lines
2.0 KiB
C++
// 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 <cstdio>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "rocksdb/db.h"
|
|
#include "rocksdb/slice.h"
|
|
#include "rocksdb/options.h"
|
|
|
|
using namespace rocksdb;
|
|
|
|
std::string kDBPath = "/tmp/rocksdb_column_families_example";
|
|
|
|
int main() {
|
|
// open DB
|
|
Options options;
|
|
options.create_if_missing = true;
|
|
DB* db;
|
|
Status s = DB::Open(options, kDBPath, &db);
|
|
assert(s.ok());
|
|
|
|
// create column family
|
|
ColumnFamilyHandle* cf;
|
|
s = db->CreateColumnFamily(ColumnFamilyOptions(), "new_cf", &cf);
|
|
assert(s.ok());
|
|
|
|
// close DB
|
|
delete cf;
|
|
delete db;
|
|
|
|
// open DB with two column families
|
|
std::vector<ColumnFamilyDescriptor> column_families;
|
|
// have to open default column familiy
|
|
column_families.push_back(ColumnFamilyDescriptor(
|
|
kDefaultColumnFamilyName, ColumnFamilyOptions()));
|
|
// open the new one, too
|
|
column_families.push_back(ColumnFamilyDescriptor(
|
|
"new_cf", ColumnFamilyOptions()));
|
|
std::vector<ColumnFamilyHandle*> handles;
|
|
s = DB::Open(DBOptions(), kDBPath, column_families, &handles, &db);
|
|
assert(s.ok());
|
|
|
|
// put and get from non-default column family
|
|
s = db->Put(WriteOptions(), handles[1], Slice("key"), Slice("value"));
|
|
assert(s.ok());
|
|
std::string value;
|
|
s = db->Get(ReadOptions(), handles[1], Slice("key"), &value);
|
|
assert(s.ok());
|
|
|
|
// atomic write
|
|
WriteBatch batch;
|
|
batch.Put(handles[0], Slice("key2"), Slice("value2"));
|
|
batch.Put(handles[1], Slice("key3"), Slice("value3"));
|
|
batch.Delete(handles[0], Slice("key"));
|
|
s = db->Write(WriteOptions(), &batch);
|
|
assert(s.ok());
|
|
|
|
// drop column family
|
|
s = db->DropColumnFamily(handles[1]);
|
|
assert(s.ok());
|
|
|
|
// close db
|
|
for (auto handle : handles) {
|
|
delete handle;
|
|
}
|
|
delete db;
|
|
|
|
return 0;
|
|
}
|