ColumnFamilyOptionsInterface

All Superinterfaces:: AdvancedColumnFamilyOptionsInterface<T>

All Known Implementing Classes:: ColumnFamilyOptions, Options

public interface ColumnFamilyOptionsInterface<T extends ColumnFamilyOptionsInterface<T>>
extends AdvancedColumnFamilyOptionsInterface<T>

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`DEFAULT_COMPACTION_MEMTABLE_MEMORY_BUDGET` Default memtable memory budget used with the following methods: `optimizeLevelStyleCompaction()` `optimizeUniversalStyleCompaction()`

Method Summary

Methods
Modifier and Type	Method and Description
`CompressionOptions`	`bottommostCompressionOptions()` Get the bottom most compression options.
`CompressionType`	`bottommostCompressionType()` Compression algorithm that will be used for the bottommost level that contain files.
`java.util.List<DbPath>`	`cfPaths()`
`AbstractCompactionFilter<? extends AbstractSlice<?>>`	`compactionFilter()` Accessor for the CompactionFilter instance in use.
`AbstractCompactionFilterFactory<? extends AbstractCompactionFilter<?>>`	`compactionFilterFactory()` Accessor for the CompactionFilterFactory instance in use.
`ConcurrentTaskLimiter`	`compactionThreadLimiter()` Get compaction thread limiter
`CompressionOptions`	`compressionOptions()` Get the different options for compression algorithms
`int`	`levelZeroFileNumCompactionTrigger()` The number of files in level 0 to trigger compaction from level-0 to level-1.
`int`	`levelZeroSlowdownWritesTrigger()` Soft limit on the number of level-0 files.
`int`	`levelZeroStopWritesTrigger()` Maximum number of level-0 files.
`double`	`maxBytesForLevelMultiplier()` The ratio between the total size of level-(L+1) files and the total size of level-L files for all L.
`long`	`maxTableFilesSizeFIFO()` FIFO compaction option.
`MemTableConfig`	`memTableConfig()` Get the config for mem-table.
`java.lang.String`	`memTableFactoryName()` Returns the name of the current mem table representation.
`T`	`oldDefaults(int majorVersion, int minorVersion)` The function recovers options to a previous version.
`T`	`optimizeForPointLookup(long blockCacheSizeMb)` Use this if you don't need to keep the data sorted, i.e.
`T`	`optimizeForSmallDb()` Use this if your DB is very small (like under 1GB) and you don't want to spend lots of memory for memtables.
`T`	`optimizeForSmallDb(Cache cache)` Some functions that make it easier to optimize RocksDB Use this if your DB is very small (like under 1GB) and you don't want to spend lots of memory for memtables.
`T`	`optimizeLevelStyleCompaction()` Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions.
`T`	`optimizeLevelStyleCompaction(long memtableMemoryBudget)` Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions.
`T`	`optimizeUniversalStyleCompaction()` Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions.
`T`	`optimizeUniversalStyleCompaction(long memtableMemoryBudget)` Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions.
`T`	`setBottommostCompressionOptions(CompressionOptions compressionOptions)` Set the options for compression algorithms used by `bottommostCompressionType()` if it is enabled.
`T`	`setBottommostCompressionType(CompressionType bottommostCompressionType)` Compression algorithm that will be used for the bottommost level that contain files.
`T`	`setCfPaths(java.util.Collection<DbPath> paths)` A list of paths where SST files for this column family can be put into, with its target size.
`T`	`setCompactionFilter(AbstractCompactionFilter<? extends AbstractSlice<?>> compactionFilter)` A single CompactionFilter instance to call into during compaction.
`T`	`setCompactionFilterFactory(AbstractCompactionFilterFactory<? extends AbstractCompactionFilter<?>> compactionFilterFactory)` This is a factory that provides `AbstractCompactionFilter` objects which allow an application to modify/delete a key-value during background compaction.
`T`	`setCompactionThreadLimiter(ConcurrentTaskLimiter concurrentTaskLimiter)` Compaction concurrent thread limiter for the column family.
`T`	`setComparator(AbstractComparator comparator)` Use the specified comparator for key ordering.
`T`	`setComparator(BuiltinComparator builtinComparator)` Set `BuiltinComparator` to be used with RocksDB.
`T`	`setCompressionOptions(CompressionOptions compressionOptions)` Set the different options for compression algorithms
`T`	`setLevelZeroFileNumCompactionTrigger(int numFiles)` Number of files to trigger level-0 compaction.
`T`	`setLevelZeroSlowdownWritesTrigger(int numFiles)` Soft limit on number of level-0 files.
`T`	`setLevelZeroStopWritesTrigger(int numFiles)` Maximum number of level-0 files.
`T`	`setMaxBytesForLevelMultiplier(double multiplier)` The ratio between the total size of level-(L+1) files and the total size of level-L files for all L.
`T`	`setMaxTableFilesSizeFIFO(long maxTableFilesSize)` FIFO compaction option.
`T`	`setMemTableConfig(MemTableConfig memTableConfig)` Set the config for mem-table.
`T`	`setMergeOperator(MergeOperator mergeOperator)` Set the merge operator to be used for merging two different key/value pairs that share the same key.
`T`	`setMergeOperatorName(java.lang.String name)` Set the merge operator to be used for merging two merge operands of the same key.
`T`	`setSstPartitionerFactory(SstPartitionerFactory factory)` If non-nullptr, use the specified factory for a function to determine the partitioning of sst files.
`T`	`setTableFormatConfig(TableFormatConfig config)` Set the config for table format.
`SstPartitionerFactory`	`sstPartitionerFactory()` Get SST partitioner factory
`java.lang.String`	`tableFactoryName()`
`TableFormatConfig`	`tableFormatConfig()` Get the config for table format.
`T`	`useCappedPrefixExtractor(int n)` Same as fixed length prefix extractor, except that when slice is shorter than the fixed length, it will use the full key.
`T`	`useFixedLengthPrefixExtractor(int n)` This prefix-extractor uses the first n bytes of a key as its prefix.

