org.rocksdb

类 TtlDB

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksObject

org.rocksdb.RocksDB

org.rocksdb.TtlDB

所有已实现的接口:

java.lang.AutoCloseable

public class TtlDB
extends RocksDB

Database with TTL support.

Use case

This API should be used to open the db when key-values inserted are meant to be removed from the db in a non-strict 'ttl' amount of time Therefore, this guarantees that key-values inserted will remain in the db for >= ttl amount of time and the db will make efforts to remove the key-values as soon as possible after ttl seconds of their insertion.

Behaviour

TTL is accepted in seconds (int32_t)Timestamp(creation) is suffixed to values in Put internally Expired TTL values deleted in compaction only:(Timestamp+ttl<time_now) Get/Iterator may return expired entries(compaction not run on them yet) Different TTL may be used during different Opens

Example

• Open1 at t=0 with ttl=4 and insert k1,k2, close at t=2
• Open2 at t=3 with ttl=5. Now k1,k2 should be deleted at t>=5

read_only=true opens in the usual read-only mode. Compactions will not be triggered(neither manual nor automatic), so no expired entries removed

Constraints

Not specifying/passing or non-positive TTL behaves like TTL = infinity

!!!WARNING!!!

Calling DB::Open directly to re-open a db created by this API will get corrupt values(timestamp suffixed) and no ttl effect will be there during the second Open, so use this API consistently to open the db Be careful when passing ttl with a small positive value because the whole database may be deleted in a small amount of time.

嵌套类概要

从类继承的嵌套类/接口 org.rocksdb.RocksDB

RocksDB.CountAndSize, RocksDB.LiveFiles, RocksDB.Version

字段概要

从类继承的字段 org.rocksdb.RocksDB

DEFAULT_COLUMN_FAMILY, NOT_FOUND, options_

从类继承的字段 org.rocksdb.RocksObject

nativeHandle_

从类继承的字段 org.rocksdb.AbstractImmutableNativeReference

owningHandle_

构造器概要

构造器

限定符	构造器和说明
protected	TtlDB(long nativeHandle) A protected constructor that will be used in the static factory method open(Options, String, int, boolean) and open(DBOptions, String, java.util.List, java.util.List, java.util.List, boolean).

方法概要

限定符和类型	方法和说明
void	close() Close the TtlDB instance and release resource.
void	closeE() Close the TtlDB instance and release resource.
ColumnFamilyHandle	createColumnFamilyWithTtl(ColumnFamilyDescriptor columnFamilyDescriptor, int ttl) Creates a new ttl based column family with a name defined in given ColumnFamilyDescriptor and allocates a ColumnFamilyHandle within an internal structure.
protected void	disposeInternal(long handle)
static TtlDB	open(DBOptions options, java.lang.String db_path, java.util.List<ColumnFamilyDescriptor> columnFamilyDescriptors, java.util.List<ColumnFamilyHandle> columnFamilyHandles, java.util.List<java.lang.Integer> ttlValues, boolean readOnly) Opens a TtlDB.
static TtlDB	open(Options options, java.lang.String db_path) Opens a TtlDB.
static TtlDB	open(Options options, java.lang.String db_path, int ttl, boolean readOnly) Opens a TtlDB.

从类继承的方法 org.rocksdb.RocksDB

cancelAllBackgroundWork, compactFiles, compactFiles, compactRange, compactRange, compactRange, compactRange, compactRange, continueBackgroundWork, createColumnFamilies, createColumnFamilies, createColumnFamily, delete, delete, delete, delete, delete, delete, delete, delete, delete, delete, deleteFile, deleteFilesInRanges, deleteRange, deleteRange, deleteRange, deleteRange, destroyColumnFamilyHandle, destroyDB, disableFileDeletions, dropColumnFamilies, dropColumnFamily, enableAutoCompaction, enableFileDeletions, endTrace, flush, flush, flush, flushWal, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, get, getAggregatedLongProperty, getApproximateMemTableStats, getApproximateMemTableStats, getApproximateSizes, getApproximateSizes, getColumnFamilyMetaData, getColumnFamilyMetaData, getDBOptions, getDefaultColumnFamily, getEnv, getLatestSequenceNumber, getLiveFiles, getLiveFiles, getLiveFilesMetaData, getLongProperty, getLongProperty, getMapProperty, getMapProperty, getName, getOptions, getOptions, getPropertiesOfAllTables, getPropertiesOfAllTables, getPropertiesOfTablesInRange, getPropertiesOfTablesInRange, getProperty, getProperty, getSnapshot, getSortedWalFiles, getUpdatesSince, ingestExternalFile, ingestExternalFile, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, keyMayExist, level0StopWriteTrigger, level0StopWriteTrigger, listColumnFamilies, loadLibrary, loadLibrary, maxMemCompactionLevel, maxMemCompactionLevel, merge, merge, merge, merge, merge, merge, merge, merge, multiGetAsList, multiGetAsList, multiGetAsList, multiGetAsList, multiGetByteBuffers, multiGetByteBuffers, multiGetByteBuffers, multiGetByteBuffers, newIterator, newIterator, newIterator, newIterator, newIterators, newIterators, numberLevels, numberLevels, open, open, open, openAsSecondary, openAsSecondary, openReadOnly, openReadOnly, openReadOnly, openReadOnly, openReadOnly, openReadOnly, pauseBackgroundWork, promoteL0, promoteL0, put, put, put, put, put, put, put, put, put, put, releaseSnapshot, resetStats, rocksdbVersion, setDBOptions, setOptions, setOptions, singleDelete, singleDelete, singleDelete, singleDelete, startTrace, storeOptionsInstance, suggestCompactRange, suggestCompactRange, syncWal, tryCatchUpWithPrimary, verifyChecksum, write, write

