Skip to main content

TDengine Configuration Parameter Scope Comparison

This document compares the configuration parameters of taosd (server-side) and taosc (client-side) in TDengine TSDB, clearly identifying the scope of each parameter.

Configuration Parameter Scope Comparison Table

Parameter NameScopeDescription
Connection Related
firstEpbothEndpoint of the first dnode in the cluster that taosd actively connects to at startup
secondEpbothEndpoint of the second dnode in the cluster that taosd tries to connect to if the firstEp is unreachable
fqdntaosdThe service address that taosd listens on
serverPortbothThe port that taosd listens on
compressMsgSizebothWhether to compress RPC messages
shellActivityTimerbothDuration in seconds for the client to send heartbeat to mnode
numOfRpcSessionsbothMaximum number of connections supported by RPC
numOfRpcThreadsbothNumber of threads for receiving and sending RPC data
numOfTaskQueueThreadsbothNumber of threads for processing RPC messages
rpcQueueMemoryAllowedtaosdMaximum memory allowed for received RPC messages in dnode
resolveFQDNRetryTimetaosdNumber of retries when FQDN resolution fails
timeToGetAvailableConntaoscMaximum waiting time to get an available connection
maxShellConnstaosdMaximum number of connections allowed
maxRetryWaitTimebothMaximum timeout for reconnection, calculated from the time of retry
shareConnLimitbothNumber of requests a connection can share
readTimeoutbothMinimum timeout for a single request
useAdaptertaoscWhether to use taosadapter, affects CSV file import
Monitoring Related
monitortaosdWhether to collect and report monitoring data
monitorFqdntaosdThe FQDN of the server where the taosKeeper service is located
monitorPorttaosdThe port number listened to by the taosKeeper service
monitorIntervaltaosdThe time interval for recording system parameters (CPU/memory) in the monitoring database
monitorMaxLogstaosdNumber of cached logs pending report
monitorComptaosdWhether to use compression when reporting monitoring logs
monitorLogProtocoltaosdWhether to print monitoring logs
monitorForceV2taosdWhether to use V2 protocol for reporting
telemetryReportingtaosdWhether to upload telemetry
telemetryServertaosdTelemetry server address
telemetryPorttaosdTelemetry server port number
telemetryIntervaltaosdTelemetry upload interval
crashReportingbothWhether to upload crash information
enableMetricstaosdWhether to open write diagnostic tools, collect and upload write metrics
metricsIntervaltaosdInterval for write diagnostic tools to upload write metrics
metricsLeveltaosdLevel of write metrics uploaded by write diagnostic tools
Query Related
countAlwaysReturnValuebothWhether count/hyperloglog functions return a value when input data is empty or NULL
tagFilterCachetaosdWhether to cache tag filter results
queryBufferSizetaosdQuery available cache size
queryRspPolicytaosdQuery response strategy
queryUseMemoryPooltaosdWhether query will use memory pool to manage memory
minReservedMemorySizetaosdThe minimum reserved system available memory size
singleQueryMaxMemorySizetaosdThe memory limit that a single query can use on a single node (dnode)
filterScalarModetaosdForce scalar filter mode
queryNoFetchTimeoutSectaosdTimeout when application does not FETCH data for a long time during query
queryPlannerTracebothWhether the query plan outputs detailed logs
queryNodeChunkSizebothChunk size of the query plan
queryUseNodeAllocatorbothAllocation method of the query plan
queryMaxConcurrentTablesbothAllocation method of the query plan
queryRsmaTolerancetaosdAllocation method of the query plan
enableQueryHbbothWhether to send query heartbeat messages
pqSortMemThresholdtaosdMemory threshold for sorting
keepColumnNametaoscAutomatically sets the alias to the column name when querying with Last, First, LastRow functions
multiResultFunctionStarReturnTagstaoscWhether last()/last_row()/first(*) returns tag columns when querying a supertable
metaCacheMaxSizetaoscSpecifies the maximum size of metadata cache for a single client
maxTsmaCalcDelaytaoscThe allowable delay for tsma calculation by the client during query
tsmaDataDeleteMarktaoscThe retention time for intermediate results of historical data calculated by TSMA
queryPolicytaoscExecution strategy for query statements
queryTableNotExistAsEmptytaoscWhether to return an empty result set when the queried table does not exist
querySmaOptimizetaoscOptimization strategy for sma index
queryMaxConcurrentTablestaoscConcurrency number of the query plan
minSlidingTimetaoscMinimum allowable value for sliding
minIntervalTimetaoscMinimum allowable value for interval
compareAsStrInGreatesttaoscComparison type conversion rules for greatest and least functions
showFullCreateTableColumntaoscWhether show create table returns column compression information
Region Related
timezonebothTime zone
localebothSystem locale information and encoding format
charsetbothCharacter set encoding
Storage Related
dataDirtaosdDirectory for data files, all data files are written to this directory
diskIDCheckEnabledtaosdWhether to check if the disk id of dataDir has changed when restarting dnode
tempDirbothSpecifies the directory for generating temporary files during system operation
minimalDataDirGBtaosdMinimum space to be reserved in the time-series data storage directory specified by dataDir
minimalTmpDirGBbothMinimum space to be reserved in the temporary file directory specified by tempDir
minDiskFreeSizetaosdWhen the available space on a disk is less than or equal to this threshold, the disk will no longer be selected
ssAutoMigrateIntervalSectaosdTrigger cycle for automatic upload of local data files to shared storage
ssEnabledtaosdWhether to enable shared storage
ssAccessStringtaosdA string which contains various options for accessing the shared storage
ssPageCacheSizetaosdNumber of shared storage page cache pages
ssUploadDelaySectaosdHow long a data file remains unchanged before being uploaded to shared storage
cacheLazyLoadThresholdtaosdCache loading strategy
Cluster Related
supportVnodestaosdMaximum number of vnodes supported by a dnode
numOfCommitThreadstaosdMaximum number of commit threads
numOfCompactThreadstaosdMaximum number of compact threads
numOfMnodeReadThreadstaosdNumber of Read threads for mnode
numOfVnodeQueryThreadstaosdNumber of Query threads for vnode
numOfVnodeFetchThreadstaosdNumber of Fetch threads for vnode
numOfVnodeRsmaThreadstaosdNumber of Rsma threads for vnode
numOfQnodeQueryThreadstaosdNumber of Query threads for qnode
numOfSnodeSharedThreadstaosdNumber of shared threads for snode
numOfSnodeUniqueThreadstaosdNumber of exclusive threads for snode
ratioOfVnodeStreamThreadstaosdRatio of stream computing using vnode threads
ttlUnittaosdUnit for ttl parameter
ttlPushIntervaltaosdFrequency of ttl timeout checks
ttlChangeOnWritetaosdWhether ttl expiration time changes with table modification
ttlBatchDropNumtaosdNumber of subtables deleted in a batch for ttl
retentionSpeedLimitMBtaosdSpeed limit for data migration across different levels of disks
maxTsmaNumtaosdMaximum number of TSMAs that can be created in the cluster
tmqMaxTopicNumtaosdMaximum number of topics that can be established for subscription
tmqRowSizetaosdMaximum number of records in a subscription data block
audittaosdAudit feature switch
auditIntervaltaosdTime interval for reporting audit data
auditCreateTabletaosdWhether to enable audit feature for creating subtables
encryptAlgorithmtaosdData encryption algorithm
encryptScopetaosdEncryption scope
encryptPassAlgorithmtaosdSwitch for saving user password as encrypted string
enableWhiteListtaosdSwitch for whitelist feature
syncLogBufferMemoryAllowedtaosdMaximum memory allowed for sync log cache messages for a dnode
syncApplyQueueSizetaosdSize of apply queue for sync log
syncElectIntervaltaosdInternal parameter, for debugging synchronization module
syncHeartbeatIntervaltaosdInternal parameter, for debugging synchronization module
syncHeartbeatTimeouttaosdInternal parameter, for debugging synchronization module
syncSnapReplMaxWaitNtaosdInternal parameter, for debugging synchronization module
arbHeartBeatIntervalSectaosdInternal parameter, for debugging synchronization module
arbCheckSyncIntervalSectaosdInternal parameter, for debugging synchronization module
arbSetAssignedTimeoutSectaosdInternal parameter, for debugging synchronization module
mndLogRetentiontaosdInternal parameter, for debugging mnode module
skipGranttaosdInternal parameter, for authorization checks
trimVDbIntervalSectaosdInternal parameter, for deleting expired data
ttlFlushThresholdtaosdInternal parameter, frequency of ttl timer
compactPullupIntervaltaosdInternal parameter, frequency of data reorganization timer
walFsyncDataSizeLimittaosdInternal parameter, threshold for WAL to perform FSYNC
walForceRepairtaosdInternal parameter, repair WAL file forcibly
transPullupIntervaltaosdInternal parameter, retry interval for mnode to execute transactions
forceKillTranstaosdInternal parameter, for debugging mnode transaction module
mqRebalanceIntervaltaosdInternal parameter, interval for consumer rebalancing
uptimeIntervaltaosdInternal parameter, for recording system uptime
timeseriesThresholdtaosdInternal parameter, for usage statistics
udftaosdWhether to start UDF service
udfdResFuncstaosdInternal parameter, for setting UDF result sets
udfdLdLibPathtaosdInternal parameter, indicates the library path for loading UDF
enableStrongPasswordtaosdPassword requirements for strong password validation
Stream Computing Parameters
numOfMnodeStreamMgmtThreadstaosdNumber of mnode stream computing management threads
numOfStreamMgmtThreadstaosdNumber of snode stream computing management threads
numOfVnodeStreamReaderThreadstaosdNumber of vnode stream computing read threads
numOfStreamTriggerThreadstaosdNumber of stream computing trigger threads
numOfStreamRunnerThreadstaosdNumber of stream computing execution threads
streamBufferSizetaosdMaximum cache size that stream computing can use
streamNotifyMessageSizetaosdControls the message size for event notifications
streamNotifyFrameSizetaosdControls the underlying frame size when sending event notification messages
Log Related
logDirbothLog file directory, operational logs will be written to this directory
minimalLogDirGBbothStops writing logs when the available space on the disk where the log folder is located is less than this value
numOfLogLinesbothMaximum number of lines allowed in a single log file
asyncLogbothLog writing mode
logKeepDaysbothMaximum retention time for log files
slowLogThresholdtaosdSlow query threshold, queries taking longer than or equal to this threshold are considered slow
slowLogMaxLentaosdMaximum length of slow query logs
slowLogScopetaosdType of slow query records
slowLogExceptDbtaosdSpecifies the database that does not report slow queries
debugFlagbothLog switch for running logs
tmrDebugFlagbothLog switch for the timer module
uDebugFlagbothLog switch for the utility module
rpcDebugFlagbothLog switch for the rpc module
qDebugFlagbothLog switch for the query module
dDebugFlagtaosdLog switch for the dnode module
vDebugFlagtaosdLog switch for the vnode module
mDebugFlagtaosdLog switch for the mnode module
azDebugFlagtaosdLog switch for the S3 module
sDebugFlagtaosdLog switch for the sync module
tsdbDebugFlagtaosdLog switch for the tsdb module
tqDebugFlagtaosdLog switch for the tq module
fsDebugFlagtaosdLog switch for the fs module
udfDebugFlagtaosdLog switch for the udf module
smaDebugFlagtaosdLog switch for the sma module
idxDebugFlagtaosdLog switch for the index module
tdbDebugFlagtaosdLog switch for the tdb module
metaDebugFlagtaosdLog switch for the meta module
stDebugFlagtaosdLog switch for the stream module
sndDebugFlagtaosdLog switch for the snode module
jniDebugFlagtaoscLog switch for the jni module
cDebugFlagtaoscLog switch for the client module
simDebugFlagtaoscInternal parameter, log switch for the test tool
tqClientDebugFlagtaoscLog switch for the client module
Debugging Related
enableCoreFilebothWhether to generate a core file when crashing
configDirbothDirectory where the configuration files are located
forceReadConfigtaosdWhether to force reading configuration from file
scriptDirbothDirectory for internal test tool scripts
assertbothAssertion control switch
randErrorChancebothInternal parameter, used for random failure testing
randErrorDivisorbothInternal parameter, used for random failure testing
randErrorScopebothInternal parameter, used for random failure testing
safetyCheckLevelbothInternal parameter, used for random failure testing
experimentaltaosdInternal parameter, used for some experimental features
simdEnablebothInternal parameter, used for testing SIMD acceleration
AVX512EnablebothInternal parameter, used for testing AVX512 acceleration
rsyncPorttaosdInternal parameter, used for debugging stream computing
snodeAddresstaosdInternal parameter, used for debugging stream computing
checkpointBackupDirtaosdInternal parameter, used for restoring snode data
enableAuditDeletetaosdInternal parameter, used for testing audit functions
slowLogThresholdTesttaosdInternal parameter, used for testing slow logs
bypassFlagbothInternal parameter, used for short-circuit testing
Compression Parameters
fPrecisiontaosdSets the compression precision for float type floating numbers
dPrecisiontaosdSets the compression precision for double type floating numbers
lossyColumntaosdEnables TSZ lossy compression for float and/or double types
ifAdtFsetaosdWhen TSZ lossy compression is enabled, use the FSE algorithm instead of the HUFFMAN algorithm
enableIpv6taosdForce nodes to communicate directly via IPv6 only
maxRangetaosdInternal parameter, used for setting lossy compression
curRangetaosdInternal parameter, used for setting lossy compression
compressortaosdInternal parameter, used for setting lossy compression
Writing Related
smlChildTableNametaoscKey for custom child table name in schemaless
smlAutoChildTableNameDelimitertaoscDelimiter between schemaless tags, concatenated as the child table name
smlTagNametaoscDefault tag name when schemaless tag is empty
smlTsDefaultNametaoscConfiguration for setting the time column name in schemaless auto table creation
smlDot2UnderlinetaoscConverts dots in supertable names to underscores in schemaless
maxInsertBatchRowstaoscMaximum number of rows per batch insert
SHELL Related
enableSciencetaoscWhether to enable scientific notation for displaying floating numbers
WebSocket Related
serverPorttaoscThe port that taosAdapter listens on
timezonetaoscTime zone
logDirtaoscLog file directory, operational logs will be written to this directory
logKeepDaystaoscMaximum retention period for log files in days
rotationCounttaoscNumber of log file rotations before deletion
rotationSizetaoscMaximum size of a single log file
compressiontaoscEnable WebSocket message compression
adapterListtaoscList of taosAdapter addresses for load balancing and failover
connRetriestaoscMaximum number of retries upon connection failure
retryBackoffMstaoscInitial wait time in milliseconds after connection failure
retryBackoffMaxMstaoscMaximum wait time in milliseconds when connection fails

Description

  • taosd: Configuration parameters that only take effect on the server side
  • taosc: Configuration parameters that only take effect on the client side
  • both: Configuration parameters that take effect on both server and client sides