配置参数

配置参数

为方便 IoTDB Server 的配置与管理，IoTDB Server 为用户提供三种配置项，使得用户可以在启动服务或服务运行时对其进行配置。

三种配置项的配置文件均位于 IoTDB 安装目录：$IOTDB_HOME/conf文件夹下，其中涉及 server 配置的共有 2 个文件，分别为：iotdb-env.sh, iotdb-engine.properties 。用户可以通过更改其中的配置项对系统运行的相关配置项进行配置。

配置文件的说明如下：

iotdb-env.sh：环境配置项的默认配置文件。用户可以在文件中配置 JAVA-JVM 的相关系统配置项。
iotdb-engine.properties：IoTDB 引擎层系统配置项的默认配置文件。用户可以在文件中配置 IoTDB 引擎运行时的相关参数，如 JDBC 服务监听端口 (rpc_port)、overflow 数据文件存储目录 (overflow_data_dir) 等。此外，用户可以在文件中配置 IoTDB 存储时 TsFile 文件的相关信息，如每次将内存中的数据写入到磁盘时的数据大小 (group_size_in_byte) ，内存中每个列打一次包的大小 (page_size_in_byte) 等。

热修改配置项

为方便用户使用，IoTDB Server 为用户提供了热修改功能，即在系统运行过程中修改iotdb-engine.properties中部分配置参数并即时应用到系统中。下面介绍的参数中，改后生效方式为触发生效 的均为支持热修改的配置参数。

触发方式：客户端发送load configuration命令至 IoTDB Server，客户端的使用方式详见 SQL 命令行终端（CLI） (opens new window)

环境配置项

环境配置项主要用于对 IoTDB Server 运行的 Java 环境相关参数进行配置，如 JVM 相关配置。IoTDB Server 启动时，此部分配置会被传给 JVM。用户可以通过查看 iotdb-env.sh （或iotdb-env.bat) 文件查看环境配置项内容。详细配置项说明如下：

JMX_LOCAL

名字	JMX_LOCAL
描述	JMX 监控模式，配置为 true 表示仅允许本地监控，设置为 false 的时候表示允许远程监控。如想在本地通过网络连接JMX Service，比如nodeTool.sh会尝试连接127.0.0.1:31999，请将JMX_LOCAL设置为false。
类型	枚举 String : “true”, “false”
默认值	true
改后生效方式	重启服务生效

JMX_PORT

名字	JMX_PORT
描述	JMX 监听端口。请确认该端口是不是系统保留端口并且未被占用。
类型	Short Int: [0,65535]
默认值	31999
改后生效方式	重启服务生效

MAX_HEAP_SIZE

名字	MAX_HEAP_SIZE
描述	IoTDB 启动时能使用的最大堆内存大小。
类型	String
默认值	取决于操作系统和机器配置。在 Linux 或 MacOS 系统下默认为机器内存的四分之一。在 Windows 系统下，32 位系统的默认值是 512M，64 位系统默认值是 2G。
改后生效方式	重启服务生效

HEAP_NEWSIZE

名字	HEAP_NEWSIZE
描述	IoTDB 启动时能使用的最小堆内存大小。
类型	String
默认值	取决于操作系统和机器配置。在 Linux 或 MacOS 系统下默认值为机器 CPU 核数乘以 100M 的值与 MAX_HEAP_SIZE 四分之一这二者的最小值。在 Windows 系统下，32 位系统的默认值是 512M，64 位系统默认值是 2G。
改后生效方式	重启服务生效

系统配置项

系统配置项是 IoTDB Server 运行的核心配置，它主要用于设置 IoTDB Server 文件层和引擎层的参数，便于用户根据自身需求调整 Server 的相关配置，以达到较好的性能表现。系统配置项可分为两大模块：文件层配置项和引擎层配置项。用户可以通过iotdb-engine.properties, 文件查看和修改两种配置项的内容。在 0.7.0 版本中字符串类型的配置项大小写敏感。

RPC配置

rpc_address

名字	rpc_address
描述	rpc地址
类型	String
默认值	0.0.0.0
改后生效方式	重启服务生效

rpc_port

名字	rpc_port
描述	jdbc 服务监听端口。请确认该端口不是系统保留端口并且未被占用。
类型	Short Int : [0,65535]
默认值	6667
改后生效方式	重启服务生效

rpc_thrift_compression_enable

名字	rpc_thrift_compression_enable
描述	是否启用 thrift 的压缩机制。
类型	Boolean
默认值	false
改后生效方式	重启服务生效

rpc_advanced_compression_enable

名字	rpc_advanced_compression_enable
描述	是否启用 thrift 的自定制压缩机制。
类型	Boolean
默认值	false
改后生效方式	重启服务生效

rpc_max_concurrent_client_num

名字	rpc_max_concurrent_client_num
描述	最大连接数。
类型	Short Int : [0,65535]
默认值	65535
改后生效方式	重启服务生效

thrift_max_frame_size

名字	thrift_max_frame_size
描述	RPC 请求/响应的最大字节数
类型	long
默认值	536870912 （默认值512MB，应大于等于 512 1024 1024)
改后生效方式	重启服务生效

thrift_init_buffer_size

名字	thrift_init_buffer_size
描述	字节数
类型	long
默认值	1024
改后生效方式	重启服务生效

InfluxDB 协议适配器配置

enable_influxdb_rpc_service

名字	enable_influxdb_rpc_service
描述	是否开启InfluxDB RPC service
类型	Boolean
默认值	true
改后生效方式	重启服务生效

influxdb_rpc_port