从类继承的方法 org.rocksdb.RocksObject

disposeInternal, getNativeHandle

从类继承的方法 org.rocksdb.AbstractImmutableNativeReference

disOwnNativeHandle, isOwningHandle

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

TtlDB

protected TtlDB(long nativeHandle)

A protected constructor that will be used in the static factory method open(Options, String, int, boolean) and open(DBOptions, String, java.util.List, java.util.List, java.util.List, boolean).

参数:

nativeHandle - The native handle of the C++ TtlDB object

方法详细资料

open

public static TtlDB open(Options options,
                         java.lang.String db_path)
                  throws RocksDBException

Opens a TtlDB.

Database is opened in read-write mode without default TTL.

参数:

options - Options instance.

db_path - path to database.

返回:

TtlDB instance.

抛出:

RocksDBException - thrown if an error occurs within the native part of the library.

open

public static TtlDB open(Options options,
                         java.lang.String db_path,
                         int ttl,
                         boolean readOnly)
                  throws RocksDBException

Opens a TtlDB.

参数:

options - Options instance.

db_path - path to database.

ttl - time to live for new entries.

readOnly - boolean value indicating if database if db is opened read-only.

返回:

TtlDB instance.

抛出:

RocksDBException - thrown if an error occurs within the native part of the library.

open

public static TtlDB open(DBOptions options,
                         java.lang.String db_path,
                         java.util.List<ColumnFamilyDescriptor> columnFamilyDescriptors,
                         java.util.List<ColumnFamilyHandle> columnFamilyHandles,
                         java.util.List<java.lang.Integer> ttlValues,
                         boolean readOnly)
                  throws RocksDBException

Opens a TtlDB.

参数:

options - Options instance.

db_path - path to database.

columnFamilyDescriptors - list of column family descriptors

columnFamilyHandles - will be filled with ColumnFamilyHandle instances on open.

ttlValues - time to live values per column family handle

readOnly - boolean value indicating if database if db is opened read-only.

返回:

TtlDB instance.

抛出:

RocksDBException - thrown if an error occurs within the native part of the library.

java.lang.IllegalArgumentException - when there is not a ttl value per given column family handle.

closeE

public void closeE()
            throws RocksDBException

Close the TtlDB instance and release resource.

This is similar to close() except that it throws an exception if any error occurs.

This will not fsync the WAL files. If syncing is required, the caller must first call RocksDB.syncWal() or RocksDB.write(WriteOptions, WriteBatch) using an empty write batch with WriteOptions.setSync(boolean) set to true.

See also close().

覆盖:

closeE 在类中 RocksDB

抛出:

RocksDBException - if an error occurs whilst closing.

close

public void close()

Close the TtlDB instance and release resource.

This will not fsync the WAL files. If syncing is required, the caller must first call RocksDB.syncWal() or RocksDB.write(WriteOptions, WriteBatch) using an empty write batch with WriteOptions.setSync(boolean) set to true.

See also close().

指定者:

close 在接口中 java.lang.AutoCloseable

覆盖:

close 在类中 RocksDB

createColumnFamilyWithTtl

public ColumnFamilyHandle createColumnFamilyWithTtl(ColumnFamilyDescriptor columnFamilyDescriptor,
                                                    int ttl)
                                             throws RocksDBException

Creates a new ttl based column family with a name defined in given ColumnFamilyDescriptor and allocates a ColumnFamilyHandle within an internal structure.

The ColumnFamilyHandle is automatically disposed with DB disposal.

参数:

columnFamilyDescriptor - column family to be created.

ttl - TTL to set for this column family.

返回:

ColumnFamilyHandle instance.

抛出:

RocksDBException - thrown if error happens in underlying native library.

disposeInternal

protected void disposeInternal(long handle)

覆盖:

disposeInternal 在类中 RocksDB