- Field Detail
  - DEFAULT_COMPACTION_MEMTABLE_MEMORY_BUDGET
```
static final long DEFAULT_COMPACTION_MEMTABLE_MEMORY_BUDGET
```
    Default memtable memory budget used with the following methods:
    1. optimizeLevelStyleCompaction()
    2. optimizeUniversalStyleCompaction()
    See Also:
    Constant Field Values
- Method Detail
  - oldDefaults
```
T oldDefaults(int majorVersion,
            int minorVersion)
```
    The function recovers options to a previous version. Only 4.6 or later versions are supported.
    
    Returns:
    the instance of the current object.
  - optimizeForSmallDb
```
T optimizeForSmallDb()
```
    Use this if your DB is very small (like under 1GB) and you don't want to spend lots of memory for memtables.
    
    Returns:
    the instance of the current object.
  - optimizeForSmallDb
```
T optimizeForSmallDb(Cache cache)
```
    Some functions that make it easier to optimize RocksDB Use this if your DB is very small (like under 1GB) and you don't want to spend lots of memory for memtables. An optional cache object is passed in to be used as the block cache
    
    Returns:
    the instance of the current object.
  - optimizeForPointLookup
```
T optimizeForPointLookup(long blockCacheSizeMb)
```
    Use this if you don't need to keep the data sorted, i.e. you'll never use an iterator, only Put() and Get() API calls
    
    Parameters:
    blockCacheSizeMb - Block cache size in MB
    
    Returns:
    the instance of the current object.
  - optimizeLevelStyleCompaction
```
T optimizeLevelStyleCompaction()
```
    Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions. As a starting point for tuning RocksDB options, use the following for level style compaction.
    
    Make sure to also call IncreaseParallelism(), which will provide the biggest performance gains.
    
    Note: we might use more memory than memtable_memory_budget during high write rate period
    
    Returns:
    the instance of the current object.
  - optimizeLevelStyleCompaction