名字	influxdb_rpc_port
描述	influxdb rpc service占用端口
类型	INT32
默认值	8086
改后生效方式	重启服务生效

写前日志配置

enable_wal

名字	enable_wal
描述	是否开启写前日志，默认值为 true 表示开启，配置成 false 表示关闭
类型	Boolean
默认值	true
改后生效方式	触发生效

enable_discard_out_of_order_data

名字	enable_discard_out_of_order_data
描述	是否丢弃乱序数据，默认值为 false 表示关闭
类型	Boolean
默认值	false
改后生效方式	触发生效

flush_wal_threshold

名字	flush_wal_threshold
描述	写前日志的条数达到该值之后，持久化到磁盘，有可能丢失至多 flush_wal_threshold 个操作
类型	Int32
默认值	10000
改后生效方式	触发生效

force_wal_period_in_ms

名字	force_wal_period_in_ms
描述	写前日志定期持久化到磁盘的周期，单位毫秒，有可能丢失至多 force_wal_period_in_ms 毫秒的操作。
类型	Int32
默认值	100
改后生效方式	触发生效

目录配置

system_dir

名字	system_dir
描述	IoTDB 元数据存储路径，默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关，建议使用绝对路径。
类型	String
默认值	data/system（Windows：data\system）
改后生效方式	触发生效

data_dirs

名字	data_dirs
描述	IoTDB 数据存储路径，默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关，建议使用绝对路径。
类型	String
默认值	data/data（Windows：data\data）
改后生效方式	触发生效

multi_dir_strategy

名字	multi_dir_strategy
描述	IoTDB 在 tsfile_dir 中为 TsFile 选择目录时采用的策略。可使用简单类名或类名全称。系统提供以下三种策略： 1. SequenceStrategy：IoTDB 按顺序从 tsfile_dir 中选择目录，依次遍历 tsfile_dir 中的所有目录，并不断轮循； 2. MaxDiskUsableSpaceFirstStrategy：IoTDB 优先选择 tsfile_dir 中对应磁盘空余空间最大的目录； 3. MinFolderOccupiedSpaceFirstStrategy：IoTDB 优先选择 tsfile_dir 中已使用空间最小的目录； 4. UserDfineStrategyPackage（用户自定义策略）您可以通过以下方法完成用户自定义策略： 1. 继承 cn.edu.tsinghua.iotdb.conf.directories.strategy.DirectoryStrategy 类并实现自身的 Strategy 方法； 2. 将实现的类的完整类名（包名加类名，UserDfineStrategyPackage）填写到该配置项； 3. 将该类 jar 包添加到工程中。
类型	String
默认值	MaxDiskUsableSpaceFirstStrategy
改后生效方式	触发生效

wal_dir

名字	wal_dir
描述	IoTDB 写前日志存储路径，默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关，建议使用绝对路径。
类型	String
默认值	data/wal（Windows：data\wal）
改后生效方式	触发生效

tsfile_storage_fs

名字	tsfile_storage_fs
描述	Tsfile 和相关数据文件的存储文件系统。目前支持 LOCAL（本地文件系统）和 HDFS 两种
类型	String
默认值	LOCAL
改后生效方式	仅允许在第一次启动服务前修改

core_site_path

名字	core_site_path
描述	在 Tsfile 和相关数据文件存储到 HDFS 的情况下用于配置 core-site.xml 的绝对路径
类型	String
默认值	/etc/hadoop/conf/core-site.xml
改后生效方式	重启服务生效

hdfs_site_path

名字	hdfs_site_path
描述	在 Tsfile 和相关数据文件存储到 HDFS 的情况下用于配置 hdfs-site.xml 的绝对路径
类型	String
默认值	/etc/hadoop/conf/hdfs-site.xml
改后生效方式	重启服务生效

hdfs_ip

名字	hdfs_ip
描述	在 Tsfile 和相关数据文件存储到 HDFS 的情况下用于配置 HDFS 的 IP。如果配置了多于 1 个 hdfs_ip，则表明启用了 Hadoop HA
类型	String
默认值	localhost
改后生效方式	重启服务生效

hdfs_port

名字	hdfs_port
描述	在 Tsfile 和相关数据文件存储到 HDFS 的情况下用于配置 HDFS 的端口
类型	String
默认值	9000
改后生效方式	重启服务生效

dfs_nameservices

名字	hdfs_nameservices
描述	在使用 Hadoop HA 的情况下用于配置 HDFS 的 nameservices
类型	String
默认值	hdfsnamespace
改后生效方式	重启服务生效

dfs_ha_namenodes

名字	hdfs_ha_namenodes
描述	在使用 Hadoop HA 的情况下用于配置 HDFS 的 nameservices 下的 namenodes
类型	String
默认值	nn1,nn2
改后生效方式	重启服务生效

dfs_ha_automatic_failover_enabled

名字	dfs_ha_automatic_failover_enabled
描述	在使用 Hadoop HA 的情况下用于配置是否使用失败自动切换
类型	Boolean
默认值	true
改后生效方式	重启服务生效

dfs_client_failover_proxy_provider

名字	dfs_client_failover_proxy_provider
描述	在使用 Hadoop HA 且使用失败自动切换的情况下配置失败自动切换的实现方式
类型	String
默认值	org.apache.hadoop.hdfs.server.namenode.ha.ConfiguredFailoverProxyProvider
改后生效方式	重启服务生效

hdfs_use_kerberos

名字	hdfs_use_kerberos
描述	是否使用 kerberos 验证访问 hdfs
类型	String
默认值	false
改后生效方式	重启服务生效

kerberos_keytab_file_path

