InfluxDBv3EnterpriseParameters

All the customer-modifiable InfluxDB v3 Enterprise parameters in Timestream for InfluxDB.

dedicatedCompactor

Specifies if the compactor instance should be a standalone instance or not.

Type: Boolean

Required: Yes

ingestQueryInstances

Specifies number of instances in the DbCluster which can both ingest and query.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 4.

Required: Yes

queryOnlyInstances

Specifies number of instances in the DbCluster which can only query.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 10.

Required: Yes

catalogSyncInterval

Defines how often the catalog synchronizes across cluster nodes.

Default: 10s

Type: Duration object

Required: No

compactionCheckInterval

Specifies how often the compactor checks for new compaction work to perform.

Default: 10s

Type: Duration object

Required: No

compactionCleanupWait

Specifies the amount of time that the compactor waits after finishing a compaction run to delete files marked as needing deletion during that compaction run.

Default: 10m

Type: Duration object

Required: No

compactionGen2Duration

Specifies the duration of the first level of compaction (gen2). Later levels of compaction are multiples of this duration. This value should be equal to or greater than the gen1 duration.

Default: 20m

Type: Duration object

Required: No

compactionMaxNumFilesPerPlan

Sets the maximum number of files included in any compaction plan.

Default: 500

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10000.

Required: No

compactionMultipliers

Specifies a comma-separated list of multiples defining the duration of each level of compaction. The number of elements in the list determines the number of compaction levels. The first element specifies the duration of the first level (gen3); subsequent levels are multiples of the previous level.

Default: 3,4,6,5

Type: String

Length Constraints: Minimum length of 7. Maximum length of 16.

Pattern: \d+,\d+,\d+,\d+

Required: No

compactionRowLimit

Specifies the soft limit for the number of rows per file that the compactor writes. The compactor may write more rows than this limit.

Default: 1000000

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100000000.

Required: No

dataFusionConfig

Provides custom configuration to DataFusion as a comma-separated list of key:value pairs.

Type: String

Pattern: [a-zA-Z0-9_]+=[^,\s]+(?:,[a-zA-Z0-9_]+=[^,\s]+)*

Required: No

dataFusionMaxParquetFanout

When multiple parquet files are required in a sorted way (deduplication for example), specifies the maximum fanout.

Default: 1000

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 1000000.

Required: No

dataFusionNumThreads

Sets the maximum number of DataFusion runtime threads to use.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 2048.

Required: No

dataFusionRuntimeDisableLifoSlot

Disables the LIFO slot of the DataFusion runtime.

Type: Boolean

Required: No

dataFusionRuntimeEventInterval

Sets the number of scheduler ticks after which the scheduler of the DataFusion tokio runtime polls for external events–for example: timers, I/O.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 128.

Required: No

dataFusionRuntimeGlobalQueueInterval

Sets the number of scheduler ticks after which the scheduler of the DataFusion runtime polls the global task queue.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 128.

Required: No

dataFusionRuntimeMaxBlockingThreads

Specifies the limit for additional threads spawned by the DataFusion runtime.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 1024.

Required: No

dataFusionRuntimeMaxIoEventsPerTick

Configures the maximum number of events processed per tick by the tokio DataFusion runtime.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 4096.

Required: No

dataFusionRuntimeThreadKeepAlive

Sets a custom timeout for a thread in the blocking pool of the tokio DataFusion runtime.

Type: Duration object

Required: No

dataFusionRuntimeThreadPriority

Sets the thread priority for tokio DataFusion runtime workers.

Default: 10

Type: Integer

Valid Range: Minimum value of -20. Maximum value of 19.

Required: No

dataFusionRuntimeType

Specifies the DataFusion tokio runtime type.

Default: multi-thread

Type: String

Valid Values: multi-thread | multi-thread-alt

Required: No

dataFusionUseCachedParquetLoader

Uses a cached parquet loader when reading parquet files from the object store.

Type: Boolean

Required: No

deleteGracePeriod

Specifies the grace period before permanently deleting data.

Default: 24h

Type: Duration object

Required: No

disableParquetMemCache

Disables the in-memory Parquet cache. By default, the cache is enabled.

Type: Boolean

Required: No

distinctCacheEvictionInterval

Specifies the interval to evict expired entries from the distinct value cache, expressed as a human-readable duration–for example: 20s, 1m, 1h.

Default: 10s

Type: Duration object

Required: No

distinctValueCacheDisableFromHistory

Disables populating the distinct value cache from historical data. If disabled, the cache is still populated with data from the write-ahead log (WAL).

