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 Name | Scope | Description |
---|---|---|
Connection Related | ||
firstEp | both | Endpoint of the first dnode in the cluster that taosd actively connects to at startup |
secondEp | both | Endpoint of the second dnode in the cluster that taosd tries to connect to if the firstEp is unreachable |
fqdn | taosd | The service address that taosd listens on |
serverPort | both | The port that taosd listens on |
compressMsgSize | both | Whether to compress RPC messages |
shellActivityTimer | both | Duration in seconds for the client to send heartbeat to mnode |
numOfRpcSessions | both | Maximum number of connections supported by RPC |
numOfRpcThreads | both | Number of threads for receiving and sending RPC data |
numOfTaskQueueThreads | both | Number of threads for processing RPC messages |
rpcQueueMemoryAllowed | taosd | Maximum memory allowed for received RPC messages in dnode |
resolveFQDNRetryTime | taosd | Number of retries when FQDN resolution fails |
timeToGetAvailableConn | taosc | Maximum waiting time to get an available connection |
maxShellConns | taosd | Maximum number of connections allowed |
maxRetryWaitTime | both | Maximum timeout for reconnection, calculated from the time of retry |
shareConnLimit | both | Number of requests a connection can share |
readTimeout | both | Minimum timeout for a single request |
useAdapter | taosc | Whether to use taosadapter, affects CSV file import |
Monitoring Related | ||
monitor | taosd | Whether to collect and report monitoring data |
monitorFqdn | taosd | The FQDN of the server where the taosKeeper service is located |
monitorPort | taosd | The port number listened to by the taosKeeper service |
monitorInterval | taosd | The time interval for recording system parameters (CPU/memory) in the monitoring database |
monitorMaxLogs | taosd | Number of cached logs pending report |
monitorComp | taosd | Whether to use compression when reporting monitoring logs |
monitorLogProtocol | taosd | Whether to print monitoring logs |
monitorForceV2 | taosd | Whether to use V2 protocol for reporting |
telemetryReporting | taosd | Whether to upload telemetry |
telemetryServer | taosd | Telemetry server address |
telemetryPort | taosd | Telemetry server port number |
telemetryInterval | taosd | Telemetry upload interval |
crashReporting | both | Whether to upload crash information |
enableMetrics | taosd | Whether to open write diagnostic tools, collect and upload write metrics |
metricsInterval | taosd | Interval for write diagnostic tools to upload write metrics |
metricsLevel | taosd | Level of write metrics uploaded by write diagnostic tools |
Query Related | ||
countAlwaysReturnValue | both | Whether count/hyperloglog functions return a value when input data is empty or NULL |
tagFilterCache | taosd | Whether to cache tag filter results |
queryBufferSize | taosd | Query available cache size |
queryRspPolicy | taosd | Query response strategy |
queryUseMemoryPool | taosd | Whether query will use memory pool to manage memory |
minReservedMemorySize | taosd | The minimum reserved system available memory size |
singleQueryMaxMemorySize | taosd | The memory limit that a single query can use on a single node (dnode) |
filterScalarMode | taosd | Force scalar filter mode |
queryNoFetchTimeoutSec | taosd | Timeout when application does not FETCH data for a long time during query |
queryPlannerTrace | both | Whether the query plan outputs detailed logs |
queryNodeChunkSize | both | Chunk size of the query plan |
queryUseNodeAllocator | both | Allocation method of the query plan |
queryMaxConcurrentTables | both | Allocation method of the query plan |
queryRsmaTolerance | taosd | Allocation method of the query plan |
enableQueryHb | both | Whether to send query heartbeat messages |
pqSortMemThreshold | taosd | Memory threshold for sorting |
keepColumnName | taosc | Automatically sets the alias to the column name when querying with Last, First, LastRow functions |
multiResultFunctionStarReturnTags | taosc | Whether last()/last_row()/first(*) returns tag columns when querying a supertable |
metaCacheMaxSize | taosc | Specifies the maximum size of metadata cache for a single client |
maxTsmaCalcDelay | taosc | The allowable delay for tsma calculation by the client during query |
tsmaDataDeleteMark | taosc | The retention time for intermediate results of historical data calculated by TSMA |
queryPolicy | taosc | Execution strategy for query statements |
queryTableNotExistAsEmpty | taosc | Whether to return an empty result set when the queried table does not exist |
querySmaOptimize | taosc | Optimization strategy for sma index |
queryMaxConcurrentTables | taosc | Concurrency number of the query plan |
minSlidingTime | taosc | Minimum allowable value for sliding |
minIntervalTime | taosc | Minimum allowable value for interval |
compareAsStrInGreatest | taosc | Comparison type conversion rules for greatest and least functions |
showFullCreateTableColumn | taosc | Whether show create table returns column compression information |
Region Related | ||
timezone | both | Time zone |
locale | both | System locale information and encoding format |
charset | both | Character set encoding |
Storage Related | ||
dataDir | taosd | Directory for data files, all data files are written to this directory |
diskIDCheckEnabled | taosd | Whether to check if the disk id of dataDir has changed when restarting dnode |
tempDir | both | Specifies the directory for generating temporary files during system operation |
minimalDataDirGB | taosd | Minimum space to be reserved in the time-series data storage directory specified by dataDir |
minimalTmpDirGB | both | Minimum space to be reserved in the temporary file directory specified by tempDir |
minDiskFreeSize | taosd | When the available space on a disk is less than or equal to this threshold, the disk will no longer be selected |
ssAutoMigrateIntervalSec | taosd | Trigger cycle for automatic upload of local data files to shared storage |
ssEnabled | taosd | Whether to enable shared storage |
ssAccessString | taosd | A string which contains various options for accessing the shared storage |
ssPageCacheSize | taosd | Number of shared storage page cache pages |
ssUploadDelaySec | taosd | How long a data file remains unchanged before being uploaded to shared storage |
cacheLazyLoadThreshold | taosd | Cache loading strategy |
Cluster Related | ||
supportVnodes | taosd | Maximum number of vnodes supported by a dnode |
numOfCommitThreads | taosd | Maximum number of commit threads |
numOfCompactThreads | taosd | Maximum number of compact threads |
numOfMnodeReadThreads | taosd | Number of Read threads for mnode |
numOfVnodeQueryThreads | taosd | Number of Query threads for vnode |
numOfVnodeFetchThreads | taosd | Number of Fetch threads for vnode |
numOfVnodeRsmaThreads | taosd | Number of Rsma threads for vnode |
numOfQnodeQueryThreads | taosd | Number of Query threads for qnode |
numOfSnodeSharedThreads | taosd | Number of shared threads for snode |
numOfSnodeUniqueThreads | taosd | Number of exclusive threads for snode |
ratioOfVnodeStreamThreads | taosd | Ratio of stream computing using vnode threads |
ttlUnit | taosd | Unit for ttl parameter |
ttlPushInterval | taosd | Frequency of ttl timeout checks |
ttlChangeOnWrite | taosd | Whether ttl expiration time changes with table modification |
ttlBatchDropNum | taosd | Number of subtables deleted in a batch for ttl |
retentionSpeedLimitMB | taosd | Speed limit for data migration across different levels of disks |
maxTsmaNum | taosd | Maximum number of TSMAs that can be created in the cluster |
tmqMaxTopicNum | taosd | Maximum number of topics that can be established for subscription |
tmqRowSize | taosd | Maximum number of records in a subscription data block |
audit | taosd | Audit feature switch |
auditInterval | taosd | Time interval for reporting audit data |
auditCreateTable | taosd | Whether to enable audit feature for creating subtables |
encryptAlgorithm | taosd | Data encryption algorithm |
encryptScope | taosd | Encryption scope |
encryptPassAlgorithm | taosd | Switch for saving user password as encrypted string |
enableWhiteList | taosd | Switch for whitelist feature |
syncLogBufferMemoryAllowed | taosd | Maximum memory allowed for sync log cache messages for a dnode |
syncApplyQueueSize | taosd | Size of apply queue for sync log |
syncElectInterval | taosd | Internal parameter, for debugging synchronization module |
syncHeartbeatInterval | taosd | Internal parameter, for debugging synchronization module |
syncHeartbeatTimeout | taosd | Internal parameter, for debugging synchronization module |
syncSnapReplMaxWaitN | taosd | Internal parameter, for debugging synchronization module |
arbHeartBeatIntervalSec | taosd | Internal parameter, for debugging synchronization module |
arbCheckSyncIntervalSec | taosd | Internal parameter, for debugging synchronization module |
arbSetAssignedTimeoutSec | taosd | Internal parameter, for debugging synchronization module |
mndLogRetention | taosd | Internal parameter, for debugging mnode module |
skipGrant | taosd | Internal parameter, for authorization checks |
trimVDbIntervalSec | taosd | Internal parameter, for deleting expired data |
ttlFlushThreshold | taosd | Internal parameter, frequency of ttl timer |
compactPullupInterval | taosd | Internal parameter, frequency of data reorganization timer |
walFsyncDataSizeLimit | taosd | Internal parameter, threshold for WAL to perform FSYNC |
walForceRepair | taosd | Internal parameter, repair WAL file forcibly |
transPullupInterval | taosd | Internal parameter, retry interval for mnode to execute transactions |
forceKillTrans | taosd | Internal parameter, for debugging mnode transaction module |
mqRebalanceInterval | taosd | Internal parameter, interval for consumer rebalancing |
uptimeInterval | taosd | Internal parameter, for recording system uptime |
timeseriesThreshold | taosd | Internal parameter, for usage statistics |
udf | taosd | Whether to start UDF service |
udfdResFuncs | taosd | Internal parameter, for setting UDF result sets |
udfdLdLibPath | taosd | Internal parameter, indicates the library path for loading UDF |
enableStrongPassword | taosd | Password requirements for strong password validation |
Stream Computing Parameters | ||
numOfMnodeStreamMgmtThreads | taosd | Number of mnode stream computing management threads |
numOfStreamMgmtThreads | taosd | Number of snode stream computing management threads |
numOfVnodeStreamReaderThreads | taosd | Number of vnode stream computing read threads |
numOfStreamTriggerThreads | taosd | Number of stream computing trigger threads |
numOfStreamRunnerThreads | taosd | Number of stream computing execution threads |
streamBufferSize | taosd | Maximum cache size that stream computing can use |
streamNotifyMessageSize | taosd | Controls the message size for event notifications |
streamNotifyFrameSize | taosd | Controls the underlying frame size when sending event notification messages |
Log Related | ||
logDir | both | Log file directory, operational logs will be written to this directory |
minimalLogDirGB | both | Stops writing logs when the available space on the disk where the log folder is located is less than this value |
numOfLogLines | both | Maximum number of lines allowed in a single log file |
asyncLog | both | Log writing mode |
logKeepDays | both | Maximum retention time for log files |
slowLogThreshold | taosd | Slow query threshold, queries taking longer than or equal to this threshold are considered slow |
slowLogMaxLen | taosd | Maximum length of slow query logs |
slowLogScope | taosd | Type of slow query records |
slowLogExceptDb | taosd | Specifies the database that does not report slow queries |
debugFlag | both | Log switch for running logs |
tmrDebugFlag | both | Log switch for the timer module |
uDebugFlag | both | Log switch for the utility module |
rpcDebugFlag | both | Log switch for the rpc module |
qDebugFlag | both | Log switch for the query module |
dDebugFlag | taosd | Log switch for the dnode module |
vDebugFlag | taosd | Log switch for the vnode module |
mDebugFlag | taosd | Log switch for the mnode module |
azDebugFlag | taosd | Log switch for the S3 module |
sDebugFlag | taosd | Log switch for the sync module |
tsdbDebugFlag | taosd | Log switch for the tsdb module |
tqDebugFlag | taosd | Log switch for the tq module |
fsDebugFlag | taosd | Log switch for the fs module |
udfDebugFlag | taosd | Log switch for the udf module |
smaDebugFlag | taosd | Log switch for the sma module |
idxDebugFlag | taosd | Log switch for the index module |
tdbDebugFlag | taosd | Log switch for the tdb module |
metaDebugFlag | taosd | Log switch for the meta module |
stDebugFlag | taosd | Log switch for the stream module |
sndDebugFlag | taosd | Log switch for the snode module |
jniDebugFlag | taosc | Log switch for the jni module |
cDebugFlag | taosc | Log switch for the client module |
simDebugFlag | taosc | Internal parameter, log switch for the test tool |
tqClientDebugFlag | taosc | Log switch for the client module |
Debugging Related | ||
enableCoreFile | both | Whether to generate a core file when crashing |
configDir | both | Directory where the configuration files are located |
forceReadConfig | taosd | Whether to force reading configuration from file |
scriptDir | both | Directory for internal test tool scripts |
assert | both | Assertion control switch |
randErrorChance | both | Internal parameter, used for random failure testing |
randErrorDivisor | both | Internal parameter, used for random failure testing |
randErrorScope | both | Internal parameter, used for random failure testing |
safetyCheckLevel | both | Internal parameter, used for random failure testing |
experimental | taosd | Internal parameter, used for some experimental features |
simdEnable | both | Internal parameter, used for testing SIMD acceleration |
AVX512Enable | both | Internal parameter, used for testing AVX512 acceleration |
rsyncPort | taosd | Internal parameter, used for debugging stream computing |
snodeAddress | taosd | Internal parameter, used for debugging stream computing |
checkpointBackupDir | taosd | Internal parameter, used for restoring snode data |
enableAuditDelete | taosd | Internal parameter, used for testing audit functions |
slowLogThresholdTest | taosd | Internal parameter, used for testing slow logs |
bypassFlag | both | Internal parameter, used for short-circuit testing |
Compression Parameters | ||
fPrecision | taosd | Sets the compression precision for float type floating numbers |
dPrecision | taosd | Sets the compression precision for double type floating numbers |
lossyColumn | taosd | Enables TSZ lossy compression for float and/or double types |
ifAdtFse | taosd | When TSZ lossy compression is enabled, use the FSE algorithm instead of the HUFFMAN algorithm |
enableIpv6 | taosd | Force nodes to communicate directly via IPv6 only |
maxRange | taosd | Internal parameter, used for setting lossy compression |
curRange | taosd | Internal parameter, used for setting lossy compression |
compressor | taosd | Internal parameter, used for setting lossy compression |
Writing Related | ||
smlChildTableName | taosc | Key for custom child table name in schemaless |
smlAutoChildTableNameDelimiter | taosc | Delimiter between schemaless tags, concatenated as the child table name |
smlTagName | taosc | Default tag name when schemaless tag is empty |
smlTsDefaultName | taosc | Configuration for setting the time column name in schemaless auto table creation |
smlDot2Underline | taosc | Converts dots in supertable names to underscores in schemaless |
maxInsertBatchRows | taosc | Maximum number of rows per batch insert |
SHELL Related | ||
enableScience | taosc | Whether to enable scientific notation for displaying floating numbers |
WebSocket Related | ||
serverPort | taosc | The port that taosAdapter listens on |
timezone | taosc | Time zone |
logDir | taosc | Log file directory, operational logs will be written to this directory |
logKeepDays | taosc | Maximum retention period for log files in days |
rotationCount | taosc | Number of log file rotations before deletion |
rotationSize | taosc | Maximum size of a single log file |
compression | taosc | Enable WebSocket message compression |
adapterList | taosc | List of taosAdapter addresses for load balancing and failover |
connRetries | taosc | Maximum number of retries upon connection failure |
retryBackoffMs | taosc | Initial wait time in milliseconds after connection failure |
retryBackoffMaxMs | taosc | Maximum 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