名字	kerberos_keytab_file_path
描述	kerberos keytab file 的完整路径
类型	String
默认值	/path
改后生效方式	重启服务生效

kerberos_principal

名字	kerberos_principal
描述	Kerberos 认证原则
类型	String
默认值	your principal
改后生效方式	重启服务生效

存储引擎配置

timestamp_precision

名字	timestamp_precision
描述	时间戳精度，支持 ms、us、ns
类型	String
默认值	ms
改后生效方式	触发生效

default_ttl

名字	default_ttl
描述	数据保留时间，会丢弃 now()-default_ttl 之前的数据，单位 ms
类型	long
默认值	36000000
改后生效方式	重启服务生效

wal_buffer_size

名字	wal_buffer_size
描述	写前日志的 buffer 大小
类型	Int32
默认值	16777216
改后生效方式	触发生效

seq_tsfile_size

名字	seq_tsfile_size
描述	每个顺序tsfile大小,单位：byte
类型	Int32
默认值	1
改后生效方式	重启服务生效

unseq_tsfile_size

名字	unseq_tsfile_size
描述	每个无序 tsfile 大小,单位：byte
类型	Int32
默认值	1
改后生效方式	重启服务生效

mlog_buffer_size

名字	mlog_buffer_size
描述	mlog 的 buffer 大小
类型	Int32
默认值	1048576
改后生效方式	触发生效

sync_mlog_period_in_ms

名字	sync_mlog_period_in_ms
描述	mlog定期刷新到磁盘的周期，单位毫秒。如果该参数为0，则表示每次对元数据的更新操作都会被立即写到磁盘上。
类型	Int64
默认值	100
改后生效方式	重启服务生效

memtable_size_threshold

名字	memtable_size_threshold
描述	内存缓冲区 memtable 阈值
类型	Long
默认值	1073741824
改后生效方式	enable_mem_control 为 false 时生效、重启服务生效

enable_timed_flush_seq_memtable

名字	enable_timed_flush_seq_memtable
描述	是否开启定时刷盘顺序 memtable
类型	Boolean
默认值	false
改后生效方式	触发生效

seq_memtable_flush_interval_in_ms

名字	seq_memtable_flush_interval_in_ms
描述	当 memTable 的创建时间小于当前时间减去该值时，该 memtable 需要被刷盘
类型	Int32
默认值	3600000
改后生效方式	触发生效

seq_memtable_flush_check_interval_in_ms

名字	seq_memtable_flush_check_interval_in_ms
描述	检查顺序 memtable 是否需要刷盘的时间间隔
类型	Int32
默认值	600000
改后生效方式	触发生效

enable_timed_flush_unseq_memtable

名字	enable_timed_flush_unseq_memtable
描述	是否开启定时刷新乱序 memtable
类型	Boolean
默认值	true
改后生效方式	触发生效

unseq_memtable_flush_interval_in_ms

名字	unseq_memtable_flush_interval_in_ms
描述	当 memTable 的创建时间小于当前时间减去该值时，该 memtable 需要被刷盘
类型	Int32
默认值	3600000
改后生效方式	触发生效

unseq_memtable_flush_check_interval_in_ms

名字	unseq_memtable_flush_check_interval_in_ms
描述	检查乱序 memtable 是否需要刷盘的时间间隔
类型	Int32
默认值	600000
改后生效方式	触发生效

enable_timed_close_tsfile

名字	enable_timed_close_tsfile
描述	是否开启定时关闭 tsfile
类型	Boolean
默认值	true
改后生效方式	触发生效

close_tsfile_interval_after_flushing_in_ms

名字	close_tsfile_interval_after_flushing_in_ms
描述	当 tsfile 的上一个 memtable 刷盘时间小于当前时间减去该值且当前工作 memtable 为空时，该 tsfile 需要被关闭
类型	Int32
默认值	3600000
改后生效方式	触发生效

close_tsfile_check_interval_in_ms

名字	close_tsfile_check_interval_in_ms
描述	检查 tsfile 是否需要关闭的时间间隔
类型	Int32
默认值	600000
改后生效方式	触发生效

avg_series_point_number_threshold

名字	avg_series_point_number_threshold
描述	内存中平均每个时间序列点数最大值，达到触发 flush
类型	Int32
默认值	10000
改后生效方式	重启服务生效

concurrent_flush_thread

名字	concurrent_flush_thread
描述	当 IoTDB 将内存中的数据写入磁盘时，最多启动多少个线程来执行该操作。如果该值小于等于 0，那么采用机器所安装的 CPU 核的数量。默认值为 0。
类型	Int32
默认值	0
改后生效方式	重启服务生效

concurrent_query_thread

名字	concurrent_query_thread
描述	当 IoTDB 对内存中的数据进行查询时，最多启动多少个线程来执行该操作。如果该值小于等于 0，那么采用机器所安装的 CPU 核的数量。默认值为 16。
类型	Int32
默认值	16
改后生效方式	重启服务生效

concurrent_sub_rawQuery_thread

名字	concurrent_sub_rawQuery_thread
描述	原始数据查询时，最多启动多少个线程来执行该操作。如果设置小于等于 0，会采用机器 CPU 核数。
类型	Int32
默认值	8
改后生效方式	重启服务生效

raw_query_blocking_queue_capacity

名字	raw_query_blocking_queue_capacity
描述	原始数据查询中，读任务的阻塞队列长度。默认值为 5。
类型	Int32
默认值	5
改后生效方式	重启服务生效

chunk_buffer_pool_enable

