跳至主要內容

参考

大约 35 分钟

参考

配置参数

为方便 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)open in 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
默认值100000
改后生效方式重启服务生效
  • concurrent_flush_thread
名字concurrent_flush_thread
描述当 IoTDB 将内存中的数据写入磁盘时,最多启动多少个线程来执行该操作。如果该值小于等于 0,那么采用机器所安装的 CPU 核的数量。默认值为 0。
类型Int32
默认值0
改后生效方式重启服务生效
  • concurrent_query_thread
名字concurrent_query_thread
描述当 IoTDB 对内存中的数据进行查询时,最多启动多少个线程来执行该操作。如果该值小于等于 0,那么采用机器所安装的 CPU 核的数量。默认值为 16。
类型Int32
默认值0
改后生效方式重启服务生效
  • concurrent_sub_rawQuery_thread
名字concurrent_sub_rawQuery_thread
描述原始数据查询时,最多启动多少个线程来执行该操作。如果设置小于等于 0,会采用机器 CPU 核数。
类型Int32
默认值0
改后生效方式重启服务生效
  • 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
改后生效方式重启服务生效
  • schema_query_fetch_size
名字schema_query_fetch_size
描述默认的一次元数据查询返回的最大条目数,例如show timeseries。
类型Int32
默认值10000000
改后生效方式重启服务生效

升级配置

  • 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_last_stat
名字enable_last_cache
描述是否开启最新点缓存
类型Boolean
默认值true
改后生效方式重启服务生效

统计监控器配置

  • 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。

Copyright © 2024 The Apache Software Foundation.
Apache and the Apache feather logo are trademarks of The Apache Software Foundation

Have a question? Connect with us on QQ, WeChat, or Slack. Join the community now.

We use Google Analytics to collect anonymous, aggregated usage information.