Package org.rocksdb

Class Options

    • Constructor Detail

      • Options

        public Options()
        Construct options for opening a RocksDB. This constructor will create (by allocating a block of memory) an rocksdb::Options in the c++ side.
      • Options

        public Options​(Options other)
        Copy constructor for ColumnFamilyOptions. NOTE: This does a shallow copy, which means comparator, merge_operator and other pointers will be cloned!
        Parameters:
        other - The Options to copy.
    • Method Detail

      • getOptionStringFromProps

        public static java.lang.String getOptionStringFromProps​(java.util.Properties properties)
        Converts the input properties into a Options-style formatted string
        Parameters:
        properties - The set of properties to convert
        Returns:
        The Options-style representation of those properties.
      • setIncreaseParallelism

        public Options setIncreaseParallelism​(int totalThreads)
        Description copied from interface: DBOptionsInterface

        By default, RocksDB uses only one background thread for flush and compaction. Calling this function will set it up such that total of `total_threads` is used.

        You almost definitely want to call this function if your system is bottlenecked by RocksDB.

        Specified by:
        setIncreaseParallelism in interface DBOptionsInterface<Options>
        Parameters:
        totalThreads - The total number of threads to be used by RocksDB. A good value is the number of cores.
        Returns:
        the instance of the current Options
      • setCreateMissingColumnFamilies

        public Options setCreateMissingColumnFamilies​(boolean flag)
        Description copied from interface: DBOptionsInterface

        If true, missing column families will be automatically created

        Default: false

        Specified by:
        setCreateMissingColumnFamilies in interface DBOptionsInterface<Options>
        Parameters:
        flag - a flag indicating if missing column families shall be created automatically.
        Returns:
        true if missing column families shall be created automatically on open.
      • prepareForBulkLoad

        public Options prepareForBulkLoad()

        Set appropriate parameters for bulk loading. The reason that this is a function that returns "this" instead of a constructor is to enable chaining of multiple similar calls in the future.

        All data will be in level 0 without any automatic compaction. It's recommended to manually call CompactRange(NULL, NULL) before reading from the database, because otherwise the read can be very slow.

        Returns:
        the instance of the current Options.
      • optimizeForSmallDb

        public Options optimizeForSmallDb​(Cache cache)
        Description copied from interface: ColumnFamilyOptionsInterface
        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
        Specified by:
        optimizeForSmallDb in interface ColumnFamilyOptionsInterface<Options>
        Returns:
        the instance of the current object.
      • optimizeForPointLookup

        public Options optimizeForPointLookup​(long blockCacheSizeMb)
        Description copied from interface: ColumnFamilyOptionsInterface
        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
        Specified by:
        optimizeForPointLookup in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        blockCacheSizeMb - Block cache size in MB
        Returns:
        the instance of the current object.
      • optimizeLevelStyleCompaction

        public Options optimizeLevelStyleCompaction()
        Description copied from interface: ColumnFamilyOptionsInterface

        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

        Specified by:
        optimizeLevelStyleCompaction in interface ColumnFamilyOptionsInterface<Options>
        Returns:
        the instance of the current object.
      • optimizeLevelStyleCompaction

        public Options optimizeLevelStyleCompaction​(long memtableMemoryBudget)
        Description copied from interface: ColumnFamilyOptionsInterface

        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

        Specified by:
        optimizeLevelStyleCompaction in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        memtableMemoryBudget - memory budget in bytes
        Returns:
        the instance of the current object.
      • optimizeUniversalStyleCompaction

        public Options optimizeUniversalStyleCompaction()
        Description copied from interface: ColumnFamilyOptionsInterface

        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

        Specified by:
        optimizeUniversalStyleCompaction in interface ColumnFamilyOptionsInterface<Options>
        Returns:
        the instance of the current object.
      • optimizeUniversalStyleCompaction

        public Options optimizeUniversalStyleCompaction​(long memtableMemoryBudget)
        Description copied from interface: ColumnFamilyOptionsInterface

        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

        Specified by:
        optimizeUniversalStyleCompaction in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        memtableMemoryBudget - memory budget in bytes
        Returns:
        the instance of the current object.
      • setComparator

        public Options setComparator​(AbstractComparator comparator)
        Description copied from interface: ColumnFamilyOptionsInterface
        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.
        Specified by:
        setComparator in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        comparator - java instance.
        Returns:
        the instance of the current object.
      • setMergeOperatorName

        public Options setMergeOperatorName​(java.lang.String name)
        Description copied from interface: ColumnFamilyOptionsInterface

        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.

        Specified by:
        setMergeOperatorName in interface ColumnFamilyOptionsInterface<Options>
        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

        public Options setMergeOperator​(MergeOperator mergeOperator)
        Description copied from interface: ColumnFamilyOptionsInterface

        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.

        Specified by:
        setMergeOperator in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        mergeOperator - MergeOperator instance.
        Returns:
        the instance of the current object.
      • setWriteBufferSize

        public Options setWriteBufferSize​(long writeBufferSize)
        Description copied from interface: MutableColumnFamilyOptionsInterface
        Amount of data to build up in memory (backed by an unsorted log on disk) before converting to a sorted on-disk file. Larger values increase performance, especially during bulk loads. Up to max_write_buffer_number write buffers may be held in memory at the same time, so you may wish to adjust this parameter to control memory usage. Also, a larger write buffer will result in a longer recovery time the next time the database is opened. Default: 64MB
        Specified by:
        setWriteBufferSize in interface MutableColumnFamilyOptionsInterface<Options>
        Parameters:
        writeBufferSize - the size of write buffer.
        Returns:
        the instance of the current object.
      • errorIfExists

        public boolean errorIfExists()
        Description copied from interface: DBOptionsInterface
        If true, an error will be thrown during RocksDB.open() if the database already exists.
        Specified by:
        errorIfExists in interface DBOptionsInterface<Options>
        Returns:
        if true, an error is raised when the specified database already exists before open.
      • paranoidChecks

        public boolean paranoidChecks()
        Description copied from interface: DBOptionsInterface
        If true, the implementation will do aggressive checking of the data it is processing and will stop early if it detects any errors. This may have unforeseen ramifications: for example, a corruption of one DB entry may cause a large number of entries to become unreadable or for the entire DB to become unopenable. If any of the writes to the database fails (Put, Delete, Merge, Write), the database will switch to read-only mode and fail all other Write operations.
        Specified by:
        paranoidChecks in interface DBOptionsInterface<Options>
        Returns:
        a boolean indicating whether paranoid-check is on.
      • setParanoidChecks

        public Options setParanoidChecks​(boolean paranoidChecks)
        Description copied from interface: DBOptionsInterface
        If true, the implementation will do aggressive checking of the data it is processing and will stop early if it detects any errors. This may have unforeseen ramifications: for example, a corruption of one DB entry may cause a large number of entries to become unreadable or for the entire DB to become unopenable. If any of the writes to the database fails (Put, Delete, Merge, Write), the database will switch to read-only mode and fail all other Write operations. Default: true
        Specified by:
        setParanoidChecks in interface DBOptionsInterface<Options>
        Parameters:
        paranoidChecks - a flag to indicate whether paranoid-check is on.
        Returns:
        the reference to the current option.
      • maxOpenFiles

        public int maxOpenFiles()
        Description copied from interface: MutableDBOptionsInterface
        Number of open files that can be used by the DB. You may need to increase this if your database has a large working set. Value -1 means files opened are always kept open. You can estimate number of files based on target_file_size_base and target_file_size_multiplier for level-based compaction. For universal-style compaction, you can usually set it to -1. Default: -1
        Specified by:
        maxOpenFiles in interface MutableDBOptionsInterface<Options>
        Returns:
        the maximum number of open files.
      • setMaxTotalWalSize

        public Options setMaxTotalWalSize​(long maxTotalWalSize)
        Description copied from interface: MutableDBOptionsInterface

        Once write-ahead logs exceed this size, we will start forcing the flush of column families whose memtables are backed by the oldest live WAL file (i.e. the ones that are causing all the space amplification).

        If set to 0 (default), we will dynamically choose the WAL size limit to be [sum of all write_buffer_size * max_write_buffer_number] * 2

        This option takes effect only when there are more than one column family as otherwise the wal size is dictated by the write_buffer_size.

        Default: 0

        Specified by:
        setMaxTotalWalSize in interface MutableDBOptionsInterface<Options>
        Parameters:
        maxTotalWalSize - max total wal size.
        Returns:
        the instance of the current object.
      • maxTotalWalSize

        public long maxTotalWalSize()
        Description copied from interface: MutableDBOptionsInterface

        Returns the max total wal size. Once write-ahead logs exceed this size, we will start forcing the flush of column families whose memtables are backed by the oldest live WAL file (i.e. the ones that are causing all the space amplification).

        If set to 0 (default), we will dynamically choose the WAL size limit to be [sum of all write_buffer_size * max_write_buffer_number] * 2

        Specified by:
        maxTotalWalSize in interface MutableDBOptionsInterface<Options>
        Returns:
        max total wal size
      • setMaxOpenFiles

        public Options setMaxOpenFiles​(int maxOpenFiles)
        Description copied from interface: MutableDBOptionsInterface
        Number of open files that can be used by the DB. You may need to increase this if your database has a large working set. Value -1 means files opened are always kept open. You can estimate number of files based on target_file_size_base and target_file_size_multiplier for level-based compaction. For universal-style compaction, you can usually set it to -1. Default: -1
        Specified by:
        setMaxOpenFiles in interface MutableDBOptionsInterface<Options>
        Parameters:
        maxOpenFiles - the maximum number of open files.
        Returns:
        the instance of the current object.
      • useFsync

        public boolean useFsync()
        Description copied from interface: DBOptionsInterface

        If true, then every store to stable storage will issue a fsync.

        If false, then every store to stable storage will issue a fdatasync. This parameter should be set to true while storing data to filesystem like ext3 that can lose files after a reboot.

        Specified by:
        useFsync in interface DBOptionsInterface<Options>
        Returns:
        boolean value indicating if fsync is used.
      • setUseFsync

        public Options setUseFsync​(boolean useFsync)
        Description copied from interface: DBOptionsInterface

        If true, then every store to stable storage will issue a fsync.

        If false, then every store to stable storage will issue a fdatasync. This parameter should be set to true while storing data to filesystem like ext3 that can lose files after a reboot.

        Default: false

        Specified by:
        setUseFsync in interface DBOptionsInterface<Options>
        Parameters:
        useFsync - a boolean flag to specify whether to use fsync
        Returns:
        the instance of the current object.
      • setDbPaths

        public Options setDbPaths​(java.util.Collection<DbPath> dbPaths)
        Description copied from interface: DBOptionsInterface
        A list of paths where SST files can be put into, with its target size. Newer data is placed into paths specified earlier in the vector while older data gradually moves to paths specified later in the vector. For example, you have a flash device with 10GB allocated for the DB, as well as a hard drive of 2TB, you should config it to be: [{"/flash_path", 10GB}, {"/hard_drive", 2TB}] The system will try to guarantee data under each path is close to but not larger than the target size. But current and future file sizes used by determining where to place a file are based on best-effort estimation, which means there is a chance that the actual size under the directory is slightly more than target size under some workloads. User should give some buffer room for those cases. If none of the paths has sufficient room to place a file, the file will be placed to the last path anyway, despite to the target size. Placing newer data to earlier paths is also best-efforts. User should expect user files to be placed in higher levels in some extreme cases. If left empty, only one path will be used, which is db_name passed when opening the DB. Default: empty
        Specified by:
        setDbPaths in interface DBOptionsInterface<Options>
        Parameters:
        dbPaths - the paths and target sizes
        Returns:
        the reference to the current options
      • dbPaths

        public java.util.List<DbPath> dbPaths()
        Description copied from interface: DBOptionsInterface
        A list of paths where SST files can be put into, with its target size. Newer data is placed into paths specified earlier in the vector while older data gradually moves to paths specified later in the vector. For example, you have a flash device with 10GB allocated for the DB, as well as a hard drive of 2TB, you should config it to be: [{"/flash_path", 10GB}, {"/hard_drive", 2TB}] The system will try to guarantee data under each path is close to but not larger than the target size. But current and future file sizes used by determining where to place a file are based on best-effort estimation, which means there is a chance that the actual size under the directory is slightly more than target size under some workloads. User should give some buffer room for those cases. If none of the paths has sufficient room to place a file, the file will be placed to the last path anyway, despite to the target size. Placing newer data to earlier paths is also best-efforts. User should expect user files to be placed in higher levels in some extreme cases. If left empty, only one path will be used, which is db_name passed when opening the DB. Default: Collections.emptyList()
        Specified by:
        dbPaths in interface DBOptionsInterface<Options>
        Returns:
        dbPaths the paths and target sizes
      • dbLogDir

        public java.lang.String dbLogDir()
        Description copied from interface: DBOptionsInterface
        Returns the directory of info log. If it is empty, the log files will be in the same dir as data. If it is non empty, the log files will be in the specified dir, and the db data dir's absolute path will be used as the log file name's prefix.
        Specified by:
        dbLogDir in interface DBOptionsInterface<Options>
        Returns:
        the path to the info log directory
      • setDbLogDir

        public Options setDbLogDir​(java.lang.String dbLogDir)
        Description copied from interface: DBOptionsInterface
        This specifies the info LOG dir. If it is empty, the log files will be in the same dir as data. If it is non empty, the log files will be in the specified dir, and the db data dir's absolute path will be used as the log file name's prefix.
        Specified by:
        setDbLogDir in interface DBOptionsInterface<Options>
        Parameters:
        dbLogDir - the path to the info log directory
        Returns:
        the instance of the current object.
      • walDir

        public java.lang.String walDir()
        Description copied from interface: DBOptionsInterface
        Returns the path to the write-ahead-logs (WAL) directory. If it is empty, the log files will be in the same dir as data, dbname is used as the data dir by default If it is non empty, the log files will be in kept the specified dir. When destroying the db, all log files in wal_dir and the dir itself is deleted
        Specified by:
        walDir in interface DBOptionsInterface<Options>
        Returns:
        the path to the write-ahead-logs (WAL) directory.
      • setWalDir

        public Options setWalDir​(java.lang.String walDir)
        Description copied from interface: DBOptionsInterface
        This specifies the absolute dir path for write-ahead logs (WAL). If it is empty, the log files will be in the same dir as data, dbname is used as the data dir by default If it is non empty, the log files will be in kept the specified dir. When destroying the db, all log files in wal_dir and the dir itself is deleted
        Specified by:
        setWalDir in interface DBOptionsInterface<Options>
        Parameters:
        walDir - the path to the write-ahead-log directory.
        Returns:
        the instance of the current object.
      • maxBackgroundCompactions

        @Deprecated
        public int maxBackgroundCompactions()
        Deprecated.
        Description copied from interface: MutableDBOptionsInterface
        NOT SUPPORTED ANYMORE: RocksDB automatically decides this based on the value of max_background_jobs. For backwards compatibility we will set `max_background_jobs = max_background_compactions + max_background_flushes` in the case where user sets at least one of `max_background_compactions` or `max_background_flushes` (we replace -1 by 1 in case one option is unset). Returns the maximum number of concurrent background compaction jobs, submitted to the default LOW priority thread pool. When increasing this number, we may also want to consider increasing number of threads in LOW priority thread pool. Default: -1
        Specified by:
        maxBackgroundCompactions in interface MutableDBOptionsInterface<Options>
        Returns:
        the maximum number of concurrent background compaction jobs.
        See Also:
        Env.setBackgroundThreads(int), Env.setBackgroundThreads(int, Priority)
      • setBaseBackgroundCompactions

        @Deprecated
        public void setBaseBackgroundCompactions​(int baseBackgroundCompactions)
        Deprecated.
        Description copied from interface: MutableDBOptionsInterface
        NOT SUPPORTED ANYMORE: RocksDB automatically decides this based on the value of max_background_jobs. This option is ignored. Suggested number of concurrent background compaction jobs, submitted to the default LOW priority thread pool. Default: -1
        Specified by:
        setBaseBackgroundCompactions in interface MutableDBOptionsInterface<Options>
        Parameters:
        baseBackgroundCompactions - Suggested number of background compaction jobs
      • baseBackgroundCompactions

        public int baseBackgroundCompactions()
        Description copied from interface: MutableDBOptionsInterface
        NOT SUPPORTED ANYMORE: RocksDB automatically decides this based on the value of max_background_jobs. This option is ignored. Suggested number of concurrent background compaction jobs, submitted to the default LOW priority thread pool. Default: -1
        Specified by:
        baseBackgroundCompactions in interface MutableDBOptionsInterface<Options>
        Returns:
        Suggested number of background compaction jobs
      • setMaxBackgroundCompactions

        @Deprecated
        public Options setMaxBackgroundCompactions​(int maxBackgroundCompactions)
        Deprecated.
        Description copied from interface: MutableDBOptionsInterface
        NOT SUPPORTED ANYMORE: RocksDB automatically decides this based on the value of max_background_jobs. For backwards compatibility we will set `max_background_jobs = max_background_compactions + max_background_flushes` in the case where user sets at least one of `max_background_compactions` or `max_background_flushes` (we replace -1 by 1 in case one option is unset). Specifies the maximum number of concurrent background compaction jobs, submitted to the default LOW priority thread pool. If you're increasing this, also consider increasing number of threads in LOW priority thread pool. For more information, see Default: -1
        Specified by:
        setMaxBackgroundCompactions in interface MutableDBOptionsInterface<Options>
        Parameters:
        maxBackgroundCompactions - the maximum number of background compaction jobs.
        Returns:
        the instance of the current object.
        See Also:
        Env.setBackgroundThreads(int), Env.setBackgroundThreads(int, Priority), DBOptionsInterface.maxBackgroundFlushes()
      • setMaxSubcompactions

        public Options setMaxSubcompactions​(int maxSubcompactions)
        Description copied from interface: DBOptionsInterface
        This value represents the maximum number of threads that will concurrently perform a compaction job by breaking it into multiple, smaller ones that are run simultaneously. Default: 1 (i.e. no subcompactions)
        Specified by:
        setMaxSubcompactions in interface DBOptionsInterface<Options>
        Parameters:
        maxSubcompactions - The maximum number of threads that will concurrently perform a compaction job
        Returns:
        the instance of the current object.
      • maxSubcompactions

        public int maxSubcompactions()
        Description copied from interface: DBOptionsInterface
        This value represents the maximum number of threads that will concurrently perform a compaction job by breaking it into multiple, smaller ones that are run simultaneously. Default: 1 (i.e. no subcompactions)
        Specified by:
        maxSubcompactions in interface DBOptionsInterface<Options>
        Returns:
        The maximum number of threads that will concurrently perform a compaction job
      • maxBackgroundFlushes

        @Deprecated
        public int maxBackgroundFlushes()
        Deprecated.
        Description copied from interface: DBOptionsInterface
        NOT SUPPORTED ANYMORE: RocksDB automatically decides this based on the value of max_background_jobs. For backwards compatibility we will set `max_background_jobs = max_background_compactions + max_background_flushes` in the case where user sets at least one of `max_background_compactions` or `max_background_flushes`. Returns the maximum number of concurrent background flush jobs. If you're increasing this, also consider increasing number of threads in HIGH priority thread pool. For more information, see Default: -1
        Specified by:
        maxBackgroundFlushes in interface DBOptionsInterface<Options>
        Returns:
        the maximum number of concurrent background flush jobs.
        See Also:
        Env.setBackgroundThreads(int), Env.setBackgroundThreads(int, Priority)
      • setMaxBackgroundFlushes

        @Deprecated
        public Options setMaxBackgroundFlushes​(int maxBackgroundFlushes)
        Deprecated.
        Description copied from interface: DBOptionsInterface
        NOT SUPPORTED ANYMORE: RocksDB automatically decides this based on the value of max_background_jobs. For backwards compatibility we will set `max_background_jobs = max_background_compactions + max_background_flushes` in the case where user sets at least one of `max_background_compactions` or `max_background_flushes`. Specifies the maximum number of concurrent background flush jobs. If you're increasing this, also consider increasing number of threads in HIGH priority thread pool. For more information, see Default: -1
        Specified by:
        setMaxBackgroundFlushes in interface DBOptionsInterface<Options>
        Parameters:
        maxBackgroundFlushes - number of max concurrent flush jobs
        Returns:
        the instance of the current object.
        See Also:
        Env.setBackgroundThreads(int), Env.setBackgroundThreads(int, Priority), MutableDBOptionsInterface.maxBackgroundCompactions()
      • setMaxBackgroundJobs

        public Options setMaxBackgroundJobs​(int maxBackgroundJobs)
        Description copied from interface: MutableDBOptionsInterface
        Specifies the maximum number of concurrent background jobs (both flushes and compactions combined). Default: 2
        Specified by:
        setMaxBackgroundJobs in interface MutableDBOptionsInterface<Options>
        Parameters:
        maxBackgroundJobs - number of max concurrent background jobs
        Returns:
        the instance of the current object.
      • maxLogFileSize

        public long maxLogFileSize()
        Description copied from interface: DBOptionsInterface
        Returns the maximum size of a info log file. If the current log file is larger than this size, a new info log file will be created. If 0, all logs will be written to one log file.
        Specified by:
        maxLogFileSize in interface DBOptionsInterface<Options>
        Returns:
        the maximum size of the info log file.
      • setMaxLogFileSize

        public Options setMaxLogFileSize​(long maxLogFileSize)
        Description copied from interface: DBOptionsInterface
        Specifies the maximum size of a info log file. If the current log file is larger than `max_log_file_size`, a new info log file will be created. If 0, all logs will be written to one log file.
        Specified by:
        setMaxLogFileSize in interface DBOptionsInterface<Options>
        Parameters:
        maxLogFileSize - the maximum size of a info log file.
        Returns:
        the instance of the current object.
      • logFileTimeToRoll

        public long logFileTimeToRoll()
        Description copied from interface: DBOptionsInterface
        Returns the time interval for the info log file to roll (in seconds). If specified with non-zero value, log file will be rolled if it has been active longer than `log_file_time_to_roll`. Default: 0 (disabled)
        Specified by:
        logFileTimeToRoll in interface DBOptionsInterface<Options>
        Returns:
        the time interval in seconds.
      • setLogFileTimeToRoll

        public Options setLogFileTimeToRoll​(long logFileTimeToRoll)
        Description copied from interface: DBOptionsInterface
        Specifies the time interval for the info log file to roll (in seconds). If specified with non-zero value, log file will be rolled if it has been active longer than `log_file_time_to_roll`. Default: 0 (disabled)
        Specified by:
        setLogFileTimeToRoll in interface DBOptionsInterface<Options>
        Parameters:
        logFileTimeToRoll - the time interval in seconds.
        Returns:
        the instance of the current object.
      • keepLogFileNum

        public long keepLogFileNum()
        Description copied from interface: DBOptionsInterface
        Returns the maximum number of info log files to be kept. Default: 1000
        Specified by:
        keepLogFileNum in interface DBOptionsInterface<Options>
        Returns:
        the maximum number of info log files to be kept.
      • setKeepLogFileNum

        public Options setKeepLogFileNum​(long keepLogFileNum)
        Description copied from interface: DBOptionsInterface
        Specifies the maximum number of info log files to be kept. Default: 1000
        Specified by:
        setKeepLogFileNum in interface DBOptionsInterface<Options>
        Parameters:
        keepLogFileNum - the maximum number of info log files to be kept.
        Returns:
        the instance of the current object.
      • setRecycleLogFileNum

        public Options setRecycleLogFileNum​(long recycleLogFileNum)
        Description copied from interface: DBOptionsInterface
        Recycle log files. If non-zero, we will reuse previously written log files for new logs, overwriting the old data. The value indicates how many such files we will keep around at any point in time for later use. This is more efficient because the blocks are already allocated and fdatasync does not need to update the inode after each write. Default: 0
        Specified by:
        setRecycleLogFileNum in interface DBOptionsInterface<Options>
        Parameters:
        recycleLogFileNum - the number of log files to keep for recycling
        Returns:
        the reference to the current options
      • recycleLogFileNum

        public long recycleLogFileNum()
        Description copied from interface: DBOptionsInterface
        Recycle log files. If non-zero, we will reuse previously written log files for new logs, overwriting the old data. The value indicates how many such files we will keep around at any point in time for later use. This is more efficient because the blocks are already allocated and fdatasync does not need to update the inode after each write. Default: 0
        Specified by:
        recycleLogFileNum in interface DBOptionsInterface<Options>
        Returns:
        the number of log files kept for recycling
      • maxManifestFileSize

        public long maxManifestFileSize()
        Description copied from interface: DBOptionsInterface
        Manifest file is rolled over on reaching this limit. The older manifest file be deleted. The default value is 1GB so that the manifest file can grow, but not reach the limit of storage capacity.
        Specified by:
        maxManifestFileSize in interface DBOptionsInterface<Options>
        Returns:
        the size limit of a manifest file.
      • setMaxManifestFileSize

        public Options setMaxManifestFileSize​(long maxManifestFileSize)
        Description copied from interface: DBOptionsInterface
        Manifest file is rolled over on reaching this limit. The older manifest file be deleted. The default value is 1GB so that the manifest file can grow, but not reach the limit of storage capacity.
        Specified by:
        setMaxManifestFileSize in interface DBOptionsInterface<Options>
        Parameters:
        maxManifestFileSize - the size limit of a manifest file.
        Returns:
        the instance of the current object.
      • setMaxTableFilesSizeFIFO

        public Options setMaxTableFilesSizeFIFO​(long maxTableFilesSize)
        Description copied from interface: ColumnFamilyOptionsInterface
        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).
        Specified by:
        setMaxTableFilesSizeFIFO in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        maxTableFilesSize - the size limit of the total sum of table files.
        Returns:
        the instance of the current object.
      • maxTableFilesSizeFIFO

        public long maxTableFilesSizeFIFO()
        Description copied from interface: ColumnFamilyOptionsInterface
        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).
        Specified by:
        maxTableFilesSizeFIFO in interface ColumnFamilyOptionsInterface<Options>
        Returns:
        the size limit of the total sum of table files.
      • setTableCacheNumshardbits

        public Options setTableCacheNumshardbits​(int tableCacheNumshardbits)
        Description copied from interface: DBOptionsInterface
        Number of shards used for table cache.
        Specified by:
        setTableCacheNumshardbits in interface DBOptionsInterface<Options>
        Parameters:
        tableCacheNumshardbits - the number of chards
        Returns:
        the instance of the current object.
      • walTtlSeconds

        public long walTtlSeconds()
        Description copied from interface: DBOptionsInterface
        WalTtlSeconds() and walSizeLimitMB() affect how archived logs will be deleted.
        1. If both set to 0, logs will be deleted asap and will not get into the archive.
        2. If WAL_ttl_seconds is 0 and WAL_size_limit_MB is not 0, WAL files will be checked every 10 min and if total size is greater then WAL_size_limit_MB, they will be deleted starting with the earliest until size_limit is met. All empty files will be deleted.
        3. If WAL_ttl_seconds is not 0 and WAL_size_limit_MB is 0, then WAL files will be checked every WAL_ttl_seconds / 2 and those that are older than WAL_ttl_seconds will be deleted.
        4. If both are not 0, WAL files will be checked every 10 min and both checks will be performed with ttl being first.
        Specified by:
        walTtlSeconds in interface DBOptionsInterface<Options>
        Returns:
        the wal-ttl seconds
        See Also:
        DBOptionsInterface.walSizeLimitMB()
      • setWalTtlSeconds

        public Options setWalTtlSeconds​(long walTtlSeconds)
        Description copied from interface: DBOptionsInterface
        DBOptionsInterface.walTtlSeconds() and DBOptionsInterface.walSizeLimitMB() affect how archived logs will be deleted.
        1. If both set to 0, logs will be deleted asap and will not get into the archive.
        2. If WAL_ttl_seconds is 0 and WAL_size_limit_MB is not 0, WAL files will be checked every 10 min and if total size is greater then WAL_size_limit_MB, they will be deleted starting with the earliest until size_limit is met. All empty files will be deleted.
        3. If WAL_ttl_seconds is not 0 and WAL_size_limit_MB is 0, then WAL files will be checked every WAL_ttl_seconds / 2 and those that are older than WAL_ttl_seconds will be deleted.
        4. If both are not 0, WAL files will be checked every 10 min and both checks will be performed with ttl being first.
        Specified by:
        setWalTtlSeconds in interface DBOptionsInterface<Options>
        Parameters:
        walTtlSeconds - the ttl seconds
        Returns:
        the instance of the current object.
        See Also:
        DBOptionsInterface.setWalSizeLimitMB(long)
      • walSizeLimitMB

        public long walSizeLimitMB()
        Description copied from interface: DBOptionsInterface
        DBOptionsInterface.walTtlSeconds() and #walSizeLimitMB() affect how archived logs will be deleted.
        1. If both set to 0, logs will be deleted asap and will not get into the archive.
        2. If WAL_ttl_seconds is 0 and WAL_size_limit_MB is not 0, WAL files will be checked every 10 min and if total size is greater then WAL_size_limit_MB, they will be deleted starting with the earliest until size_limit is met. All empty files will be deleted.
        3. If WAL_ttl_seconds is not 0 and WAL_size_limit_MB is 0, then WAL files will be checked every WAL_ttl_seconds i / 2 and those that are older than WAL_ttl_seconds will be deleted.
        4. If both are not 0, WAL files will be checked every 10 min and both checks will be performed with ttl being first.
        Specified by:
        walSizeLimitMB in interface DBOptionsInterface<Options>
        Returns:
        size limit in mega-bytes.
        See Also:
        DBOptionsInterface.walSizeLimitMB()
      • setMaxWriteBatchGroupSizeBytes

        public Options setMaxWriteBatchGroupSizeBytes​(long maxWriteBatchGroupSizeBytes)
        Description copied from interface: DBOptionsInterface
        The maximum limit of number of bytes that are written in a single batch of WAL or memtable write. It is followed when the leader write size is larger than 1/8 of this limit. Default: 1 MB
        Specified by:
        setMaxWriteBatchGroupSizeBytes in interface DBOptionsInterface<Options>
        Parameters:
        maxWriteBatchGroupSizeBytes - the maximum limit of number of bytes, see description.
        Returns:
        the instance of the current object.
      • maxWriteBatchGroupSizeBytes

        public long maxWriteBatchGroupSizeBytes()
        Description copied from interface: DBOptionsInterface
        The maximum limit of number of bytes that are written in a single batch of WAL or memtable write. It is followed when the leader write size is larger than 1/8 of this limit. Default: 1 MB
        Specified by:
        maxWriteBatchGroupSizeBytes in interface DBOptionsInterface<Options>
        Returns:
        the maximum limit of number of bytes, see description.
      • setWalSizeLimitMB

        public Options setWalSizeLimitMB​(long sizeLimitMB)
        Description copied from interface: DBOptionsInterface
        WalTtlSeconds() and walSizeLimitMB() affect how archived logs will be deleted.
        1. If both set to 0, logs will be deleted asap and will not get into the archive.
        2. If WAL_ttl_seconds is 0 and WAL_size_limit_MB is not 0, WAL files will be checked every 10 min and if total size is greater then WAL_size_limit_MB, they will be deleted starting with the earliest until size_limit is met. All empty files will be deleted.
        3. If WAL_ttl_seconds is not 0 and WAL_size_limit_MB is 0, then WAL files will be checked every WAL_ttl_secondsi / 2 and those that are older than WAL_ttl_seconds will be deleted.
        4. If both are not 0, WAL files will be checked every 10 min and both checks will be performed with ttl being first.
        Specified by:
        setWalSizeLimitMB in interface DBOptionsInterface<Options>
        Parameters:
        sizeLimitMB - size limit in mega-bytes.
        Returns:
        the instance of the current object.
        See Also:
        DBOptionsInterface.setWalSizeLimitMB(long)
      • manifestPreallocationSize

        public long manifestPreallocationSize()
        Description copied from interface: DBOptionsInterface
        Number of bytes to preallocate (via fallocate) the manifest files. Default is 4mb, which is reasonable to reduce random IO as well as prevent overallocation for mounts that preallocate large amounts of data (such as xfs's allocsize option).
        Specified by:
        manifestPreallocationSize in interface DBOptionsInterface<Options>
        Returns:
        size in bytes.
      • setManifestPreallocationSize

        public Options setManifestPreallocationSize​(long size)
        Description copied from interface: DBOptionsInterface
        Number of bytes to preallocate (via fallocate) the manifest files. Default is 4mb, which is reasonable to reduce random IO as well as prevent overallocation for mounts that preallocate large amounts of data (such as xfs's allocsize option).
        Specified by:
        setManifestPreallocationSize in interface DBOptionsInterface<Options>
        Parameters:
        size - the size in byte
        Returns:
        the instance of the current object.
      • setUseDirectReads

        public Options setUseDirectReads​(boolean useDirectReads)
        Description copied from interface: DBOptionsInterface
        Enable the OS to use direct I/O for reading sst tables. Default: false
        Specified by:
        setUseDirectReads in interface DBOptionsInterface<Options>
        Parameters:
        useDirectReads - if true, then direct read is enabled
        Returns:
        the instance of the current object.
      • useDirectReads

        public boolean useDirectReads()
        Description copied from interface: DBOptionsInterface
        Enable the OS to use direct I/O for reading sst tables. Default: false
        Specified by:
        useDirectReads in interface DBOptionsInterface<Options>
        Returns:
        if true, then direct reads are enabled
      • setUseDirectIoForFlushAndCompaction

        public Options setUseDirectIoForFlushAndCompaction​(boolean useDirectIoForFlushAndCompaction)
        Description copied from interface: DBOptionsInterface
        Enable the OS to use direct reads and writes in flush and compaction Default: false
        Specified by:
        setUseDirectIoForFlushAndCompaction in interface DBOptionsInterface<Options>
        Parameters:
        useDirectIoForFlushAndCompaction - if true, then direct I/O will be enabled for background flush and compactions
        Returns:
        the instance of the current object.
      • setAllowFAllocate

        public Options setAllowFAllocate​(boolean allowFAllocate)
        Description copied from interface: DBOptionsInterface
        Whether fallocate calls are allowed
        Specified by:
        setAllowFAllocate in interface DBOptionsInterface<Options>
        Parameters:
        allowFAllocate - false if fallocate() calls are bypassed
        Returns:
        the reference to the current options.
      • setAllowMmapReads

        public Options setAllowMmapReads​(boolean allowMmapReads)
        Description copied from interface: DBOptionsInterface
        Allow the OS to mmap file for reading sst tables. Default: false
        Specified by:
        setAllowMmapReads in interface DBOptionsInterface<Options>
        Parameters:
        allowMmapReads - true if mmap reads are allowed.
        Returns:
        the instance of the current object.
      • setAllowMmapWrites

        public Options setAllowMmapWrites​(boolean allowMmapWrites)
        Description copied from interface: DBOptionsInterface
        Allow the OS to mmap file for writing. Default: false
        Specified by:
        setAllowMmapWrites in interface DBOptionsInterface<Options>
        Parameters:
        allowMmapWrites - true if mmap writes are allowd.
        Returns:
        the instance of the current object.
      • isFdCloseOnExec

        public boolean isFdCloseOnExec()
        Description copied from interface: DBOptionsInterface
        Disable child process inherit open files. Default: true
        Specified by:
        isFdCloseOnExec in interface DBOptionsInterface<Options>
        Returns:
        true if child process inheriting open files is disabled.
      • setIsFdCloseOnExec

        public Options setIsFdCloseOnExec​(boolean isFdCloseOnExec)
        Description copied from interface: DBOptionsInterface
        Disable child process inherit open files. Default: true
        Specified by:
        setIsFdCloseOnExec in interface DBOptionsInterface<Options>
        Parameters:
        isFdCloseOnExec - true if child process inheriting open files is disabled.
        Returns:
        the instance of the current object.
      • setStatsDumpPeriodSec

        public Options setStatsDumpPeriodSec​(int statsDumpPeriodSec)
        Description copied from interface: MutableDBOptionsInterface
        if not zero, dump rocksdb.stats to LOG every stats_dump_period_sec Default: 600 (10 minutes)
        Specified by:
        setStatsDumpPeriodSec in interface MutableDBOptionsInterface<Options>
        Parameters:
        statsDumpPeriodSec - time interval in seconds.
        Returns:
        the instance of the current object.
      • setStatsPersistPeriodSec

        public Options setStatsPersistPeriodSec​(int statsPersistPeriodSec)
        Description copied from interface: MutableDBOptionsInterface
        If not zero, dump rocksdb.stats to RocksDB every statsPersistPeriodSec Default: 600
        Specified by:
        setStatsPersistPeriodSec in interface MutableDBOptionsInterface<Options>
        Parameters:
        statsPersistPeriodSec - time interval in seconds.
        Returns:
        the instance of the current object.
      • setStatsHistoryBufferSize

        public Options setStatsHistoryBufferSize​(long statsHistoryBufferSize)
        Description copied from interface: MutableDBOptionsInterface
        If not zero, periodically take stats snapshots and store in memory, the memory size for stats snapshots is capped at statsHistoryBufferSize Default: 1MB
        Specified by:
        setStatsHistoryBufferSize in interface MutableDBOptionsInterface<Options>
        Parameters:
        statsHistoryBufferSize - the size of the buffer.
        Returns:
        the instance of the current object.
      • adviseRandomOnOpen

        public boolean adviseRandomOnOpen()
        Description copied from interface: DBOptionsInterface
        If set true, will hint the underlying file system that the file access pattern is random, when a sst file is opened. Default: true
        Specified by:
        adviseRandomOnOpen in interface DBOptionsInterface<Options>
        Returns:
        true if hinting random access is on.
      • setAdviseRandomOnOpen

        public Options setAdviseRandomOnOpen​(boolean adviseRandomOnOpen)
        Description copied from interface: DBOptionsInterface
        If set true, will hint the underlying file system that the file access pattern is random, when a sst file is opened. Default: true
        Specified by:
        setAdviseRandomOnOpen in interface DBOptionsInterface<Options>
        Parameters:
        adviseRandomOnOpen - true if hinting random access is on.
        Returns:
        the instance of the current object.
      • setDbWriteBufferSize

        public Options setDbWriteBufferSize​(long dbWriteBufferSize)
        Description copied from interface: DBOptionsInterface
        Amount of data to build up in memtables across all column families before writing to disk. This is distinct from ColumnFamilyOptions.writeBufferSize(), which enforces a limit for a single memtable. This feature is disabled by default. Specify a non-zero value to enable it. Default: 0 (disabled)
        Specified by:
        setDbWriteBufferSize in interface DBOptionsInterface<Options>
        Parameters:
        dbWriteBufferSize - the size of the write buffer
        Returns:
        the reference to the current options.
      • dbWriteBufferSize

        public long dbWriteBufferSize()
        Description copied from interface: DBOptionsInterface
        Amount of data to build up in memtables across all column families before writing to disk. This is distinct from ColumnFamilyOptions.writeBufferSize(), which enforces a limit for a single memtable. This feature is disabled by default. Specify a non-zero value to enable it. Default: 0 (disabled)
        Specified by:
        dbWriteBufferSize in interface DBOptionsInterface<Options>
        Returns:
        the size of the write buffer
      • setNewTableReaderForCompactionInputs

        public Options setNewTableReaderForCompactionInputs​(boolean newTableReaderForCompactionInputs)
        Description copied from interface: DBOptionsInterface
        If true, always create a new file descriptor and new table reader for compaction inputs. Turn this parameter on may introduce extra memory usage in the table reader, if it allocates extra memory for indexes. This will allow file descriptor prefetch options to be set for compaction input files and not to impact file descriptors for the same file used by user queries. Suggest to enable BlockBasedTableConfig.cacheIndexAndFilterBlocks() for this mode if using block-based table. Default: false
        Specified by:
        setNewTableReaderForCompactionInputs in interface DBOptionsInterface<Options>
        Parameters:
        newTableReaderForCompactionInputs - true if a new file descriptor and table reader should be created for compaction inputs
        Returns:
        the reference to the current options.
      • newTableReaderForCompactionInputs

        public boolean newTableReaderForCompactionInputs()
        Description copied from interface: DBOptionsInterface
        If true, always create a new file descriptor and new table reader for compaction inputs. Turn this parameter on may introduce extra memory usage in the table reader, if it allocates extra memory for indexes. This will allow file descriptor prefetch options to be set for compaction input files and not to impact file descriptors for the same file used by user queries. Suggest to enable BlockBasedTableConfig.cacheIndexAndFilterBlocks() for this mode if using block-based table. Default: false
        Specified by:
        newTableReaderForCompactionInputs in interface DBOptionsInterface<Options>
        Returns:
        true if a new file descriptor and table reader are created for compaction inputs
      • setRandomAccessMaxBufferSize

        public Options setRandomAccessMaxBufferSize​(long randomAccessMaxBufferSize)
        Description copied from interface: DBOptionsInterface
        This is a maximum buffer size that is used by WinMmapReadableFile in unbuffered disk I/O mode. We need to maintain an aligned buffer for reads. We allow the buffer to grow until the specified value and then for bigger requests allocate one shot buffers. In unbuffered mode we always bypass read-ahead buffer at ReadaheadRandomAccessFile When read-ahead is required we then make use of MutableDBOptionsInterface.compactionReadaheadSize() value and always try to read ahead. With read-ahead we always pre-allocate buffer to the size instead of growing it up to a limit. This option is currently honored only on Windows Default: 1 Mb Special value: 0 - means do not maintain per instance buffer. Allocate per request buffer and avoid locking.
        Specified by:
        setRandomAccessMaxBufferSize in interface DBOptionsInterface<Options>
        Parameters:
        randomAccessMaxBufferSize - the maximum size of the random access buffer
        Returns:
        the reference to the current options.
      • randomAccessMaxBufferSize

        public long randomAccessMaxBufferSize()
        Description copied from interface: DBOptionsInterface
        This is a maximum buffer size that is used by WinMmapReadableFile in unbuffered disk I/O mode. We need to maintain an aligned buffer for reads. We allow the buffer to grow until the specified value and then for bigger requests allocate one shot buffers. In unbuffered mode we always bypass read-ahead buffer at ReadaheadRandomAccessFile When read-ahead is required we then make use of MutableDBOptionsInterface.compactionReadaheadSize() value and always try to read ahead. With read-ahead we always pre-allocate buffer to the size instead of growing it up to a limit. This option is currently honored only on Windows Default: 1 Mb Special value: 0 - means do not maintain per instance buffer. Allocate per request buffer and avoid locking.
        Specified by:
        randomAccessMaxBufferSize in interface DBOptionsInterface<Options>
        Returns:
        the maximum size of the random access buffer
      • setWritableFileMaxBufferSize

        public Options setWritableFileMaxBufferSize​(long writableFileMaxBufferSize)
        Description copied from interface: MutableDBOptionsInterface
        This is the maximum buffer size that is used by WritableFileWriter. On Windows, we need to maintain an aligned buffer for writes. We allow the buffer to grow until it's size hits the limit. Default: 1024 * 1024 (1 MB)
        Specified by:
        setWritableFileMaxBufferSize in interface MutableDBOptionsInterface<Options>
        Parameters:
        writableFileMaxBufferSize - the maximum buffer size
        Returns:
        the reference to the current options.
      • writableFileMaxBufferSize

        public long writableFileMaxBufferSize()
        Description copied from interface: MutableDBOptionsInterface
        This is the maximum buffer size that is used by WritableFileWriter. On Windows, we need to maintain an aligned buffer for writes. We allow the buffer to grow until it's size hits the limit. Default: 1024 * 1024 (1 MB)
        Specified by:
        writableFileMaxBufferSize in interface MutableDBOptionsInterface<Options>
        Returns:
        the maximum buffer size
      • useAdaptiveMutex

        public boolean useAdaptiveMutex()
        Description copied from interface: DBOptionsInterface
        Use adaptive mutex, which spins in the user space before resorting to kernel. This could reduce context switch when the mutex is not heavily contended. However, if the mutex is hot, we could end up wasting spin time. Default: false
        Specified by:
        useAdaptiveMutex in interface DBOptionsInterface<Options>
        Returns:
        true if adaptive mutex is used.
      • setUseAdaptiveMutex

        public Options setUseAdaptiveMutex​(boolean useAdaptiveMutex)
        Description copied from interface: DBOptionsInterface
        Use adaptive mutex, which spins in the user space before resorting to kernel. This could reduce context switch when the mutex is not heavily contended. However, if the mutex is hot, we could end up wasting spin time. Default: false
        Specified by:
        setUseAdaptiveMutex in interface DBOptionsInterface<Options>
        Parameters:
        useAdaptiveMutex - true if adaptive mutex is used.
        Returns:
        the instance of the current object.
      • bytesPerSync

        public long bytesPerSync()
        Description copied from interface: MutableDBOptionsInterface
        Allows OS to incrementally sync files to disk while they are being written, asynchronously, in the background. Issue one request for every bytes_per_sync written. 0 turns it off. Default: 0
        Specified by:
        bytesPerSync in interface MutableDBOptionsInterface<Options>
        Returns:
        size in bytes
      • setBytesPerSync

        public Options setBytesPerSync​(long bytesPerSync)
        Description copied from interface: MutableDBOptionsInterface
        Allows OS to incrementally sync files to disk while they are being written, asynchronously, in the background. Issue one request for every bytes_per_sync written. 0 turns it off. Default: 0
        Specified by:
        setBytesPerSync in interface MutableDBOptionsInterface<Options>
        Parameters:
        bytesPerSync - size in bytes
        Returns:
        the instance of the current object.
      • setStrictBytesPerSync

        public Options setStrictBytesPerSync​(boolean strictBytesPerSync)
        Description copied from interface: MutableDBOptionsInterface
        When true, guarantees WAL files have at most MutableDBOptionsInterface.walBytesPerSync() bytes submitted for writeback at any given time, and SST files have at most MutableDBOptionsInterface.bytesPerSync() bytes pending writeback at any given time. This can be used to handle cases where processing speed exceeds I/O speed during file generation, which can lead to a huge sync when the file is finished, even with MutableDBOptionsInterface.bytesPerSync() / MutableDBOptionsInterface.walBytesPerSync() properly configured. - If `sync_file_range` is supported it achieves this by waiting for any prior `sync_file_range`s to finish before proceeding. In this way, processing (compression, etc.) can proceed uninhibited in the gap between `sync_file_range`s, and we block only when I/O falls behind. - Otherwise the `WritableFile::Sync` method is used. Note this mechanism always blocks, thus preventing the interleaving of I/O and processing. Note: Enabling this option does not provide any additional persistence guarantees, as it may use `sync_file_range`, which does not write out metadata. Default: false
        Specified by:
        setStrictBytesPerSync in interface MutableDBOptionsInterface<Options>
        Parameters:
        strictBytesPerSync - the bytes per sync
        Returns:
        the instance of the current object.
      • setListeners

        public Options setListeners​(java.util.List<AbstractEventListener> listeners)
        Description copied from interface: DBOptionsInterface
        Sets the EventListeners whose callback functions will be called when specific RocksDB event happens. Note: the RocksJava API currently only supports EventListeners implemented in Java. It could be extended in future to also support adding/removing EventListeners implemented in C++.
        Specified by:
        setListeners in interface DBOptionsInterface<Options>
        Parameters:
        listeners - the listeners who should be notified on various events.
        Returns:
        the instance of the current object.
      • listeners

        public java.util.List<AbstractEventListener> listeners()
        Description copied from interface: DBOptionsInterface
        Sets the EventListeners whose callback functions will be called when specific RocksDB event happens. Note: the RocksJava API currently only supports EventListeners implemented in Java. It could be extended in future to also support adding/removing EventListeners implemented in C++.
        Specified by:
        listeners in interface DBOptionsInterface<Options>
        Returns:
        the instance of the current object.
      • setEnableThreadTracking

        public Options setEnableThreadTracking​(boolean enableThreadTracking)
        Description copied from interface: DBOptionsInterface
        If true, then the status of the threads involved in this DB will be tracked and available via GetThreadList() API. Default: false
        Specified by:
        setEnableThreadTracking in interface DBOptionsInterface<Options>
        Parameters:
        enableThreadTracking - true to enable tracking
        Returns:
        the reference to the current options.
      • enableThreadTracking

        public boolean enableThreadTracking()
        Description copied from interface: DBOptionsInterface
        If true, then the status of the threads involved in this DB will be tracked and available via GetThreadList() API. Default: false
        Specified by:
        enableThreadTracking in interface DBOptionsInterface<Options>
        Returns:
        true if tracking is enabled
      • setEnablePipelinedWrite

        public Options setEnablePipelinedWrite​(boolean enablePipelinedWrite)
        Description copied from interface: DBOptionsInterface
        By default, a single write thread queue is maintained. The thread gets to the head of the queue becomes write batch group leader and responsible for writing to WAL and memtable for the batch group. If DBOptionsInterface.enablePipelinedWrite() is true, separate write thread queue is maintained for WAL write and memtable write. A write thread first enter WAL writer queue and then memtable writer queue. Pending thread on the WAL writer queue thus only have to wait for previous writers to finish their WAL writing but not the memtable writing. Enabling the feature may improve write throughput and reduce latency of the prepare phase of two-phase commit. Default: false
        Specified by:
        setEnablePipelinedWrite in interface DBOptionsInterface<Options>
        Parameters:
        enablePipelinedWrite - true to enabled pipelined writes
        Returns:
        the reference to the current options.
      • setUnorderedWrite

        public Options setUnorderedWrite​(boolean unorderedWrite)
        Description copied from interface: DBOptionsInterface
        Setting DBOptionsInterface.unorderedWrite() to true trades higher write throughput with relaxing the immutability guarantee of snapshots. This violates the repeatability one expects from ::Get from a snapshot, as well as ::MultiGet and Iterator's consistent-point-in-time view property. If the application cannot tolerate the relaxed guarantees, it can implement its own mechanisms to work around that and yet benefit from the higher throughput. Using TransactionDB with WRITE_PREPARED write policy and DBOptionsInterface.twoWriteQueues() true is one way to achieve immutable snapshots despite unordered_write. By default, i.e., when it is false, rocksdb does not advance the sequence number for new snapshots unless all the writes with lower sequence numbers are already finished. This provides the immutability that we except from snapshots. Moreover, since Iterator and MultiGet internally depend on snapshots, the snapshot immutability results into Iterator and MultiGet offering consistent-point-in-time view. If set to true, although Read-Your-Own-Write property is still provided, the snapshot immutability property is relaxed: the writes issued after the snapshot is obtained (with larger sequence numbers) will be still not visible to the reads from that snapshot, however, there still might be pending writes (with lower sequence number) that will change the state visible to the snapshot after they are landed to the memtable.
        Specified by:
        setUnorderedWrite in interface DBOptionsInterface<Options>
        Parameters:
        unorderedWrite - true to enabled unordered write
        Returns:
        the reference to the current options.
      • setAllowConcurrentMemtableWrite

        public Options setAllowConcurrentMemtableWrite​(boolean allowConcurrentMemtableWrite)
        Description copied from interface: DBOptionsInterface
        If true, allow multi-writers to update mem tables in parallel. Only some memtable factorys support concurrent writes; currently it is implemented only for SkipListFactory. Concurrent memtable writes are not compatible with inplace_update_support or filter_deletes. It is strongly recommended to set DBOptionsInterface.setEnableWriteThreadAdaptiveYield(boolean) if you are going to use this feature. Default: true
        Specified by:
        setAllowConcurrentMemtableWrite in interface DBOptionsInterface<Options>
        Parameters:
        allowConcurrentMemtableWrite - true to enable concurrent writes for the memtable
        Returns:
        the reference to the current options.
      • allowConcurrentMemtableWrite

        public boolean allowConcurrentMemtableWrite()
        Description copied from interface: DBOptionsInterface
        If true, allow multi-writers to update mem tables in parallel. Only some memtable factorys support concurrent writes; currently it is implemented only for SkipListFactory. Concurrent memtable writes are not compatible with inplace_update_support or filter_deletes. It is strongly recommended to set DBOptionsInterface.setEnableWriteThreadAdaptiveYield(boolean) if you are going to use this feature. Default: true
        Specified by:
        allowConcurrentMemtableWrite in interface DBOptionsInterface<Options>
        Returns:
        true if concurrent writes are enabled for the memtable
      • setWriteThreadMaxYieldUsec

        public Options setWriteThreadMaxYieldUsec​(long writeThreadMaxYieldUsec)
        Description copied from interface: DBOptionsInterface
        The maximum number of microseconds that a write operation will use a yielding spin loop to coordinate with other write threads before blocking on a mutex. (Assuming DBOptionsInterface.writeThreadSlowYieldUsec() is set properly) increasing this value is likely to increase RocksDB throughput at the expense of increased CPU usage. Default: 100
        Specified by:
        setWriteThreadMaxYieldUsec in interface DBOptionsInterface<Options>
        Parameters:
        writeThreadMaxYieldUsec - maximum number of microseconds
        Returns:
        the reference to the current options.
      • writeThreadMaxYieldUsec

        public long writeThreadMaxYieldUsec()
        Description copied from interface: DBOptionsInterface
        The maximum number of microseconds that a write operation will use a yielding spin loop to coordinate with other write threads before blocking on a mutex. (Assuming DBOptionsInterface.writeThreadSlowYieldUsec() is set properly) increasing this value is likely to increase RocksDB throughput at the expense of increased CPU usage. Default: 100
        Specified by:
        writeThreadMaxYieldUsec in interface DBOptionsInterface<Options>
        Returns:
        the maximum number of microseconds
      • setWriteThreadSlowYieldUsec

        public Options setWriteThreadSlowYieldUsec​(long writeThreadSlowYieldUsec)
        Description copied from interface: DBOptionsInterface
        The latency in microseconds after which a std::this_thread::yield call (sched_yield on Linux) is considered to be a signal that other processes or threads would like to use the current core. Increasing this makes writer threads more likely to take CPU by spinning, which will show up as an increase in the number of involuntary context switches. Default: 3
        Specified by:
        setWriteThreadSlowYieldUsec in interface DBOptionsInterface<Options>
        Parameters:
        writeThreadSlowYieldUsec - the latency in microseconds
        Returns:
        the reference to the current options.
      • writeThreadSlowYieldUsec

        public long writeThreadSlowYieldUsec()
        Description copied from interface: DBOptionsInterface
        The latency in microseconds after which a std::this_thread::yield call (sched_yield on Linux) is considered to be a signal that other processes or threads would like to use the current core. Increasing this makes writer threads more likely to take CPU by spinning, which will show up as an increase in the number of involuntary context switches. Default: 3
        Specified by:
        writeThreadSlowYieldUsec in interface DBOptionsInterface<Options>
        Returns:
        writeThreadSlowYieldUsec the latency in microseconds
      • setSkipStatsUpdateOnDbOpen

        public Options setSkipStatsUpdateOnDbOpen​(boolean skipStatsUpdateOnDbOpen)
        Description copied from interface: DBOptionsInterface
        If true, then DB::Open() will not update the statistics used to optimize compaction decision by loading table properties from many files. Turning off this feature will improve DBOpen time especially in disk environment. Default: false
        Specified by:
        setSkipStatsUpdateOnDbOpen in interface DBOptionsInterface<Options>
        Parameters:
        skipStatsUpdateOnDbOpen - true if updating stats will be skipped
        Returns:
        the reference to the current options.
      • skipStatsUpdateOnDbOpen

        public boolean skipStatsUpdateOnDbOpen()
        Description copied from interface: DBOptionsInterface
        If true, then DB::Open() will not update the statistics used to optimize compaction decision by loading table properties from many files. Turning off this feature will improve DBOpen time especially in disk environment. Default: false
        Specified by:
        skipStatsUpdateOnDbOpen in interface DBOptionsInterface<Options>
        Returns:
        true if updating stats will be skipped
      • setSkipCheckingSstFileSizesOnDbOpen

        public Options setSkipCheckingSstFileSizesOnDbOpen​(boolean skipCheckingSstFileSizesOnDbOpen)
        Description copied from interface: DBOptionsInterface
        If true, then RocksDB.open(String) will not fetch and check sizes of all sst files. This may significantly speed up startup if there are many sst files, especially when using non-default Env with expensive GetFileSize(). We'll still check that all required sst files exist. If paranoid_checks is false, this option is ignored, and sst files are not checked at all. Default: false
        Specified by:
        setSkipCheckingSstFileSizesOnDbOpen in interface DBOptionsInterface<Options>
        Parameters:
        skipCheckingSstFileSizesOnDbOpen - if true, then SST file sizes will not be checked when calling RocksDB.open(String).
        Returns:
        the reference to the current options.
      • skipCheckingSstFileSizesOnDbOpen

        public boolean skipCheckingSstFileSizesOnDbOpen()
        Description copied from interface: DBOptionsInterface
        If true, then RocksDB.open(String) will not fetch and check sizes of all sst files. This may significantly speed up startup if there are many sst files, especially when using non-default Env with expensive GetFileSize(). We'll still check that all required sst files exist. If paranoid_checks is false, this option is ignored, and sst files are not checked at all. Default: false
        Specified by:
        skipCheckingSstFileSizesOnDbOpen in interface DBOptionsInterface<Options>
        Returns:
        true, if file sizes will not be checked when calling RocksDB.open(String).
      • setAllow2pc

        public Options setAllow2pc​(boolean allow2pc)
        Description copied from interface: DBOptionsInterface
        if set to false then recovery will fail when a prepared transaction is encountered in the WAL Default: false
        Specified by:
        setAllow2pc in interface DBOptionsInterface<Options>
        Parameters:
        allow2pc - true if two-phase-commit is enabled
        Returns:
        the reference to the current options.
      • allow2pc

        public boolean allow2pc()
        Description copied from interface: DBOptionsInterface
        if set to false then recovery will fail when a prepared transaction is encountered in the WAL Default: false
        Specified by:
        allow2pc in interface DBOptionsInterface<Options>
        Returns:
        true if two-phase-commit is enabled
      • setRowCache

        public Options setRowCache​(Cache rowCache)
        Description copied from interface: DBOptionsInterface
        A global cache for table-level rows. Default: null (disabled)
        Specified by:
        setRowCache in interface DBOptionsInterface<Options>
        Parameters:
        rowCache - The global row cache
        Returns:
        the reference to the current options.
      • setWalFilter

        public Options setWalFilter​(AbstractWalFilter walFilter)
        Description copied from interface: DBOptionsInterface
        A filter object supplied to be invoked while processing write-ahead-logs (WALs) during recovery. The filter provides a way to inspect log records, ignoring a particular record or skipping replay. The filter is invoked at startup and is invoked from a single-thread currently.
        Specified by:
        setWalFilter in interface DBOptionsInterface<Options>
        Parameters:
        walFilter - the filter for processing WALs during recovery.
        Returns:
        the reference to the current options.
      • setFailIfOptionsFileError

        public Options setFailIfOptionsFileError​(boolean failIfOptionsFileError)
        Description copied from interface: DBOptionsInterface
        If true, then DB::Open / CreateColumnFamily / DropColumnFamily / SetOptions will fail if options file is not detected or properly persisted. DEFAULT: false
        Specified by:
        setFailIfOptionsFileError in interface DBOptionsInterface<Options>
        Parameters:
        failIfOptionsFileError - true if we should fail if there is an error in the options file
        Returns:
        the reference to the current options.
      • failIfOptionsFileError

        public boolean failIfOptionsFileError()
        Description copied from interface: DBOptionsInterface
        If true, then DB::Open / CreateColumnFamily / DropColumnFamily / SetOptions will fail if options file is not detected or properly persisted. DEFAULT: false
        Specified by:
        failIfOptionsFileError in interface DBOptionsInterface<Options>
        Returns:
        true if we should fail if there is an error in the options file
      • setDumpMallocStats

        public Options setDumpMallocStats​(boolean dumpMallocStats)
        Description copied from interface: DBOptionsInterface
        If true, then print malloc stats together with rocksdb.stats when printing to LOG. DEFAULT: false
        Specified by:
        setDumpMallocStats in interface DBOptionsInterface<Options>
        Parameters:
        dumpMallocStats - true if malloc stats should be printed to LOG
        Returns:
        the reference to the current options.
      • dumpMallocStats

        public boolean dumpMallocStats()
        Description copied from interface: DBOptionsInterface
        If true, then print malloc stats together with rocksdb.stats when printing to LOG. DEFAULT: false
        Specified by:
        dumpMallocStats in interface DBOptionsInterface<Options>
        Returns:
        true if malloc stats should be printed to LOG
      • setAvoidFlushDuringRecovery

        public Options setAvoidFlushDuringRecovery​(boolean avoidFlushDuringRecovery)
        Description copied from interface: DBOptionsInterface
        By default RocksDB replay WAL logs and flush them on DB open, which may create very small SST files. If this option is enabled, RocksDB will try to avoid (but not guarantee not to) flush during recovery. Also, existing WAL logs will be kept, so that if crash happened before flush, we still have logs to recover from. DEFAULT: false
        Specified by:
        setAvoidFlushDuringRecovery in interface DBOptionsInterface<Options>
        Parameters:
        avoidFlushDuringRecovery - true to try to avoid (but not guarantee not to) flush during recovery
        Returns:
        the reference to the current options.
      • avoidFlushDuringRecovery

        public boolean avoidFlushDuringRecovery()
        Description copied from interface: DBOptionsInterface
        By default RocksDB replay WAL logs and flush them on DB open, which may create very small SST files. If this option is enabled, RocksDB will try to avoid (but not guarantee not to) flush during recovery. Also, existing WAL logs will be kept, so that if crash happened before flush, we still have logs to recover from. DEFAULT: false
        Specified by:
        avoidFlushDuringRecovery in interface DBOptionsInterface<Options>
        Returns:
        true to try to avoid (but not guarantee not to) flush during recovery
      • setAllowIngestBehind

        public Options setAllowIngestBehind​(boolean allowIngestBehind)
        Description copied from interface: DBOptionsInterface
        Set this option to true during creation of database if you want to be able to ingest behind (call IngestExternalFile() skipping keys that already exist, rather than overwriting matching keys). Setting this option to true will affect 2 things: 1) Disable some internal optimizations around SST file compression 2) Reserve bottom-most level for ingested files only. 3) Note that num_levels should be >= 3 if this option is turned on. DEFAULT: false
        Specified by:
        setAllowIngestBehind in interface DBOptionsInterface<Options>
        Parameters:
        allowIngestBehind - true to allow ingest behind, false to disallow.
        Returns:
        the reference to the current options.
      • setPreserveDeletes

        public Options setPreserveDeletes​(boolean preserveDeletes)
        Description copied from interface: DBOptionsInterface
        Needed to support differential snapshots. If set to true then DB will only process deletes with sequence number less than what was set by SetPreserveDeletesSequenceNumber(uint64_t ts). Clients are responsible to periodically call this method to advance the cutoff time. If this method is never called and preserve_deletes is set to true NO deletes will ever be processed. At the moment this only keeps normal deletes, SingleDeletes will not be preserved. DEFAULT: false
        Specified by:
        setPreserveDeletes in interface DBOptionsInterface<Options>
        Parameters:
        preserveDeletes - true to preserve deletes.
        Returns:
        the reference to the current options.
      • setTwoWriteQueues

        public Options setTwoWriteQueues​(boolean twoWriteQueues)
        Description copied from interface: DBOptionsInterface
        If enabled it uses two queues for writes, one for the ones with disable_memtable and one for the ones that also write to memtable. This allows the memtable writes not to lag behind other writes. It can be used to optimize MySQL 2PC in which only the commits, which are serial, write to memtable. DEFAULT: false
        Specified by:
        setTwoWriteQueues in interface DBOptionsInterface<Options>
        Parameters:
        twoWriteQueues - true to enable two write queues, false otherwise.
        Returns:
        the reference to the current options.
      • twoWriteQueues

        public boolean twoWriteQueues()
        Description copied from interface: DBOptionsInterface
        Returns true if two write queues are enabled.
        Specified by:
        twoWriteQueues in interface DBOptionsInterface<Options>
        Returns:
        true if two write queues are enabled, false otherwise.
      • setManualWalFlush

        public Options setManualWalFlush​(boolean manualWalFlush)
        Description copied from interface: DBOptionsInterface
        If true WAL is not flushed automatically after each write. Instead it relies on manual invocation of FlushWAL to write the WAL buffer to its file. DEFAULT: false
        Specified by:
        setManualWalFlush in interface DBOptionsInterface<Options>
        Parameters:
        manualWalFlush - true to set disable automatic WAL flushing, false otherwise.
        Returns:
        the reference to the current options.
      • setRateLimiter

        public Options setRateLimiter​(RateLimiter rateLimiter)
        Description copied from interface: DBOptionsInterface
        Use to control write rate of flush and compaction. Flush has higher priority than compaction. Rate limiting is disabled if nullptr. Default: nullptr
        Specified by:
        setRateLimiter in interface DBOptionsInterface<Options>
        Parameters:
        rateLimiter - RateLimiter instance.
        Returns:
        the instance of the current object.
      • setSstFileManager

        public Options setSstFileManager​(SstFileManager sstFileManager)
        Description copied from interface: DBOptionsInterface
        Use to track SST files and control their file deletion rate. Features: - Throttle the deletion rate of the SST files. - Keep track the total size of all SST files. - Set a maximum allowed space limit for SST files that when reached the DB wont do any further flushes or compactions and will set the background error. - Can be shared between multiple dbs. Limitations: - Only track and throttle deletes of SST files in first db_path (db_name if db_paths is empty).
        Specified by:
        setSstFileManager in interface DBOptionsInterface<Options>
        Parameters:
        sstFileManager - The SST File Manager for the db.
        Returns:
        the instance of the current object.
      • setLogger

        public Options setLogger​(Logger logger)
        Description copied from interface: DBOptionsInterface

        Any internal progress/error information generated by the db will be written to the Logger if it is non-nullptr, or to a file stored in the same directory as the DB contents if info_log is nullptr.

        Default: nullptr

        Specified by:
        setLogger in interface DBOptionsInterface<Options>
        Parameters:
        logger - Logger instance.
        Returns:
        the instance of the current object.
      • setCfPaths

        public Options setCfPaths​(java.util.Collection<DbPath> cfPaths)
        Description copied from interface: ColumnFamilyOptionsInterface
        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
        Specified by:
        setCfPaths in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        cfPaths - collection of paths for SST files.
        Returns:
        the reference of the current options.
      • useFixedLengthPrefixExtractor

        public Options useFixedLengthPrefixExtractor​(int n)
        Description copied from interface: ColumnFamilyOptionsInterface
        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.
        Specified by:
        useFixedLengthPrefixExtractor in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        n - use the first n bytes of a key as its prefix.
        Returns:
        the reference to the current option.
      • setCompressionPerLevel

        public Options setCompressionPerLevel​(java.util.List<CompressionType> compressionLevels)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface

        Different levels can have different compression policies. There are cases where most lower levels would like to use quick compression algorithms while the higher levels (which have more data) use compression algorithms that have better compression but could be slower. This array, if non-empty, should have an entry for each level of the database; these override the value specified in the previous field 'compression'.

        NOTICE

        If level_compaction_dynamic_level_bytes=true, compression_per_level[0] still determines L0, but other elements of the array are based on base level (the level L0 files are merged to), and may not match the level users see from info log for metadata.

        If L0 files are merged to level - n, then, for i&gt;0, compression_per_level[i] determines compaction type for level n+i-1.

        Example

        For example, if we have 5 levels, and we determine to merge L0 data to L4 (which means L1..L3 will be empty), then the new files go to L4 uses compression type compression_per_level[1].

        If now L0 is merged to L2. Data goes to L2 will be compressed according to compression_per_level[1], L3 using compression_per_level[2]and L4 using compression_per_level[3]. Compaction for each level can change when data grows.

        Default: empty

        Specified by:
        setCompressionPerLevel in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        compressionLevels - list of CompressionType instances.
        Returns:
        the reference to the current options.
      • levelZeroFileNumCompactionTrigger

        public int levelZeroFileNumCompactionTrigger()
        Description copied from interface: ColumnFamilyOptionsInterface
        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
        Specified by:
        levelZeroFileNumCompactionTrigger in interface ColumnFamilyOptionsInterface<Options>
        Returns:
        the number of files in level 0 to trigger compaction.
      • setLevelZeroFileNumCompactionTrigger

        public Options setLevelZeroFileNumCompactionTrigger​(int numFiles)
        Description copied from interface: ColumnFamilyOptionsInterface
        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
        Specified by:
        setLevelZeroFileNumCompactionTrigger in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        numFiles - the number of files in level-0 to trigger compaction.
        Returns:
        the reference to the current option.
      • levelZeroSlowdownWritesTrigger

        public int levelZeroSlowdownWritesTrigger()
        Description copied from interface: ColumnFamilyOptionsInterface
        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.
        Specified by:
        levelZeroSlowdownWritesTrigger in interface ColumnFamilyOptionsInterface<Options>
        Returns:
        the soft limit on the number of level-0 files.
      • setLevelZeroSlowdownWritesTrigger

        public Options setLevelZeroSlowdownWritesTrigger​(int numFiles)
        Description copied from interface: ColumnFamilyOptionsInterface
        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.
        Specified by:
        setLevelZeroSlowdownWritesTrigger in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        numFiles - soft limit on number of level-0 files.
        Returns:
        the reference to the current option.
      • setLevelCompactionDynamicLevelBytes

        public Options setLevelCompactionDynamicLevelBytes​(boolean enableLevelCompactionDynamicLevelBytes)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface

        If true, RocksDB will pick target size of each level dynamically. We will pick a base level b >= 1. L0 will be directly merged into level b, instead of always into level 1. Level 1 to b-1 need to be empty. We try to pick b and its target size so that

        1. target size is in the range of (max_bytes_for_level_base / max_bytes_for_level_multiplier, max_bytes_for_level_base]
        2. target size of the last level (level num_levels-1) equals to extra size of the level.

        At the same time max_bytes_for_level_multiplier and max_bytes_for_level_multiplier_additional are still satisfied.

        With this option on, from an empty DB, we make last level the base level, which means merging L0 data into the last level, until it exceeds max_bytes_for_level_base. And then we make the second last level to be base level, to start to merge L0 data to second last level, with its target size to be 1/max_bytes_for_level_multiplier of the last levels extra size. After the data accumulates more so that we need to move the base level to the third last one, and so on.

        Example

        For example, assume max_bytes_for_level_multiplier=10, num_levels=6, and max_bytes_for_level_base=10MB.

        Target sizes of level 1 to 5 starts with:

        [- - - - 10MB]

        with base level is level. Target sizes of level 1 to 4 are not applicable because they will not be used. Until the size of Level 5 grows to more than 10MB, say 11MB, we make base target to level 4 and now the targets looks like:

        [- - - 1.1MB 11MB]

        While data are accumulated, size targets are tuned based on actual data of level 5. When level 5 has 50MB of data, the target is like:

        [- - - 5MB 50MB]

        Until level 5's actual size is more than 100MB, say 101MB. Now if we keep level 4 to be the base level, its target size needs to be 10.1MB, which doesn't satisfy the target size range. So now we make level 3 the target size and the target sizes of the levels look like:

        [- - 1.01MB 10.1MB 101MB]

        In the same way, while level 5 further grows, all levels' targets grow, like

        [- - 5MB 50MB 500MB]

        Until level 5 exceeds 1000MB and becomes 1001MB, we make level 2 the base level and make levels' target sizes like this:

        [- 1.001MB 10.01MB 100.1MB 1001MB]

        and go on...

        By doing it, we give max_bytes_for_level_multiplier a priority against max_bytes_for_level_base, for a more predictable LSM tree shape. It is useful to limit worse case space amplification.

        max_bytes_for_level_multiplier_additional is ignored with this flag on.

        Turning this feature on or off for an existing DB can cause unexpected LSM tree structure so it's not recommended.

        Caution: this option is experimental

        Default: false

        Specified by:
        setLevelCompactionDynamicLevelBytes in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        enableLevelCompactionDynamicLevelBytes - boolean value indicating if LevelCompactionDynamicLevelBytes shall be enabled.
        Returns:
        the reference to the current options.
      • arenaBlockSize

        public long arenaBlockSize()
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        The size of one block in arena memory allocation. If ≤ 0, a proper value is automatically calculated (usually 1/10 of writer_buffer_size). There are two additional restriction of the specified size: (1) size should be in the range of [4096, 2 << 30] and (2) be the multiple of the CPU word (which helps with the memory alignment). We'll automatically check and adjust the size number to make sure it conforms to the restrictions. Default: 0
        Specified by:
        arenaBlockSize in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Returns:
        the size of an arena block
      • setArenaBlockSize

        public Options setArenaBlockSize​(long arenaBlockSize)
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        The size of one block in arena memory allocation. If ≤ 0, a proper value is automatically calculated (usually 1/10 of writer_buffer_size). There are two additional restriction of the specified size: (1) size should be in the range of [4096, 2 << 30] and (2) be the multiple of the CPU word (which helps with the memory alignment). We'll automatically check and adjust the size number to make sure it conforms to the restrictions. Default: 0
        Specified by:
        setArenaBlockSize in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Parameters:
        arenaBlockSize - the size of an arena block
        Returns:
        the reference to the current options.
      • setMaxSequentialSkipInIterations

        public Options setMaxSequentialSkipInIterations​(long maxSequentialSkipInIterations)
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        An iteration->Next() sequentially skips over keys with the same user-key unless this option is set. This number specifies the number of keys (with the same userkey) that will be sequentially skipped before a reseek is issued. Default: 8
        Specified by:
        setMaxSequentialSkipInIterations in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Parameters:
        maxSequentialSkipInIterations - the number of keys could be skipped in a iteration.
        Returns:
        the reference to the current options.
      • inplaceUpdateSupport

        public boolean inplaceUpdateSupport()
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        Allows thread-safe inplace updates. If inplace_callback function is not set, Put(key, new_value) will update inplace the existing_value iff * key exists in current memtable * new sizeof(new_value) ≤ sizeof(existing_value) * existing_value for that key is a put i.e. kTypeValue If inplace_callback function is set, check doc for inplace_callback. Default: false.
        Specified by:
        inplaceUpdateSupport in interface AdvancedColumnFamilyOptionsInterface<Options>
        Returns:
        true if thread-safe inplace updates are allowed.
      • setInplaceUpdateSupport

        public Options setInplaceUpdateSupport​(boolean inplaceUpdateSupport)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        Allows thread-safe inplace updates. If inplace_callback function is not set, Put(key, new_value) will update inplace the existing_value iff * key exists in current memtable * new sizeof(new_value) ≤ sizeof(existing_value) * existing_value for that key is a put i.e. kTypeValue If inplace_callback function is set, check doc for inplace_callback. Default: false.
        Specified by:
        setInplaceUpdateSupport in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        inplaceUpdateSupport - true if thread-safe inplace updates are allowed.
        Returns:
        the reference to the current options.
      • setMemtablePrefixBloomSizeRatio

        public Options setMemtablePrefixBloomSizeRatio​(double memtablePrefixBloomSizeRatio)
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        if prefix_extractor is set and memtable_prefix_bloom_size_ratio is not 0, create prefix bloom for memtable with the size of write_buffer_size * memtable_prefix_bloom_size_ratio. If it is larger than 0.25, it is santinized to 0.25. Default: 0 (disable)
        Specified by:
        setMemtablePrefixBloomSizeRatio in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Parameters:
        memtablePrefixBloomSizeRatio - The ratio
        Returns:
        the reference to the current options.
      • bloomLocality

        public int bloomLocality()
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        Control locality of bloom filter probes to improve cache miss rate. This option only applies to memtable prefix bloom and plaintable prefix bloom. It essentially limits the max number of cache lines each bloom filter check can touch. This optimization is turned off when set to 0. The number should never be greater than number of probes. This option can boost performance for in-memory workload but should use with care since it can cause higher false positive rate. Default: 0
        Specified by:
        bloomLocality in interface AdvancedColumnFamilyOptionsInterface<Options>
        Returns:
        the level of locality of bloom-filter probes.
        See Also:
        AdvancedColumnFamilyOptionsInterface.setBloomLocality(int)
      • setBloomLocality

        public Options setBloomLocality​(int bloomLocality)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        Control locality of bloom filter probes to improve cache miss rate. This option only applies to memtable prefix bloom and plaintable prefix bloom. It essentially limits the max number of cache lines each bloom filter check can touch. This optimization is turned off when set to 0. The number should never be greater than number of probes. This option can boost performance for in-memory workload but should use with care since it can cause higher false positive rate. Default: 0
        Specified by:
        setBloomLocality in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        bloomLocality - the level of locality of bloom-filter probes.
        Returns:
        the reference to the current options.
      • maxSuccessiveMerges

        public long maxSuccessiveMerges()
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        Maximum number of successive merge operations on a key in the memtable. When a merge operation is added to the memtable and the maximum number of successive merges is reached, the value of the key will be calculated and inserted into the memtable instead of the merge operation. This will ensure that there are never more than max_successive_merges merge operations in the memtable. Default: 0 (disabled)
        Specified by:
        maxSuccessiveMerges in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Returns:
        the maximum number of successive merges.
      • setMaxSuccessiveMerges

        public Options setMaxSuccessiveMerges​(long maxSuccessiveMerges)
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        Maximum number of successive merge operations on a key in the memtable. When a merge operation is added to the memtable and the maximum number of successive merges is reached, the value of the key will be calculated and inserted into the memtable instead of the merge operation. This will ensure that there are never more than max_successive_merges merge operations in the memtable. Default: 0 (disabled)
        Specified by:
        setMaxSuccessiveMerges in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Parameters:
        maxSuccessiveMerges - the maximum number of successive merges.
        Returns:
        the reference to the current options.
      • minWriteBufferNumberToMerge

        public int minWriteBufferNumberToMerge()
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        The minimum number of write buffers that will be merged together before writing to storage. If set to 1, then all write buffers are flushed to L0 as individual files and this increases read amplification because a get request has to check in all of these files. Also, an in-memory merge may result in writing lesser data to storage if there are duplicate records in each of these individual write buffers. Default: 1
        Specified by:
        minWriteBufferNumberToMerge in interface AdvancedColumnFamilyOptionsInterface<Options>
        Returns:
        the minimum number of write buffers that will be merged together.
      • setMinWriteBufferNumberToMerge

        public Options setMinWriteBufferNumberToMerge​(int minWriteBufferNumberToMerge)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        The minimum number of write buffers that will be merged together before writing to storage. If set to 1, then all write buffers are flushed to L0 as individual files and this increases read amplification because a get request has to check in all of these files. Also, an in-memory merge may result in writing lesser data to storage if there are duplicate records in each of these individual write buffers. Default: 1
        Specified by:
        setMinWriteBufferNumberToMerge in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        minWriteBufferNumberToMerge - the minimum number of write buffers that will be merged together.
        Returns:
        the reference to the current options.
      • setOptimizeFiltersForHits

        public Options setOptimizeFiltersForHits​(boolean optimizeFiltersForHits)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface

        This flag specifies that the implementation should optimize the filters mainly for cases where keys are found rather than also optimize for keys missed. This would be used in cases where the application knows that there are very few misses or the performance in the case of misses is not important.

        For now, this flag allows us to not store filters for the last level i.e the largest level which contains data of the LSM store. For keys which are hits, the filters in this level are not useful because we will search for the data anyway.

        NOTE: the filters in other levels are still useful even for key hit because they tell us whether to look in that level or go to the higher level.

        Default: false

        Specified by:
        setOptimizeFiltersForHits in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        optimizeFiltersForHits - boolean value indicating if this flag is set.
        Returns:
        the reference to the current options.
      • setMemtableHugePageSize

        public Options setMemtableHugePageSize​(long memtableHugePageSize)
        Description copied from interface: AdvancedMutableColumnFamilyOptionsInterface
        Page size for huge page TLB for bloom in memtable. If ≤ 0, not allocate from huge page TLB but from malloc. Need to reserve huge pages for it to be allocated. For example: sysctl -w vm.nr_hugepages=20 See linux doc Documentation/vm/hugetlbpage.txt
        Specified by:
        setMemtableHugePageSize in interface AdvancedMutableColumnFamilyOptionsInterface<Options>
        Parameters:
        memtableHugePageSize - The page size of the huge page tlb
        Returns:
        the reference to the current options.
      • setLevel0FileNumCompactionTrigger

        public Options setLevel0FileNumCompactionTrigger​(int level0FileNumCompactionTrigger)
        Description copied from interface: MutableColumnFamilyOptionsInterface
        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
        Specified by:
        setLevel0FileNumCompactionTrigger in interface MutableColumnFamilyOptionsInterface<Options>
        Parameters:
        level0FileNumCompactionTrigger - The number of files to trigger level-0 compaction
        Returns:
        the reference to the current option.
      • setMaxWriteBufferNumberToMaintain

        public Options setMaxWriteBufferNumberToMaintain​(int maxWriteBufferNumberToMaintain)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        The total maximum number of write buffers to maintain in memory including copies of buffers that have already been flushed. Unlike AdvancedMutableColumnFamilyOptionsInterface.maxWriteBufferNumber(), this parameter does not affect flushing. This controls the minimum amount of write history that will be available in memory for conflict checking when Transactions are used. When using an OptimisticTransactionDB: If this value is too low, some transactions may fail at commit time due to not being able to determine whether there were any write conflicts. When using a TransactionDB: If Transaction::SetSnapshot is used, TransactionDB will read either in-memory write buffers or SST files to do write-conflict checking. Increasing this value can reduce the number of reads to SST files done for conflict detection. Setting this value to 0 will cause write buffers to be freed immediately after they are flushed. If this value is set to -1, AdvancedMutableColumnFamilyOptionsInterface.maxWriteBufferNumber() will be used. Default: If using a TransactionDB/OptimisticTransactionDB, the default value will be set to the value of AdvancedMutableColumnFamilyOptionsInterface.maxWriteBufferNumber() if it is not explicitly set by the user. Otherwise, the default is 0.
        Specified by:
        setMaxWriteBufferNumberToMaintain in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        maxWriteBufferNumberToMaintain - The maximum number of write buffers to maintain
        Returns:
        the reference to the current options.
      • setForceConsistencyChecks

        public Options setForceConsistencyChecks​(boolean forceConsistencyChecks)
        Description copied from interface: AdvancedColumnFamilyOptionsInterface
        In debug mode, RocksDB run consistency checks on the LSM every time the LSM change (Flush, Compaction, AddFile). These checks are disabled in release mode, use this option to enable them in release mode as well. Default: false
        Specified by:
        setForceConsistencyChecks in interface AdvancedColumnFamilyOptionsInterface<Options>
        Parameters:
        forceConsistencyChecks - true to force consistency checks
        Returns:
        the reference to the current options.
      • setAtomicFlush

        public Options setAtomicFlush​(boolean atomicFlush)
        Description copied from interface: DBOptionsInterface
        If true, RocksDB supports flushing multiple column families and committing their results atomically to MANIFEST. Note that it is not necessary to set atomic_flush to true if WAL is always enabled since WAL allows the database to be restored to the last persistent state in WAL. This option is useful when there are column families with writes NOT protected by WAL. For manual flush, application has to specify which column families to flush atomically in RocksDB.flush(FlushOptions, List). For auto-triggered flush, RocksDB atomically flushes ALL column families. Currently, any WAL-enabled writes after atomic flush may be replayed independently if the process crashes later and tries to recover.
        Specified by:
        setAtomicFlush in interface DBOptionsInterface<Options>
        Parameters:
        atomicFlush - true to enable atomic flush of multiple column families.
        Returns:
        the reference to the current options.
      • setAvoidUnnecessaryBlockingIO

        public Options setAvoidUnnecessaryBlockingIO​(boolean avoidUnnecessaryBlockingIO)
        Description copied from interface: DBOptionsInterface
        If true, working thread may avoid doing unnecessary and long-latency operation (such as deleting obsolete files directly or deleting memtable) and will instead schedule a background job to do it. Use it if you're latency-sensitive. If set to true, takes precedence over ReadOptions.setBackgroundPurgeOnIteratorCleanup(boolean).
        Specified by:
        setAvoidUnnecessaryBlockingIO in interface DBOptionsInterface<Options>
        Parameters:
        avoidUnnecessaryBlockingIO - If true, working thread may avoid doing unnecessary operation.
        Returns:
        the reference to the current options.
      • setPersistStatsToDisk

        public Options setPersistStatsToDisk​(boolean persistStatsToDisk)
        Description copied from interface: DBOptionsInterface
        If true, automatically persist stats to a hidden column family (column family name: ___rocksdb_stats_history___) every stats_persist_period_sec seconds; otherwise, write to an in-memory struct. User can query through `GetStatsHistory` API. If user attempts to create a column family with the same name on a DB which have previously set persist_stats_to_disk to true, the column family creation will fail, but the hidden column family will survive, as well as the previously persisted statistics. When peristing stats to disk, the stat name will be limited at 100 bytes. Default: false
        Specified by:
        setPersistStatsToDisk in interface DBOptionsInterface<Options>
        Parameters:
        persistStatsToDisk - true if stats should be persisted to hidden column family.
        Returns:
        the instance of the current object.
      • persistStatsToDisk

        public boolean persistStatsToDisk()
        Description copied from interface: DBOptionsInterface
        If true, automatically persist stats to a hidden column family (column family name: ___rocksdb_stats_history___) every stats_persist_period_sec seconds; otherwise, write to an in-memory struct. User can query through `GetStatsHistory` API. If user attempts to create a column family with the same name on a DB which have previously set persist_stats_to_disk to true, the column family creation will fail, but the hidden column family will survive, as well as the previously persisted statistics. When peristing stats to disk, the stat name will be limited at 100 bytes. Default: false
        Specified by:
        persistStatsToDisk in interface DBOptionsInterface<Options>
        Returns:
        true if stats should be persisted to hidden column family.
      • setWriteDbidToManifest

        public Options setWriteDbidToManifest​(boolean writeDbidToManifest)
        Description copied from interface: DBOptionsInterface
        Historically DB ID has always been stored in Identity File in DB folder. If this flag is true, the DB ID is written to Manifest file in addition to the Identity file. By doing this 2 problems are solved 1. We don't checksum the Identity file where as Manifest file is. 2. Since the source of truth for DB is Manifest file DB ID will sit with the source of truth. Previously the Identity file could be copied independent of Manifest and that can result in wrong DB ID. We recommend setting this flag to true. Default: false
        Specified by:
        setWriteDbidToManifest in interface DBOptionsInterface<Options>
        Parameters:
        writeDbidToManifest - if true, then DB ID will be written to Manifest file.
        Returns:
        the instance of the current object.
      • writeDbidToManifest

        public boolean writeDbidToManifest()
        Description copied from interface: DBOptionsInterface
        Historically DB ID has always been stored in Identity File in DB folder. If this flag is true, the DB ID is written to Manifest file in addition to the Identity file. By doing this 2 problems are solved 1. We don't checksum the Identity file where as Manifest file is. 2. Since the source of truth for DB is Manifest file DB ID will sit with the source of truth. Previously the Identity file could be copied independent of Manifest and that can result in wrong DB ID. We recommend setting this flag to true. Default: false
        Specified by:
        writeDbidToManifest in interface DBOptionsInterface<Options>
        Returns:
        true, if DB ID will be written to Manifest file.
      • setLogReadaheadSize

        public Options setLogReadaheadSize​(long logReadaheadSize)
        Description copied from interface: DBOptionsInterface
        The number of bytes to prefetch when reading the log. This is mostly useful for reading a remotely located log, as it can save the number of round-trips. If 0, then the prefetching is disabled. Default: 0
        Specified by:
        setLogReadaheadSize in interface DBOptionsInterface<Options>
        Parameters:
        logReadaheadSize - the number of bytes to prefetch when reading the log.
        Returns:
        the instance of the current object.
      • logReadaheadSize

        public long logReadaheadSize()
        Description copied from interface: DBOptionsInterface
        The number of bytes to prefetch when reading the log. This is mostly useful for reading a remotely located log, as it can save the number of round-trips. If 0, then the prefetching is disabled. Default: 0
        Specified by:
        logReadaheadSize in interface DBOptionsInterface<Options>
        Returns:
        the number of bytes to prefetch when reading the log.
      • setBestEffortsRecovery

        public Options setBestEffortsRecovery​(boolean bestEffortsRecovery)
        Description copied from interface: DBOptionsInterface
        By default, RocksDB recovery fails if any table file referenced in MANIFEST are missing after scanning the MANIFEST. Best-efforts recovery is another recovery mode that tries to restore the database to the most recent point in time without missing file. Currently not compatible with atomic flush. Furthermore, WAL files will not be used for recovery if best_efforts_recovery is true. Default: false
        Specified by:
        setBestEffortsRecovery in interface DBOptionsInterface<Options>
        Parameters:
        bestEffortsRecovery - if true, RocksDB will use best-efforts mode when recovering.
        Returns:
        the instance of the current object.
      • bestEffortsRecovery

        public boolean bestEffortsRecovery()
        Description copied from interface: DBOptionsInterface
        By default, RocksDB recovery fails if any table file referenced in MANIFEST are missing after scanning the MANIFEST. Best-efforts recovery is another recovery mode that tries to restore the database to the most recent point in time without missing file. Currently not compatible with atomic flush. Furthermore, WAL files will not be used for recovery if best_efforts_recovery is true. Default: false
        Specified by:
        bestEffortsRecovery in interface DBOptionsInterface<Options>
        Returns:
        true, if RocksDB uses best-efforts mode when recovering.
      • setMaxBgErrorResumeCount

        public Options setMaxBgErrorResumeCount​(int maxBgerrorResumeCount)
        Description copied from interface: DBOptionsInterface
        It defines how many times db resume is called by a separate thread when background retryable IO Error happens. When background retryable IO Error happens, SetBGError is called to deal with the error. If the error can be auto-recovered (e.g., retryable IO Error during Flush or WAL write), then db resume is called in background to recover from the error. If this value is 0 or negative, db resume will not be called. Default: INT_MAX
        Specified by:
        setMaxBgErrorResumeCount in interface DBOptionsInterface<Options>
        Parameters:
        maxBgerrorResumeCount - maximum number of times db resume should be called when IO Error happens.
        Returns:
        the instance of the current object.
      • maxBgerrorResumeCount

        public int maxBgerrorResumeCount()
        Description copied from interface: DBOptionsInterface
        It defines how many times db resume is called by a separate thread when background retryable IO Error happens. When background retryable IO Error happens, SetBGError is called to deal with the error. If the error can be auto-recovered (e.g., retryable IO Error during Flush or WAL write), then db resume is called in background to recover from the error. If this value is 0 or negative, db resume will not be called. Default: INT_MAX
        Specified by:
        maxBgerrorResumeCount in interface DBOptionsInterface<Options>
        Returns:
        maximum number of times db resume should be called when IO Error happens.
      • setBgerrorResumeRetryInterval

        public Options setBgerrorResumeRetryInterval​(long bgerrorResumeRetryInterval)
        Description copied from interface: DBOptionsInterface
        If max_bgerror_resume_count is ≥ 2, db resume is called multiple times. This option decides how long to wait to retry the next resume if the previous resume fails and satisfy redo resume conditions. Default: 1000000 (microseconds).
        Specified by:
        setBgerrorResumeRetryInterval in interface DBOptionsInterface<Options>
        Parameters:
        bgerrorResumeRetryInterval - how many microseconds to wait between DB resume attempts.
        Returns:
        the instance of the current object.
      • bgerrorResumeRetryInterval

        public long bgerrorResumeRetryInterval()
        Description copied from interface: DBOptionsInterface
        If max_bgerror_resume_count is ≥ 2, db resume is called multiple times. This option decides how long to wait to retry the next resume if the previous resume fails and satisfy redo resume conditions. Default: 1000000 (microseconds).
        Specified by:
        bgerrorResumeRetryInterval in interface DBOptionsInterface<Options>
        Returns:
        the instance of the current object.
      • setSstPartitionerFactory

        public Options setSstPartitionerFactory​(SstPartitionerFactory sstPartitionerFactory)
        Description copied from interface: ColumnFamilyOptionsInterface
        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
        Specified by:
        setSstPartitionerFactory in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        sstPartitionerFactory - The factory reference
        Returns:
        the reference of the current options.
      • setCompactionThreadLimiter

        public Options setCompactionThreadLimiter​(ConcurrentTaskLimiter compactionThreadLimiter)
        Description copied from interface: ColumnFamilyOptionsInterface
        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.
        Specified by:
        setCompactionThreadLimiter in interface ColumnFamilyOptionsInterface<Options>
        Parameters:
        compactionThreadLimiter - The compaction thread limiter.
        Returns:
        the reference of the current options.