名字	chunk_buffer_pool_enable
描述	在将 memtable 序列化为内存中的字节时，是否开启由 IoTDB 而不是 JVM 接管内存管理，默认关闭。
类型	Boolean
默认值	false
改后生效方式	重启服务生效

batch_size

名字	batch_size
描述	服务器中每次迭代的数据量（数据条目，即不同时间戳的数量。）
类型	Int32
默认值	100000
改后生效方式	重启服务生效

tag_attribute_total_size

名字	tag_attribute_total_size
描述	每个时间序列标签和属性的最大持久化字节数
类型	Int32
默认值	700
改后生效方式	仅允许在第一次启动服务前修改

tag_attribute_flush_interval

名字	tag_attribute_flush_interval
描述	标签和属性记录的间隔数，达到此记录数量时将强制刷盘
类型	Int32
默认值	1000
改后生效方式	仅允许在第一次启动服务前修改

enable_partial_insert

名字	enable_partial_insert
描述	在一次 insert 请求中，如果部分测点写入失败，是否继续写入其他测点。
类型	Boolean
默认值	true
改后生效方式	重启服务生效

enable_mtree_snapshot

名字	enable_mtree_snapshot
描述	是否启用 MTree snapshot。从 0.11.0 开始默认为 false。
类型	Boolean
默认值	false
改后生效方式	重启服务生效

mtree_snapshot_interval

名字	mtree_snapshot_interval
描述	创建 MTree snapshot 时至少累积的 mlog 日志行数。单位为日志行数。
类型	Int32
默认值	100000
改后生效方式	重启服务生效

mtree_snapshot_threhold_time

名字	mtree_snapshot_threhold_time
描述	MTree 修改的阈值间隔时间，若最后一次修改时间小于这个阈值，则不会创建 MTree snapshot。单位：秒。默认值：1 小时（3600 秒）
类型	Int32
默认值	3600
改后生效方式	重启服务生效

内存控制配置

enable_mem_control

名字	enable_mem_control
描述	开启内存控制，避免爆内存
类型	Boolean
默认值	true
改后生效方式	重启服务生效

write_read_schema_free_memory_proportion

名字	write_read_schema_free_memory_proportion
描述	读写内存分配比率。参数形式为a : b : c : d，其中a、b、c、d为整数。如“1:1:1:1”、“6:2:1:1”，如果你的写入压力大而读取压力小，请调整为“6:1:1:2”
类型	String
默认值	4:3:1:2
改后生效方式	重启服务生效

primary_array_size

名字	primary_array_size
描述	数组池中的原始数组大小（每个数组的长度）
类型	Int32
默认值	32
改后生效方式	重启服务生效

flush_proportion

名字	flush_proportion
描述	调用flush disk的写入内存比例，默认0.4,若有极高的写入负载力（比如batch=1000），可以设置为低于默认值，比如0.2
类型	Double
默认值	0.4
改后生效方式	重启服务生效

time_index_memory_proportion

名字	time_index_memory_proportion
描述	分配给读 timeIndex 的内存占比
类型	Double
默认值	0.2
改后生效方式	重启服务生效

buffered_arrays_memory_proportion

名字	buffered_arrays_memory_proportion
描述	为缓冲数组分配的写入内存比例，默认为0.6
类型	Double
默认值	0.6
改后生效方式	重启服务生效

reject_proportion

名字	reject_proportion
描述	拒绝插入的写入内存比例，默认0.8，若有极高的写入负载力（比如batch=1000）并且物理内存足够大，它可以设置为高于默认值，如0.9
类型	Double
默认值	0.8
改后生效方式	重启服务生效

storage_group_report_threshold

名字	storage_group_report_threshold
描述	如果存储组的内存（以字节byte为单位）增加超过此阈值，则向系统报告。默认值为16MB
类型	Int32
默认值	16777216
改后生效方式	重启服务生效

max_deduplicated_path_num

名字	max_deduplicated_path_num
描述	在一次查询中，允许最大重复路径的数据量，这只是一个建议值，实际限制是这个默认值和计算值的之间
类型	Int32
默认值	1000
改后生效方式	重启服务生效

check_period_when_insert_blocked

名字	check_period_when_insert_blocked
描述	当插入被拒绝时，等待时间（以毫秒为单位）去再次检查系统，默认为50。若插入被拒绝，读取负载低，可以设置大一些。
类型	Int32
默认值	50
改后生效方式	重启服务生效

max_waiting_time_when_insert_blocked

名字	max_waiting_time_when_insert_blocked
描述	当插入的等待时间（以毫秒为单位）超过此值时，抛出异常。默认为10000。若插入被拒绝，读取负载低，可以设置大一些。
类型	Int32
默认值	10000
改后生效方式	重启服务生效

estimated_series_size

名字	estimated_series_size
描述	在Mtree中一个时间序列的评估元数据大小（以字节byte为单位）。
类型	Int32
默认值	300
改后生效方式	重启服务生效

io_task_queue_size_for_flushing

名字	io_task_queue_size_for_flushing
描述	ioTaskQueue 的大小。默认值为10。
类型	Int32
默认值	10
改后生效方式	重启服务生效

升级配置

update_thread_num

名字	update_thread_num
描述	当存在旧版本（V0.9.x/v1）数据时，会设置多少线程来执行升级任务，默认为1。版本小于等于V0.X时设置为1。
类型	Int32
默认值	1
改后生效方式	重启服务生效

查询配置

default_fill_interval

名字	default_fill_interval
描述	填充查询中使用的默认时间段，默认-1表示无限过去时间，以毫秒ms为单位
类型	Int32
默认值	-1
改后生效方式	重启服务生效