```
T optimizeLevelStyleCompaction(long memtableMemoryBudget)
```
    Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions. As a starting point for tuning RocksDB options, use the following for level style compaction.
    
    Make sure to also call IncreaseParallelism(), which will provide the biggest performance gains.
    
    Note: we might use more memory than memtable_memory_budget during high write rate period
    
    Parameters:
    memtableMemoryBudget - memory budget in bytes
    
    Returns:
    the instance of the current object.
  - optimizeUniversalStyleCompaction
```
T optimizeUniversalStyleCompaction()
```
    Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions. As a starting point for tuning RocksDB options, use the following for universal style compaction.
    
    Universal style compaction is focused on reducing Write Amplification Factor for big data sets, but increases Space Amplification.
    
    Make sure to also call IncreaseParallelism(), which will provide the biggest performance gains.
    
    Note: we might use more memory than memtable_memory_budget during high write rate period
    
    Returns:
    the instance of the current object.
  - optimizeUniversalStyleCompaction
```
T optimizeUniversalStyleCompaction(long memtableMemoryBudget)
```
    Default values for some parameters in ColumnFamilyOptions are not optimized for heavy workloads and big datasets, which means you might observe write stalls under some conditions. As a starting point for tuning RocksDB options, use the following for universal style compaction.
    
    Universal style compaction is focused on reducing Write Amplification Factor for big data sets, but increases Space Amplification.
    
    Make sure to also call IncreaseParallelism(), which will provide the biggest performance gains.
    
    Note: we might use more memory than memtable_memory_budget during high write rate period
    
    Parameters:
    memtableMemoryBudget - memory budget in bytes
    
    Returns:
    the instance of the current object.
  - setComparator
```
T setComparator(BuiltinComparator builtinComparator)
```
    Set BuiltinComparator to be used with RocksDB. Note: Comparator can be set once upon database creation. Default: BytewiseComparator.
    
    Parameters:
    builtinComparator - a BuiltinComparator type.
    
    Returns:
    the instance of the current object.
  - setComparator
```
T setComparator(AbstractComparator comparator)
```
    Use the specified comparator for key ordering. Comparator should not be disposed before options instances using this comparator is disposed. If dispose() function is not called, then comparator object will be GC'd automatically. Comparator instance can be re-used in multiple options instances.
    
    Parameters:
    comparator - java instance.
    
    Returns:
    the instance of the current object.
  - setMergeOperatorName
```
T setMergeOperatorName(java.lang.String name)
```
    Set the merge operator to be used for merging two merge operands of the same key. The merge function is invoked during compaction and at lookup time, if multiple key/value pairs belonging to the same key are found in the database.
    
    Parameters:
    name - the name of the merge function, as defined by the MergeOperators factory (see utilities/MergeOperators.h) The merge function is specified by name and must be one of the standard merge operators provided by RocksDB. The available operators are "put", "uint64add", "stringappend" and "stringappendtest".
    
    Returns:
    the instance of the current object.
  - setMergeOperator
```
T setMergeOperator(MergeOperator mergeOperator)
```
    Set the merge operator to be used for merging two different key/value pairs that share the same key. The merge function is invoked during compaction and at lookup time, if multiple key/value pairs belonging to the same key are found in the database.
    
    Parameters:
    mergeOperator - MergeOperator instance.
    
    Returns:
    the instance of the current object.
  - setCompactionFilter
```
T setCompactionFilter(AbstractCompactionFilter<? extends AbstractSlice<?>> compactionFilter)
```
    A single CompactionFilter instance to call into during compaction. Allows an application to modify/delete a key-value during background compaction. If the client requires a new compaction filter to be used for different compaction runs, it can specify call setCompactionFilterFactory(AbstractCompactionFilterFactory) instead. The client should specify only set one of the two. setCompactionFilter(AbstractCompactionFilter) takes precedence over setCompactionFilterFactory(AbstractCompactionFilterFactory) if the client specifies both. If multithreaded compaction is being used, the supplied CompactionFilter instance may be used from different threads concurrently and so should be thread-safe.
    
    Parameters:
    compactionFilter - AbstractCompactionFilter instance.
    
    Returns:
    the instance of the current object.
  - compactionFilter
