Skip to content

Latest commit

 

History

History
32 lines (23 loc) · 2.16 KB

Single-Delete.md

File metadata and controls

32 lines (23 loc) · 2.16 KB

这个功能会删除一个key的最后一个版本的值,但是旧的版本的值会不会重新出现,不确定

基本使用

SingleDelete是一个新的数据库操作。与传统的Delete操作不同,被删除的项,会在压缩的时候与数值一起被移除。因此,与Delete类似,SingleDelete删除一个key,但是有一个前提,就是这个key存在且没有被覆盖过。成功返回OK,否则返回非OK。如果key不存在,不会报错。如果key被覆盖过(多次调用Put),那么对一个key调用SingleDelete会导致未定义行为。只有当一个key在上次调用过SingleDelete之后只被Put过一次,SingleDelete才能正确执行。这个功能目前还是为了处理某些非常特别的工作的实验性质的。下面一段代码展示了如何使用SingleDelete:

std::string value;
  rocksdb::Status s;
  db->Put(rocksdb::WriteOptions(), "foo", "bar1");
  db->SingleDelete(rocksdb::WriteOptions(), "foo");
  s = db->Get(rocksdb::ReadOptions(), "foo", &value); // s.IsNotFound()==true
  db->Put(rocksdb::WriteOptions(), "foo", "bar2");
  db->Put(rocksdb::WriteOptions(), "foo", "bar3");
  db->SingleDelete(rocksdb::ReadOptions(), "foo", &value); // Undefined result
SingleDelete API is also available in WriteBatch. Actually, DB::SingleDelete() is implemented by creating a WriteBatch with only one operation, SingleDelete, in this batch. The following code snippet shows the basic usage of WriteBatch::SingleDelete():
  rocksdb::WriteBatch batch;
  batch.Put(key1, value);
  batch.SingleDelete(key1);
  s = db->Write(rocksdb::WriteOptions(), &batch);

注意

  • 调用者必须却表SingleDelete只用在那些没有被Delete删除,或者使用Merge写入过的key。混合使用SingleDelete,Delete和Merge会导致未定义行为(其他的key不会受影响)。
  • SingleDelete与cuckoo哈希表不兼容,如果你把options.memtable_factory设置为NewHashCuckooRepFactory,那么你就无法使用SingleDelete
  • 不允许连续的SingleDelete
  • 考虑设置write_options.sync为true