group_by_fill_cache_size_in_mb

名字	group_by_fill_cache_size_in_mb
描述	填充查询中使用的缓存大小，单位是MB
类型	Float
默认值	1.0
改后生效方式	重启服务生效

合并配置

enable_seq_space_compaction

名字	enable_seq_space_compaction
描述	顺序空间内合并，开启顺序文件之间的合并
类型	Boolean
默认值	true
改后生效方式	重启服务生效

enable_unseq_space_compaction

名字	enable_unseq_space_compaction
描述	乱序空间内合并，开启乱序文件之间的合并
类型	Boolean
默认值	false
改后生效方式	重启服务生效

enable_cross_space_compaction

名字	enable_cross_space_compaction
描述	跨空间合并，开启将乱序文件合并到顺序文件中
类型	Boolean
默认值	true
改后生效方式	重启服务生效

cross_compaction_strategy

名字	cross_compaction_strategy
描述	跨空间合并的策略
类型	String
默认值	rewrite_compaction
改后生效方式	重启服务生效

inner_compaction_strategy

名字	cross_compaction_strategy
描述	空间内合并的策略
类型	String
默认值	size_tiered_compaction
改后生效方式	重启服务生效

compaction_priority

名字	compaction_priority
描述	合并时的优先级，BALANCE 各种合并平等，INNER_CROSS 优先进行顺序文件和顺序文件或乱序文件和乱序文件的合并，CROSS_INNER 优先将乱序文件合并到顺序文件中
类型	String
默认值	BALANCE
改后生效方式	重启服务生效

target_compaction_file_size

名字	target_compaction_file_size
描述	空间内合并的目标文件大小
类型	Int64
默认值	1073741824
改后生效方式	重启服务生效

target_chunk_size

名字	target_chunk_size
描述	合并时 Chunk 的目标大小
类型	Int64
默认值	1048576
改后生效方式	重启服务生效

target_chunk_point_num

名字	target_chunk_point_num
描述	合并时 Chunk 的目标点数
类型	Int32
默认值	100000
改后生效方式	重启服务生效

chunk_size_lower_bound_in_compaction

名字	chunk_size_lower_bound_in_compaction
描述	合并时源 Chunk 的大小小于这个值，将被解开成点进行合并
类型	Int64
默认值	128
改后生效方式	重启服务生效

chunk_point_num_lower_bound_in_compaction

名字	chunk_point_num_lower_bound_in_compaction
描述	合并时源 Chunk 的点数小于这个值，将被解开成点进行合并
类型	Int32
默认值	100
改后生效方式	重启服务生效

max_inner_compaction_candidate_file_num

名字	max_inner_compaction_candidate_file_num
描述	空间内合并中一次合并最多参与的文件数
类型	Int32
默认值	30
改后生效方式	重启服务生效

max_cross_compaction_candidate_file_num

名字	max_cross_compaction_candidate_file_num
描述	跨空间合并中一次合并最多参与的文件数
类型	Int32
默认值	1000
改后生效方式	重启服务生效

cross_compaction_file_selection_time_budget

名字	cross_compaction_file_selection_time_budget
描述	若一个合并文件选择运行的时间超过这个时间，它将结束，并且当前的文件合并选择将用作为最终选择。当时间小于0 时，则表示时间是无边界的。单位：ms。
类型	Int32
默认值	30000
改后生效方式	重启服务生效

cross_compaction_memory_budget

名字	cross_compaction_memory_budget
描述	一个合并任务可以使用多少内存（以字节为单位），默认为最大JVM内存的10%。这只是一个粗略的估计，从一个比较小的值开始，避免OOM。每个新的合并线程可能会占用这样的内存，所以merge_thread_num * merge_memory_budget是合并的预估总内存。
类型	Int32
默认值	2147483648
改后生效方式	重启服务生效

concurrent_compaction_thread

名字	concurrent_compaction_thread
描述	执行合并任务的线程数目
类型	Int32
默认值	10
改后生效方式	重启服务生效

compaction_schedule_interval_in_ms

名字	compaction_schedule_interval_in_ms
描述	合并调度的时间间隔
类型	Int64
默认值	60000
改后生效方式	重启服务生效

compaction_submission_interval_in_ms

名字	compaction_submission_interval_in_ms
描述	合并任务提交的间隔
类型	Int64
默认值	60000
改后生效方式	重启服务生效

compaction_write_throughput_mb_per_sec

名字	compaction_write_throughput_mb_per_sec
描述	每秒可达到的写入吞吐量合并限制。
类型	Int32
默认值	16
改后生效方式	重启服务生效

插入配置

insert_multi_tablet_enable_multithreading_column_threshold

名字	insert_multi_tablet_enable_multithreading_column_threshold
描述	插入时启用多线程插入列数的阈值
类型	Int32
默认值	10
改后生效方式	重启服务生效

query_timeout_threshold

名字	query_timeout_threshold
描述	查询的最大执行时间。单位：毫秒。
类型	Int32
默认值	60000
改后生效方式	重启服务生效

元数据缓存配置

meta_data_cache_enable

名字	meta_data_cache_enable
描述	是否缓存元数据Chunk Metadata 和 TimeSeries Metadata）。
类型	Boolean
默认值	true
改后生效方式	重启服务生效

chunk_timeseriesmeta_free_memory_proportion

名字	chunk_timeseriesmeta_free_memory_proportion
描述	读取内存分配比例，BloomFilterCache、ChunkCache、TimeseriesMetadataCache、数据集查询的内存和可用内存的查询。参数形式为a : b : c : d : e，其中a、b、c、d、e为整数。例如“1 : 1 : 1 : 1 : 1” ，“1 : 100 : 200 : 300 : 400” 。
类型	String
默认值	1 : 100 : 200 : 300 : 400
改后生效方式	重启服务生效