```
AbstractCompactionFilter<? extends AbstractSlice<?>> compactionFilter()
```
    Accessor for the CompactionFilter instance in use.
    
    Returns:
    Reference to the CompactionFilter, or null if one hasn't been set.
  - setCompactionFilterFactory
```
T setCompactionFilterFactory(AbstractCompactionFilterFactory<? extends AbstractCompactionFilter<?>> compactionFilterFactory)
```
    This is a factory that provides AbstractCompactionFilter objects which allow an application to modify/delete a key-value during background compaction. A new filter will be created on each compaction run. If multithreaded compaction is being used, each created CompactionFilter will only be used from a single thread and so does not need to be thread-safe.
    
    Parameters:
    compactionFilterFactory - AbstractCompactionFilterFactory instance.
    
    Returns:
    the instance of the current object.
  - compactionFilterFactory
```
AbstractCompactionFilterFactory<? extends AbstractCompactionFilter<?>> compactionFilterFactory()
```
    Accessor for the CompactionFilterFactory instance in use.
    
    Returns:
    Reference to the CompactionFilterFactory, or null if one hasn't been set.
  - useFixedLengthPrefixExtractor
```
T useFixedLengthPrefixExtractor(int n)
```
    This prefix-extractor uses the first n bytes of a key as its prefix. In some hash-based memtable representation such as HashLinkedList and HashSkipList, prefixes are used to partition the keys into several buckets. Prefix extractor is used to specify how to extract the prefix given a key.
    
    Parameters:
    n - use the first n bytes of a key as its prefix.
    
    Returns:
    the reference to the current option.
  - useCappedPrefixExtractor
```
T useCappedPrefixExtractor(int n)
```
    Same as fixed length prefix extractor, except that when slice is shorter than the fixed length, it will use the full key.
    
    Parameters:
    n - use the first n bytes of a key as its prefix.
    
    Returns:
    the reference to the current option.
  - setLevelZeroFileNumCompactionTrigger
```
T setLevelZeroFileNumCompactionTrigger(int numFiles)
```
    Number of files to trigger level-0 compaction. A value < 0 means that level-0 compaction will not be triggered by number of files at all. Default: 4
    
    Parameters:
    numFiles - the number of files in level-0 to trigger compaction.
    
    Returns:
    the reference to the current option.
  - levelZeroFileNumCompactionTrigger
```
int levelZeroFileNumCompactionTrigger()
```
    The number of files in level 0 to trigger compaction from level-0 to level-1. A value < 0 means that level-0 compaction will not be triggered by number of files at all. Default: 4
    
    Returns:
    the number of files in level 0 to trigger compaction.
  - setLevelZeroSlowdownWritesTrigger
```
T setLevelZeroSlowdownWritesTrigger(int numFiles)
```
    Soft limit on number of level-0 files. We start slowing down writes at this point. A value < 0 means that no writing slow down will be triggered by number of files in level-0.
    
    Parameters:
    numFiles - soft limit on number of level-0 files.
    
    Returns:
    the reference to the current option.
  - levelZeroSlowdownWritesTrigger
```
int levelZeroSlowdownWritesTrigger()
```
    Soft limit on the number of level-0 files. We start slowing down writes at this point. A value < 0 means that no writing slow down will be triggered by number of files in level-0.
    
    Returns:
    the soft limit on the number of level-0 files.
  - setLevelZeroStopWritesTrigger
```
T setLevelZeroStopWritesTrigger(int numFiles)
```
    Maximum number of level-0 files. We stop writes at this point.
    
    Parameters:
    numFiles - the hard limit of the number of level-0 files.
    
    Returns:
    the reference to the current option.
  - levelZeroStopWritesTrigger
```
int levelZeroStopWritesTrigger()
```
    Maximum number of level-0 files. We stop writes at this point.
    
    Returns:
    the hard limit of the number of level-0 file.
  - setMaxBytesForLevelMultiplier
