org.rocksdb

类 IngestExternalFileOptions

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksObject

org.rocksdb.IngestExternalFileOptions

所有已实现的接口:

java.lang.AutoCloseable

public class IngestExternalFileOptions
extends RocksObject

IngestExternalFileOptions is used by RocksDB.ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions).

字段概要

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

nativeHandle_

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

owningHandle_

构造器概要

构造器

构造器和说明
IngestExternalFileOptions()
IngestExternalFileOptions(boolean moveFiles, boolean snapshotConsistency, boolean allowGlobalSeqNo, boolean allowBlockingFlush)

方法概要

限定符和类型	方法和说明
boolean	allowBlockingFlush() If set to false and the file key range overlaps with the memtable key range (memtable flush required), IngestExternalFile will fail.
boolean	allowGlobalSeqNo() If set to false, RocksDB.ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions) will fail if the file key range overlaps with existing keys or tombstones in the DB.
protected void	disposeInternal(long handle)
boolean	ingestBehind() Returns true if duplicate keys in the file being ingested are to be skipped rather than overwriting existing data under that key.
boolean	moveFiles() Can be set to true to move the files instead of copying them.
IngestExternalFileOptions	setAllowBlockingFlush(boolean allowBlockingFlush) If set to false and the file key range overlaps with the memtable key range (memtable flush required), IngestExternalFile will fail.
IngestExternalFileOptions	setAllowGlobalSeqNo(boolean allowGlobalSeqNo) If set to false, RocksDB.ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions) will fail if the file key range overlaps with existing keys or tombstones in the DB.
IngestExternalFileOptions	setIngestBehind(boolean ingestBehind) Set to true if you would like duplicate keys in the file being ingested to be skipped rather than overwriting existing data under that key.
IngestExternalFileOptions	setMoveFiles(boolean moveFiles) Can be set to true to move the files instead of copying them.
IngestExternalFileOptions	setSnapshotConsistency(boolean snapshotConsistency) If set to false, an ingested file keys could appear in existing snapshots that where created before the file was ingested.
IngestExternalFileOptions	setWriteGlobalSeqno(boolean writeGlobalSeqno) Set to true if you would like to write the global_seqno to a given offset in the external SST file for backward compatibility.
boolean	snapshotConsistency() If set to false, an ingested file keys could appear in existing snapshots that where created before the file was ingested.
boolean	writeGlobalSeqno() Returns true write if the global_seqno is written to a given offset in the external SST file for backward compatibility.

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

disposeInternal, getNativeHandle

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

close, disOwnNativeHandle, isOwningHandle

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

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

构造器详细资料

IngestExternalFileOptions

public IngestExternalFileOptions()

IngestExternalFileOptions

public IngestExternalFileOptions(boolean moveFiles,
                                 boolean snapshotConsistency,
                                 boolean allowGlobalSeqNo,
                                 boolean allowBlockingFlush)

参数:

moveFiles - setMoveFiles(boolean)

snapshotConsistency - setSnapshotConsistency(boolean)

allowGlobalSeqNo - setAllowGlobalSeqNo(boolean)

allowBlockingFlush - setAllowBlockingFlush(boolean)

方法详细资料

moveFiles

public boolean moveFiles()

Can be set to true to move the files instead of copying them.

返回:

true if files will be moved

setMoveFiles

public IngestExternalFileOptions setMoveFiles(boolean moveFiles)

Can be set to true to move the files instead of copying them.

参数:

moveFiles - true if files should be moved instead of copied

返回:

the reference to the current IngestExternalFileOptions.

snapshotConsistency

public boolean snapshotConsistency()

If set to false, an ingested file keys could appear in existing snapshots that where created before the file was ingested.

返回:

true if snapshot consistency is assured

setSnapshotConsistency

public IngestExternalFileOptions setSnapshotConsistency(boolean snapshotConsistency)

If set to false, an ingested file keys could appear in existing snapshots that where created before the file was ingested.

参数:

snapshotConsistency - true if snapshot consistency is required

返回:

the reference to the current IngestExternalFileOptions.

allowGlobalSeqNo

public boolean allowGlobalSeqNo()

If set to false, RocksDB.ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions) will fail if the file key range overlaps with existing keys or tombstones in the DB.

返回:

true if global seq numbers are assured

setAllowGlobalSeqNo

public IngestExternalFileOptions setAllowGlobalSeqNo(boolean allowGlobalSeqNo)

If set to false, RocksDB.ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions) will fail if the file key range overlaps with existing keys or tombstones in the DB.

参数:

allowGlobalSeqNo - true if global seq numbers are required

返回:

the reference to the current IngestExternalFileOptions.

allowBlockingFlush

public boolean allowBlockingFlush()

If set to false and the file key range overlaps with the memtable key range (memtable flush required), IngestExternalFile will fail.

返回:

true if blocking flushes may occur

setAllowBlockingFlush

public IngestExternalFileOptions setAllowBlockingFlush(boolean allowBlockingFlush)

If set to false and the file key range overlaps with the memtable key range (memtable flush required), IngestExternalFile will fail.

参数:

allowBlockingFlush - true if blocking flushes are allowed

返回:

the reference to the current IngestExternalFileOptions.

ingestBehind

public boolean ingestBehind()

Returns true if duplicate keys in the file being ingested are to be skipped rather than overwriting existing data under that key.

返回:

true if duplicate keys in the file being ingested are to be skipped, false otherwise.

setIngestBehind

public IngestExternalFileOptions setIngestBehind(boolean ingestBehind)

Set to true if you would like duplicate keys in the file being ingested to be skipped rather than overwriting existing data under that key.

Usecase: back-fill of some historical data in the database without over-writing existing newer version of data.

This option could only be used if the DB has been running with DBOptions#allowIngestBehind() == true since the dawn of time.

All files will be ingested at the bottommost level with seqno=0.

Default: false

参数:

ingestBehind - true if you would like duplicate keys in the file being ingested to be skipped.

返回:

the reference to the current IngestExternalFileOptions.

writeGlobalSeqno

public boolean writeGlobalSeqno()

Returns true write if the global_seqno is written to a given offset in the external SST file for backward compatibility.

See setWriteGlobalSeqno(boolean).

返回:

true if the global_seqno is written to a given offset, false otherwise.

setWriteGlobalSeqno

public IngestExternalFileOptions setWriteGlobalSeqno(boolean writeGlobalSeqno)

Set to true if you would like to write the global_seqno to a given offset in the external SST file for backward compatibility.

Older versions of RocksDB write the global_seqno to a given offset within the ingested SST files, and new versions of RocksDB do not.

If you ingest an external SST using new version of RocksDB and would like to be able to downgrade to an older version of RocksDB, you should set writeGlobalSeqno() to true.

If your service is just starting to use the new RocksDB, we recommend that you set this option to false, which brings two benefits: 1. No extra random write for global_seqno during ingestion. 2. Without writing external SST file, it's possible to do checksum.

We have a plan to set this option to false by default in the future.

Default: true

参数:

writeGlobalSeqno - true to write the gloal_seqno to a given offset, false otherwise

返回:

the reference to the current IngestExternalFileOptions.

disposeInternal

protected final void disposeInternal(long handle)

指定者:

disposeInternal 在类中 RocksObject