metadata_node_cache_size

名字	metadata_node_cache_size
描述	Manager的缓存大小。所有路径检查和将具有相应路径的MManager中的TSDataType的缓存，都将被用作提高写入速度。
类型	Int32
默认值	300000
改后生效方式	重启服务生效

统计监控器配置

enable_stat_monitor

名字	enable_stat_monitor
描述	选择是否启动后台统计功能
类型	Boolean
默认值	false
改后生效方式	重启服务生效

enable_monitor_series_write

名字	enable_monitor_series_write
描述	是否开启写入服务监控的时间序列
类型	Boolean
默认值	false
改后生效方式	重启服务生效

WAL 直接缓冲池配置

wal_pool_trim_interval_ms

名字	wal_pool_trim_interval_ms
描述	缩短日志池间隔时间，单位：毫秒ms
类型	Int32
默认值	10000
改后生效方式	重启服务生效

max_wal_bytebuffer_num_for_each_partition

名字	max_wal_bytebuffer_num_for_each_partition
描述	每个时间分区可以分配的最大日志字节缓冲区数，如果没有乱序数据可以设置为4。应该是偶数
类型	Int32
默认值	6
改后生效方式	重启服务生效

外部排序配置

enable_external_sort

名字	enable_external_sort
描述	是否开启外部排序功能
类型	Boolean
默认值	true
改后生效方式	重启服务生效

external_sort_threshold

名字	external_sort_threshold
描述	单个时间序列的最大同时块读取数。若同时chunk读取的数量大于external_sort_threshold，则使用外部排序。当external_sort_threshold增加时，内存中同时排序的chunk数量可能会增加，这会占用更多的内存；external_sort_threshold 减小时，触发外部排序会增加耗时。
类型	Int32
默认值	1000
改后生效方式	重启服务生效

同步服务器配置

is_sync_enable

名字	is_sync_enable
描述	是否开启同步服务功能
类型	Boolean
默认值	false
改后生效方式	重启服务生效

sync_server_port

名字	sync_server_port
描述	同步服务器端口进行监听
类型	Int32
默认值	5555
改后生效方式	重启服务生效

ip_white_list

名字	ip_white_list
描述	同步客户端的白名单。请用网段形式表示IP范围，例如：192.168.0.0/16，若有多个IP段，请用逗号隔开，默认是允许所有IP同步
类型	String
默认值	0.0.0.0/0
改后生效方式	重启服务生效

性能统计配置

enable_performance_stat

名字	enable_performance_stat
描述	是否启用子模块的性能状态
类型	Boolean
默认值	true
改后生效方式	重启服务生效

tracing_dir

名字	tracing_dir
描述	取消注释用以下字段来配置 tracing 根目录。
类型	String
默认值	data/tracing(Windows:data\tracing)
改后生效方式	重启服务生效

水印模块配置

watermark_module_opened

名字	watermark_module_opened
描述	是否开启水印水印嵌入功能
取值	true or false
默认值	false
改后生效方式	重启服务生效

watermark_secret_key

名字	watermark_secret_key
描述	水印嵌入功能秘钥
类型	String
默认值	IoTDB * 2019@Beijing
改后生效方式	重启服务生效

watermark_bit_string

名字	watermark_bit_string
描述	水印比特字符串
类型	Int32
默认值	100101110100
改后生效方式	重启服务生效

watermark_method

名字	watermark_method
描述	水印嵌入方法
类型	String
默认值	GroupBasedLSBMethod(embed_row_cycle=2,embed_lsb_num=5)
改后生效方式	重启服务生效

数据类型自动推断

enable_auto_create_schema

名字	enable_auto_create_schema
描述	当写入的序列不存在时，是否自动创建序列
取值	true or false
默认值	true
改后生效方式	重启服务生效

default_storage_group_level

名字	default_storage_group_level
描述	当写入的数据不存在且自动创建序列时，若需要创建相应的存储组，将序列路径的哪一层当做存储组。例如，如果我们接到一个新序列 root.sg0.d1.s2, 并且 level=1，那么 root.sg0 被视为存储组（因为 root 是 level 0 层）
取值	Int32
默认值	1
改后生效方式	重启服务生效

boolean_string_infer_type

名字	boolean_string_infer_type
描述	“true” 或者 “false” 字符串被推断的数据类型
取值	BOOLEAN 或者 TEXT
默认值	BOOLEAN
改后生效方式	重启服务生效

integer_string_infer_type

名字	integer_string_infer_type
描述	整型字符串推断的数据类型
取值	INT32, INT64, FLOAT, DOUBLE, TEXT
默认值	FLOAT
改后生效方式	重启服务生效

long_string_infer_type

名字	long_string_infer_type
描述	大于 2 ^ 24 的整形字符串被推断的数据类型
取值	DOUBLE, FLOAT or TEXT
默认值	DOUBLE
改后生效方式	重启服务生效

floating_string_infer_type

名字	floating_string_infer_type
描述	“6.7”等字符串被推断的数据类型
取值	DOUBLE, FLOAT or TEXT
默认值	FLOAT
改后生效方式	重启服务生效

nan_string_infer_type

名字	nan_string_infer_type
描述	“NaN” 字符串被推断的数据类型
取值	DOUBLE, FLOAT or TEXT
默认值	DOUBLE
改后生效方式	重启服务生效