```
T setMaxBytesForLevelMultiplier(double multiplier)
```
    The ratio between the total size of level-(L+1) files and the total size of level-L files for all L. DEFAULT: 10
    
    Parameters:
    multiplier - the ratio between the total size of level-(L+1) files and the total size of level-L files for all L.
    
    Returns:
    the reference to the current option.
  - maxBytesForLevelMultiplier
```
double maxBytesForLevelMultiplier()
```
    The ratio between the total size of level-(L+1) files and the total size of level-L files for all L. DEFAULT: 10
    
    Returns:
    the ratio between the total size of level-(L+1) files and the total size of level-L files for all L.
  - setMaxTableFilesSizeFIFO
```
T setMaxTableFilesSizeFIFO(long maxTableFilesSize)
```
    FIFO compaction option. The oldest table file will be deleted once the sum of table files reaches this size. The default value is 1GB (1 * 1024 * 1024 * 1024).
    
    Parameters:
    maxTableFilesSize - the size limit of the total sum of table files.
    
    Returns:
    the instance of the current object.
  - maxTableFilesSizeFIFO
```
long maxTableFilesSizeFIFO()
```
    FIFO compaction option. The oldest table file will be deleted once the sum of table files reaches this size. The default value is 1GB (1 * 1024 * 1024 * 1024).
    
    Returns:
    the size limit of the total sum of table files.
  - memTableConfig
```
MemTableConfig memTableConfig()
```
    Get the config for mem-table.
    
    Returns:
    the mem-table config.
  - setMemTableConfig
```
T setMemTableConfig(MemTableConfig memTableConfig)
```
    Set the config for mem-table.
    
    Parameters:
    memTableConfig - the mem-table config.
    
    Returns:
    the instance of the current object.
    
    Throws:
    
    java.lang.IllegalArgumentException - thrown on 32-Bit platforms while overflowing the underlying platform specific value.
  - memTableFactoryName
```
java.lang.String memTableFactoryName()
```
    Returns the name of the current mem table representation. Memtable format can be set using setTableFormatConfig.
    
    Returns:
    the name of the currently-used memtable factory.
    See Also:
    setTableFormatConfig(org.rocksdb.TableFormatConfig)
  - tableFormatConfig
```
TableFormatConfig tableFormatConfig()
```
    Get the config for table format.
    
    Returns:
    the table format config.
  - setTableFormatConfig
```
T setTableFormatConfig(TableFormatConfig config)
```
    Set the config for table format.
    
    Parameters:
    config - the table format config.
    
    Returns:
    the reference of the current options.
  - tableFactoryName
```
java.lang.String tableFactoryName()
```
    Returns:
    the name of the currently used table factory.
  - setCfPaths
```
T setCfPaths(java.util.Collection<DbPath> paths)
```
    A list of paths where SST files for this column family can be put into, with its target size. Similar to db_paths, newer data is placed into paths specified earlier in the vector while older data gradually moves to paths specified later in the vector. Note that, if a path is supplied to multiple column families, it would have files and total size from all the column families combined. User should provision for the total size(from all the column families) in such cases. If left empty, db_paths will be used. Default: empty
    
    Parameters:
    paths - collection of paths for SST files.
    
    Returns:
    the reference of the current options.
  - cfPaths
```
java.util.List<DbPath> cfPaths()
```
    Returns:
    collection of paths for SST files.
  - setBottommostCompressionType
```
T setBottommostCompressionType(CompressionType bottommostCompressionType)
```
    Compression algorithm that will be used for the bottommost level that contain files. If level-compaction is used, this option will only affect levels after base level. Default: CompressionType.DISABLE_COMPRESSION_OPTION
    
    Parameters:
    bottommostCompressionType - The compression type to use for the bottommost level
    
    Returns:
    the reference of the current options.
  - bottommostCompressionType
```
CompressionType bottommostCompressionType()
```
    Compression algorithm that will be used for the bottommost level that contain files. If level-compaction is used, this option will only affect levels after base level. Default: CompressionType.DISABLE_COMPRESSION_OPTION
    
    Returns:
    The compression type used for the bottommost level
  - setBottommostCompressionOptions