Type: Boolean

Required: No

execMemPoolBytes

Specifies the size of memory pool used during query execution. Can be given as absolute value in bytes or as a percentage of the total available memory–for example: 8000000000 or 10%.

Default: 20%

Type: PercentOrAbsoluteLong object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

forceSnapshotMemThreshold

Specifies the threshold for the internal memory buffer. Supports either a percentage (portion of available memory) or absolute value in MB–for example: 70% or 100

Default: 70%

Type: PercentOrAbsoluteLong object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

gen1Duration

Specifies the duration that Parquet files are arranged into. Data timestamps land each row into a file of this duration. Supported durations are 1m, 5m, and 10m. These files are known as “generation 1” files, which the compactor can merge into larger generations.

Default: 10m

Type: Duration object

Required: No

gen1LookbackDuration

Specifies how far back to look when creating generation 1 Parquet files.

Default: 24h

Type: Duration object

Required: No

hardDeleteDefaultDuration

Sets the default duration for hard deletion of data.

Default: 90d

Type: Duration object

Required: No

lastCacheEvictionInterval

Specifies the interval to evict expired entries from the Last-N-Value cache, expressed as a human-readable duration–for example: 20s, 1m, 1h.

Default: 10s

Type: Duration object

Required: No

lastValueCacheDisableFromHistory

Disables populating the last-N-value cache from historical data. If disabled, the cache is still populated with data from the write-ahead log (WAL).

Type: Boolean

Required: No

logFilter

Sets the filter directive for logs.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1024.

Required: No

logFormat

Defines the message format for logs.

Default: full

Type: String

Valid Values: full

Required: No

maxHttpRequestSize

Specifies the maximum size of HTTP requests.

Default: 10485760

Type: Long

Valid Range: Minimum value of 1024. Maximum value of 16777216.

Required: No

parquetMemCachePruneInterval

Sets the interval to check if the in-memory Parquet cache needs to be pruned.

Default: 1s

Type: Duration object

Required: No

parquetMemCachePrunePercentage

Specifies the percentage of entries to prune during a prune operation on the in-memory Parquet cache.

Default: 0.1

Type: Float

Valid Range: Minimum value of 0. Maximum value of 1.

Required: No

parquetMemCacheQueryPathDuration

Specifies the time window for caching recent Parquet files in memory.

Default: 5h

Type: Duration object

Required: No

parquetMemCacheSize

Specifies the size of the in-memory Parquet cache in megabytes or percentage of total available memory.

Default: 20%

Type: PercentOrAbsoluteLong object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

preemptiveCacheAge

Specifies the interval to prefetch into the Parquet cache during compaction.

Default: 3d

Type: Duration object

Required: No

queryFileLimit

Limits the number of Parquet files a query can access. If a query attempts to read more than this limit, InfluxDB 3 returns an error.

Default: 432

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 1024.

Required: No

queryLogSize

Defines the size of the query log. Up to this many queries remain in the log before older queries are evicted to make room for new ones.

Default: 1000

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10000.

Required: No

replicationInterval

Specifies the interval at which data replication occurs between cluster nodes.

Default: 250ms

Type: Duration object

Required: No

retentionCheckInterval

The interval at which retention policies are checked and enforced. Enter as a human-readable time–for example: 30m or 1h.

Default: 30m

Type: Duration object

Required: No

snapshottedWalFilesToKeep

Specifies the number of snapshotted WAL files to retain in the object store. Flushing the WAL files does not clear the WAL files immediately; they are deleted when the number of snapshotted WAL files exceeds this number.

Default: 300

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 10000.

Required: No

tableIndexCacheConcurrencyLimit

Limits the concurrency level for table index cache operations.

Default: 8

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

tableIndexCacheMaxEntries

Specifies the maximum number of entries in the table index cache.

Default: 1000

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 1000.

Required: No

walMaxWriteBufferSize

Specifies the maximum number of write requests that can be buffered before a flush must be executed and succeed.

Default: 100000

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 1000000.

Required: No

walReplayConcurrencyLimit

Concurrency limit during WAL replay. Setting this number too high can lead to OOM. The default is dynamically determined.

Default: max(num_cpus, 10)

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

walReplayFailOnError

Determines whether WAL replay should fail when encountering errors.

Default: false

Type: Boolean

Required: No

walSnapshotSize

Defines the number of WAL files to attempt to remove in a snapshot. This, multiplied by the interval, determines how often snapshots are taken.

Default: 600

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10000.

Required: No

InfluxDBv3EnterpriseParameters

Contents

See Also