default_boolean_encoding

名字	default_boolean_encoding
描述	BOOLEAN 类型编码格式
取值	PLAIN, RLE
默认值	RLE
改后生效方式	重启服务生效

default_int32_encoding

名字	default_int32_encoding
描述	int32 类型编码格式
取值	PLAIN, RLE, TS_2DIFF, REGULAR, GORILLA
默认值	RLE
改后生效方式	重启服务生效

default_int64_encoding

名字	default_int64_encoding
描述	int64 类型编码格式
取值	PLAIN, RLE, TS_2DIFF, REGULAR, GORILLA
默认值	RLE
改后生效方式	重启服务生效

default_float_encoding

名字	default_float_encoding
描述	float 类型编码格式
取值	PLAIN, RLE, TS_2DIFF, GORILLA
默认值	GORILLA
改后生效方式	重启服务生效

default_double_encoding

名字	default_double_encoding
描述	double 类型编码格式
取值	PLAIN, RLE, TS_2DIFF, GORILLA
默认值	GORILLA
改后生效方式	重启服务生效

default_text_encoding

名字	default_text_encoding
描述	text 类型编码格式
取值	PLAIN
默认值	PLAIN
改后生效方式	重启服务生效

文件层配置

group_size_in_byte

名字	group_size_in_byte
描述	每次将内存中的数据写入到磁盘时的最大写入字节数
类型	Int32
默认值	134217728
改后生效方式	触发生效

page_size_in_byte

名字	page_size_in_byte
描述	内存中每个列写出时，写成的单页最大的大小，单位为字节
类型	Int32
默认值	65536
改后生效方式	触发生效

max_number_of_points_in_page

名字	max_number_of_points_in_page
描述	一个页中最多包含的数据点（时间戳-值的二元组）数量
类型	Int32
默认值	1048576
改后生效方式	触发生效

max_string_length

名字	max_string_length
描述	针对字符串类型的数据，单个字符串最大长度，单位为字符
类型	Int32
默认值	128
改后生效方式	触发生效

float_precision

名字	float_precision
描述	浮点数精度，为小数点后数字的位数
类型	Int32
默认值	默认为 2 位。注意：32 位浮点数的十进制精度为 7 位，64 位浮点数的十进制精度为 15 位。如果设置超过机器精度将没有实际意义。
改后生效方式	触发生效

time_encoder

名字	time_encoder
描述	时间列编码方式
类型	枚举 String: “TS_2DIFF”,“PLAIN”,“RLE”
默认值	TS_2DIFF
改后生效方式	触发生效

value_encoder

名字	value_encoder
描述	value 列编码方式
类型	枚举 String: “TS_2DIFF”,“PLAIN”,“RLE”
默认值	PLAIN
改后生效方式	触发生效

compressor

名字	compressor
描述	数据压缩方法
类型	枚举 String : “UNCOMPRESSED”, “SNAPPY”, “LZ4”
默认值	SNAPPY
改后生效方式	触发生效

max_degree_of_index_node

名字	max_degree_of_index_node
描述	元数据索引树的最大度（即每个节点的最大子节点个数）。
类型	Int32
默认值	256
改后生效方式	仅允许在第一次启动服务前修改

frequency_interval_in_minute

名字	frequency_interval_in_minute
描述	计算查询频率的时间间隔（以分钟为单位）。
类型	Int32
默认值	1
改后生效方式	触发生效

slow_query_threshold

名字	slow_query_threshold
描述	慢查询的时间成本（毫秒ms）阈值。
类型	Int32
默认值	5000
改后生效方式	触发生效

MQTT代理配置

enable_mqtt_service

名字	enable_mqtt_service。
描述	是否开启MQTT服务
类型	Boolean
默认值	false
改后生效方式	触发生效

mqtt_host

名字	mqtt_host
描述	MQTT服务绑定的host。
类型	String
默认值	0.0.0.0
改后生效方式	触发生效

mqtt_port

名字	mqtt_port
描述	MQTT服务绑定的port。
类型	Int32
默认值	1883
改后生效方式	触发生效

mqtt_handler_pool_size

名字	mqtt_handler_pool_size
描述	用于处理MQTT消息的处理程序池大小。
类型	Int32
默认值	1
改后生效方式	触发生效

mqtt_payload_formatter

名字	mqtt_payload_formatter
描述	MQTT消息有效负载格式化程序。
类型	String
默认值	json
改后生效方式	触发生效

mqtt_max_message_size

名字	mqtt_max_message_size
描述	MQTT消息的最大长度（以字节为单位）。
类型	Int32
默认值	1048576
改后生效方式	触发生效

授权配置

authorizer_provider_class

名字	authorizer_provider_class
描述	权限服务的类名
类型	String
默认值	org.apache.iotdb.db.auth.authorizer.LocalFileAuthorizer
改后生效方式	重启服务生效
其他可选值	org.apache.iotdb.db.auth.authorizer.OpenIdAuthorizer

openID_url

名字	openID_url
描述	openID 服务器地址（当 OpenIdAuthorizer 被启用时必须设定）
类型	String（一个 http 地址）
默认值	无
改后生效方式	重启服务生效

UDF查询配置

udf_initial_byte_array_length_for_memory_control

名字	udf_initial_byte_array_length_for_memory_control
描述	用于评估UDF查询中文本字段的内存使用情况。建议将此值设置为略大于所有文本的平均长度记录。
类型	Int32
默认值	48
改后生效方式	重启服务生效

udf_memory_budget_in_mb

