NAME

RocksDB::WriteBatch - rocksdb::WriteBatch object

SYNOPSIS

  use RocksDB;

  my $db = RocksDB->new('/path/to/db');
  $db->update(sub {
      my $batch = shift;
      $batch->put(key => 'value');
      $batch->delete('key');
  });

  my $batch = RocksDB::WriteBatch->new;
  $batch->put(key => 'value');
  $batch->clear;
  $batch->delete('key');
  $batch->put_log_data(time());
  $db->write($batch);

DESCRIPTION

RocksDB::WriteBatch is a rocksdb::WriteBatch object.

CONSTRUCTOR

RocksDB::WriteBatch->new() :RocksDB::WriteBatch

Create and return a new RocksDB::WriteBatch object.

METHODS

$batch->put($key :Str, $value :Str) :Undef

Store the mapping $key -> $value in the database.

$batch->delete($key :Str) :Undef

If the database contains a mapping for $key, erase it. Else do nothing.

$batch->put_log_data($blob :Str) :Undef

Append a blob of arbitrary size to the records in this batch. The blob will be stored in the transaction log but not in any other file. In particular, it will not be persisted to the SST files. When iterating over this WriteBatch, WriteBatchHandler::log_data will be called with the contents of the blob as it is encountered. Blobs, puts, deletes, and merges will be encountered in the same order in thich they were inserted. The blob will NOT consume sequence number(s) and will NOT increase the count of the batch

Example application: add timestamps to the transaction log for use in replication.

See also RocksDB::WriteBatchHandler.

$batch->clear() :Undef

Clear all updates buffered in this batch.

$batch->count() :Int

Returns the number of updates in the batch.

$batch->data() :Str

Retrieve the serialized version of this batch.

$batch->iterate($handler :RocksDB::WriteBatchHandler) :Undef

Support for iterating over the contents of a batch.

See RocksDB::WriteBatchHandler.

SEE ALSO

RocksDB, RocksDB::WriteBatchHandler

AUTHOR

Jiro Nishiguchi <jiro@cpan.org>

cpanm RocksDB

perl -MCPAN -e shell
install RocksDB