```
T setBottommostCompressionOptions(CompressionOptions compressionOptions)
```
    Set the options for compression algorithms used by bottommostCompressionType() if it is enabled. To enable it, please see the definition of CompressionOptions.
    
    Parameters:
    compressionOptions - the bottom most compression options.
    
    Returns:
    the reference of the current options.
  - bottommostCompressionOptions
```
CompressionOptions bottommostCompressionOptions()
```
    Get the bottom most compression options. See setBottommostCompressionOptions(CompressionOptions).
    
    Returns:
    the bottom most compression options.
  - setCompressionOptions
```
T setCompressionOptions(CompressionOptions compressionOptions)
```
    Set the different options for compression algorithms
    
    Parameters:
    compressionOptions - The compression options
    
    Returns:
    the reference of the current options.
  - compressionOptions
```
CompressionOptions compressionOptions()
```
    Get the different options for compression algorithms
    
    Returns:
    The compression options
  - setSstPartitionerFactory
```
@Experimental(value="Caution: this option is experimental")
T setSstPartitionerFactory(SstPartitionerFactory factory)
```
    If non-nullptr, use the specified factory for a function to determine the partitioning of sst files. This helps compaction to split the files on interesting boundaries (key prefixes) to make propagation of sst files less write amplifying (covering the whole key space). Default: nullptr
    
    Parameters:
    factory - The factory reference
    
    Returns:
    the reference of the current options.
  - sstPartitionerFactory
```
@Experimental(value="Caution: this option is experimental")
SstPartitionerFactory sstPartitionerFactory()
```
    Get SST partitioner factory
    
    Returns:
    SST partitioner factory
  - setCompactionThreadLimiter
```
T setCompactionThreadLimiter(ConcurrentTaskLimiter concurrentTaskLimiter)
```
    Compaction concurrent thread limiter for the column family. If non-nullptr, use given concurrent thread limiter to control the max outstanding compaction tasks. Limiter can be shared with multiple column families across db instances.
    
    Parameters:
    concurrentTaskLimiter - The compaction thread limiter.
    
    Returns:
    the reference of the current options.
  - compactionThreadLimiter
```
ConcurrentTaskLimiter compactionThreadLimiter()
```
    Get compaction thread limiter
    
    Returns:
    Compaction thread limiter

Interface ColumnFamilyOptionsInterface<T extends ColumnFamilyOptionsInterface<T>>

Field Summary

Method Summary

Methods inherited from interface org.rocksdb.AdvancedColumnFamilyOptionsInterface

Field Detail

DEFAULT_COMPACTION_MEMTABLE_MEMORY_BUDGET

Method Detail

oldDefaults

optimizeForSmallDb

optimizeForSmallDb

optimizeForPointLookup

optimizeLevelStyleCompaction

optimizeLevelStyleCompaction

optimizeUniversalStyleCompaction

optimizeUniversalStyleCompaction

setComparator

setComparator

setMergeOperatorName

setMergeOperator

setCompactionFilter

compactionFilter

setCompactionFilterFactory

compactionFilterFactory

useFixedLengthPrefixExtractor

useCappedPrefixExtractor

setLevelZeroFileNumCompactionTrigger

levelZeroFileNumCompactionTrigger

setLevelZeroSlowdownWritesTrigger

levelZeroSlowdownWritesTrigger

setLevelZeroStopWritesTrigger

levelZeroStopWritesTrigger

setMaxBytesForLevelMultiplier

maxBytesForLevelMultiplier

setMaxTableFilesSizeFIFO

maxTableFilesSizeFIFO

memTableConfig

setMemTableConfig

memTableFactoryName

tableFormatConfig

setTableFormatConfig

tableFactoryName

setCfPaths

cfPaths

setBottommostCompressionType

bottommostCompressionType

setBottommostCompressionOptions

bottommostCompressionOptions

setCompressionOptions

compressionOptions

setSstPartitionerFactory

sstPartitionerFactory

setCompactionThreadLimiter

compactionThreadLimiter