名字	udf_memory_budget_in_mb
描述	在一个UDF查询中使用多少内存（以 MB 为单位）。上限为已分配内存的 20% 用于读取。
类型	Float
默认值	30.0
改后生效方式	重启服务生效

udf_reader_transformer_collector_memory_proportion

名字	udf_reader_transformer_collector_memory_proportion
描述	UDF内存分配比例。参数形式为a : b : c，其中a、b、c为整数。
类型	String
默认值	1:1:1
改后生效方式	重启服务生效

udf_root_dir

名字	udf_root_dir
描述	取消注释用以下字段来配置udf根目录。
类型	String
默认值	ext/udf(Windows:ext\udf)
改后生效方式	重启服务生效

索引配置

index_root_dir

名字	index_root_dir
描述	取消注释用以下字段来配置索引根目录。
类型	String
默认值	data/index(Windows:data\index)
改后生效方式	重启服务生效

enable_index

名字	enable_index
描述	是否启用索引。
类型	Boolean
默认值	false
改后生效方式	重启服务生效

concurrent_index_build_thread

名字	concurrent_index_build_thread
描述	有多少线程可以同时构建索引。当<=0时，使用CPU内核数。
类型	Int32
默认值	0
改后生效方式	重启服务生效

default_index_window_range

名字	default_index_window_range
描述	索引框架中用于子序列匹配的滑动窗口的默认大小。
类型	Int32
默认值	10
改后生效方式	重启服务生效

index_buffer_size

名字	index_buffer_size
描述	索引处理器的缓冲区参数。
类型	Int32
默认值	134217728
改后生效方式	重启服务生效

enable_partition

名字	enable_partition
描述	是否开启将数据按时间分区存储的功能，如果关闭，所有数据都属于分区 0 (不建议开启此功能。如果打开，请计算合适的 concurrent_writing_time_partition 和 wal_buffer_size)
类型	Boolean
默认值	false
改后生效方式	仅允许在第一次启动服务前修改

partition_interval

名字	partition_interval
描述	用于存储组分区的时间段长度，用户指定的存储组下会使用该时间段进行分区，单位：秒
类型	Int64
默认值	604800
改后生效方式	仅允许在第一次启动服务前修改

virtual_storage_group_num

名字	virtual_storage_group_num
描述	每一个用户定义存储组下虚拟存储组的数量, 虚拟存储组是内存中写入的并行单位，每一个虚拟存储组内的写入请求是串行的，推荐值为： [virtual storage group number] = [CPU core number] / [user-defined storage group number]
类型	INT32
默认值	1
改后生效方式	仅允许在第一次启动服务前修改

concurrent_writing_time_partition

名字	concurrent_writing_time_partition
描述	最大可同时写入的时间分区个数，默认500个分区
类型	Int64
默认值	500
改后生效方式	重启服务生效

admin_name

名字	admin_name
描述	管理员用户名，默认为root
类型	String
默认值	root
改后生效方式	仅允许在第一次启动服务前修改

admin_password

名字	admin_password
描述	管理员密码，默认为root
类型	String
默认值	root
改后生效方式	仅允许在第一次启动服务前修改

SELECT-INTO配置

select_into_insert_tablet_plan_row_limit

名字	select_into_insert_tablet_plan_row_limit
描述	执行 select-into 语句时，一个 insert-tablet-plan 中可以处理的最大行数
类型	Int32
默认值	10000
改后生效方式	触发生效

触发器配置

concurrent_window_evaluation_thread

名字	concurrent_window_evaluation_thread
描述	窗口计算线程池的默认线程数
类型	Int32
默认值	CPU核数
改后生效方式	重启服务生效

max_pending_window_evaluation_tasks

名字	max_pending_window_evaluation_tasks
描述	最多允许堆积的窗口计算任务
类型	Int32
默认值	64
改后生效方式	重启服务生效

连续查询配置

continuous_query_execution_thread

名字	continuous_query_execution_thread
描述	执行连续查询任务的线程池的线程数
类型	Int32
默认值	max(1, CPU 核数 / 2)
改后生效方式	重启服务生效

max_pending_continuous_query_tasks

名字	max_pending_continuous_query_tasks
描述	队列中连续查询最大任务堆积数
类型	Int32
默认值	64
改后生效方式	重启服务生效

continuous_query_min_every_interval

名字	continuous_query_min_every_interval
描述	连续查询执行时间间隔的最小值
类型	duration
默认值	1s
改后生效方式	重启服务生效

开启 GC 日志

GC 日志默认是关闭的。为了性能调优，用户可能会需要收集 GC 信息。若要打开 GC 日志，则需要在启动 IoTDB Server 的时候加上”printgc”参数：

nohup sbin/start-server.sh printgc >/dev/null 2>&1 &

或者

sbin\start-server.bat printgc

GC 日志会被存储在IOTDB_HOME/logs/gc.log. 至多会存储 10 个 gc.log 文件，每个文件最多 10MB。

名字	enable_last_cache
描述	是否开启最新点缓存
类型	Boolean
默认值	true
改后生效方式	重启服务生效

配置参数

配置参数

热修改配置项

环境配置项

系统配置项

RPC配置

InfluxDB 协议适配器配置

写前日志配置

目录配置

存储引擎配置

内存控制配置

升级配置

查询配置

合并配置

插入配置

元数据缓存配置

最新点缓存配置

统计监控器配置

WAL 直接缓冲池配置

外部排序配置

同步服务器配置

性能统计配置

水印模块配置

数据类型自动推断

文件层配置

MQTT代理配置

授权配置

UDF查询配置

索引配置

SELECT-INTO配置

触发器配置

连续查询配置

开启 GC 日志