IoTDB DataNode 与 Standalone 模式共用一套配置文件,均位于 IoTDB 安装目录:conf
文件夹下。
为方便用户使用,IoTDB 为用户提供了热修改功能,即在系统运行过程中修改 iotdb-datanode.properties
中部分配置参数并即时应用到系统中。下面介绍的参数中,改后 生效方式为热加载
的均为支持热修改的配置参数。
通过 Session 或 Cli 发送 load configuration
或 set configuration
命令(SQL)至 IoTDB 可触发配置热加载。
环境配置项主要用于对 DataNode 运行的 Java 环境相关参数进行配置,如 JVM 相关配置。DataNode/Standalone 启动时,此部分配置会被传给 JVM,详细配置项说明如下:
名字 | MEMORY_SIZE |
---|
描述 | IoTDB DataNode 启动时分配的内存大小 |
类型 | String |
默认值 | 取决于操作系统和机器配置。默认为机器内存的二分之一。 |
改后生效方式 | 重启服务生效 |
名字 | ON_HEAP_MEMORY |
---|
描述 | IoTDB DataNode 能使用的堆内内存大小, 曾用名: MAX_HEAP_SIZE |
类型 | String |
默认值 | 取决于MEMORY_SIZE的配置。 |
改后生效方式 | 重启服务生效 |
名字 | OFF_HEAP_MEMORY |
---|
描述 | IoTDB DataNode 能使用的堆外内存大小, 曾用名: MAX_DIRECT_MEMORY_SIZE |
类型 | String |
默认值 | 取决于MEMORY_SIZE的配置 |
改后生效方式 | 重启服务生效 |
名字 | JMX_LOCAL |
---|
描述 | JMX 监控模式,配置为 true 表示仅允许本地监控,设置为 false 的时候表示允许远程监控。如想在本地通过网络连接JMX Service,比如nodeTool.sh会尝试连接127.0.0.1:31999,请将JMX_LOCAL设置为false。 |
类型 | 枚举 String : “true”, “false” |
默认值 | true |
改后生效方式 | 重启服务生效 |
名字 | JMX_PORT |
---|
描述 | JMX 监听端口。请确认该端口是不是系统保留端口并且未被占用。 |
类型 | Short Int: [0,65535] |
默认值 | 31999 |
改后生效方式 | 重启服务生效 |
系统配置项是 IoTDB DataNode/Standalone 运行的核心配置,它主要用于设置 DataNode/Standalone 数据库引擎的参数。
名字 | dn_rpc_address |
---|
描述 | 客户端 RPC 服务监听地址 |
类型 | String |
默认值 | 0.0.0.0 |
改后生效方式 | 重启服务生效 |
名字 | dn_rpc_port |
---|
描述 | Client RPC 服务监听端口 |
类型 | Short Int : [0,65535] |
默认值 | 6667 |
改后生效方式 | 重启服务生效 |
名字 | dn_internal_address |
---|
描述 | DataNode 内网通信地址 |
类型 | string |
默认值 | 127.0.0.1 |
改后生效方式 | 仅允许在第一次启动服务前修改 |
名字 | dn_internal_port |
---|
描述 | DataNode 内网通信端口 |
类型 | int |
默认值 | 10730 |
改后生效方式 | 仅允许在第一次启动服务前修改 |
- dn_mpp_data_exchange_port
名字 | dn_mpp_data_exchange_port |
---|
描述 | MPP 数据交换端口 |
类型 | int |
默认值 | 10740 |
改后生效方式 | 仅允许在第一次启动服务前修改 |
- dn_schema_region_consensus_port
名字 | dn_schema_region_consensus_port |
---|
描述 | DataNode 元数据副本的共识协议通信端口 |
类型 | int |
默认值 | 10750 |
改后生效方式 | 仅允许在第一次启动服务前修改 |
- dn_data_region_consensus_port
名字 | dn_data_region_consensus_port |
---|
描述 | DataNode 数据副本的共识协议通信端口 |
类型 | int |
默认值 | 10760 |
改后生效方式 | 仅允许在第一次启动服务前修改 |
- dn_join_cluster_retry_interval_ms
名字 | dn_join_cluster_retry_interval_ms |
---|
描述 | DataNode 再次重试加入集群等待时间 |
类型 | long |
默认值 | 5000 |
改后生效方式 | 重启服务生效 |
名字 | enable_thrift_ssl |
---|
描述 | 当enable_thrift_ssl配置为true时,将通过dn_rpc_port使用 SSL 加密进行通信 |
类型 | Boolean |
默认值 | false |
改后生效方式 | 重启服务生效 |
名字 | enable_https |
---|
描述 | REST Service 是否开启 SSL 配置 |
类型 | Boolean |
默认值 | false |
改后生效方式 | 重启生效 |
名字 | key_store_path |
---|
描述 | ssl证书路径 |
类型 | String |
默认值 | "" |
改后生效方式 | 重启服务生效 |
名字 | key_store_pwd |
---|
描述 | ssl证书密码 |
类型 | String |
默认值 | "" |
改后生效方式 | 重启服务生效 |
名字 | dn_seed_config_node |
---|
描述 | ConfigNode 地址,DataNode 启动时通过此地址加入集群 |
类型 | String |
默认值 | 127.0.0.1:10710 |
改后生效方式 | 仅允许在第一次启动服务前修改 |
- dn_session_timeout_threshold
名字 | dn_session_timeout_threshold |
---|
描述 | 最大的会话空闲时间 |
类型 | int |
默认值 | 0 |
改后生效方式 | 重启服务生效 |
- dn_rpc_thrift_compression_enable
名字 | dn_rpc_thrift_compression_enable |
---|
描述 | 是否启用 thrift 的压缩机制 |
类型 | Boolean |
默认值 | false |
改后生效方式 | 重启服务生效 |
- dn_rpc_advanced_compression_enable
名字 | dn_rpc_advanced_compression_enable |
---|
描述 | 是否启用 thrift 的自定制压缩机制 |
类型 | Boolean |
默认值 | false |
改后生效方式 | 重启服务生效 |
- dn_rpc_selector_thread_count
名字 | rpc_selector_thread_count |
---|
描述 | rpc 选择器线程数量 |
类型 | int |
默认值 | 1 |
改后生效方式 | 重启服务生效 |
- dn_rpc_min_concurrent_client_num
名字 | rpc_min_concurrent_client_num |
---|
描述 | 最小连接数 |
类型 | Short Int : [0,65535] |
默认值 | 1 |
改后生效方式 | 重启服务生效 |
- dn_rpc_max_concurrent_client_num
名字 | dn_rpc_max_concurrent_client_num |
---|
描述 | 最大连接数 |
类型 | Short Int : [0,65535] |
默认值 | 65535 |
改后生效方式 | 重启服务生效 |
名字 | dn_thrift_max_frame_size |
---|
描述 | RPC 请求/响应的最大字节数 |
类型 | long |
默认值 | 536870912 (默认值512MB,应大于等于 512 * 1024 * 1024) |
改后生效方式 | 重启服务生效 |
- dn_thrift_init_buffer_size
名字 | dn_thrift_init_buffer_size |
---|
描述 | 字节数 |
类型 | long |
默认值 | 1024 |
改后生效方式 | 重启服务生效 |
名字 | dn_connection_timeout_ms |
---|
描述 | 节点连接超时时间 |
类型 | int |
默认值 | 60000 |
改后生效方式 | 重启服务生效 |
- dn_core_client_count_for_each_node_in_client_manager
名字 | dn_core_client_count_for_each_node_in_client_manager |
---|
描述 | 单 ClientManager 中路由到每个节点的核心 Client 个数 |
类型 | int |
默认值 | 200 |
改后生效方式 | 重启服务生效 |
- dn_max_client_count_for_each_node_in_client_manager
名字 | dn_max_client_count_for_each_node_in_client_manager |
---|
描述 | 单 ClientManager 中路由到每个节点的最大 Client 个数 |
类型 | int |
默认值 | 300 |
改后生效方式 | 重启服务生效 |
名字 | dn_system_dir |
---|
描述 | IoTDB 元数据存储路径,默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关,建议使用绝对路径。 |
类型 | String |
默认值 | data/datanode/system(Windows:data\datanode\system) |
改后生效方式 | 重启服务生效 |
名字 | dn_data_dirs |
---|
描述 | IoTDB 数据存储路径,默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关,建议使用绝对路径。 |
类型 | String |
默认值 | data/datanode/data(Windows:data\datanode\data) |
改后生效方式 | 重启服务生效 |
名字 | dn_multi_dir_strategy |
---|
描述 | IoTDB 在 data_dirs 中为 TsFile 选择目录时采用的策略。可使用简单类名或类名全称。系统提供以下三种策略: 1. SequenceStrategy:IoTDB 按顺序选择目录,依次遍历 data_dirs 中的所有目录,并不断轮循; 2. MaxDiskUsableSpaceFirstStrategy:IoTDB 优先选择 data_dirs 中对应磁盘空余空间最大的目录; 您可以通过以下方法完成用户自定义策略: 1. 继承 org.apache.iotdb.db.storageengine.rescon.disk.strategy.DirectoryStrategy 类并实现自身的 Strategy 方法; 2. 将实现的类的完整类名(包名加类名,UserDefineStrategyPackage)填写到该配置项; 3. 将该类 jar 包添加到工程中。 |
类型 | String |
默认值 | SequenceStrategy |
改后生效方式 | 热加载 |
名字 | dn_consensus_dir |
---|
描述 | IoTDB 共识层日志存储路径,默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关,建议使用绝对路径。 |
类型 | String |
默认值 | data/datanode/consensus(Windows:data\datanode\consensus) |
改后生效方式 | 重启服务生效 |
名字 | dn_wal_dirs |
---|
描述 | IoTDB 写前日志存储路径,默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关,建议使用绝对路径。 |
类型 | String |
默认值 | data/datanode/wal(Windows:data\datanode\wal) |
改后生效方式 | 重启服务生效 |
名字 | dn_tracing_dir |
---|
描述 | IoTDB 追踪根目录路径,默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关,建议使用绝对路径。 |
类型 | String |
默认值 | datanode/tracing |
改后生效方式 | 重启服务生效 |
名字 | dn_sync_dir |
---|
描述 | IoTDB sync 存储路径,默认存放在和 sbin 目录同级的 data 目录下。相对路径的起始目录与操作系统相关,建议使用绝对路径。 |
类型 | String |
默认值 | data/datanode/sync |
改后生效方式 | 重启服务生效 |
GC 日志默认是关闭的。为了性能调优,用户可能会需要收集 GC 信息。
若要打开 GC 日志,则需要在启动 IoTDB Server 的时候加上"printgc"参数:
nohup sbin/start-datanode.sh printgc >/dev/null 2>&1 &
或者
sbin\start-datanode.bat printgc
GC 日志会被存储在IOTDB_HOME/logs/gc.log
. 至多会存储 10 个 gc.log 文件,每个文件最多 10MB。
名字 | enable_rest_service |
---|
描述 | 是否开启Rest服务。 |
类型 | Boolean |
默认值 | false |
改后生效方式 | 重启生效 |
名字 | rest_service_port |
---|
描述 | Rest服务监听端口号 |
类型 | int32 |
默认值 | 18080 |
改后生效方式 | 重启生效 |
名字 | enable_swagger |
---|
描述 | 是否启用swagger来展示rest接口信息 |
类型 | Boolean |
默认值 | false |
改后生效方式 | 重启生效 |
- rest_query_default_row_size_limit
名字 | rest_query_default_row_size_limit |
---|
描述 | 一次查询能返回的结果集最大行数 |
类型 | int32 |
默认值 | 10000 |
改后生效方式 | 重启生效 |
名字 | cache_expire |
---|
描述 | 缓存客户登录信息的过期时间 |
类型 | int32 |
默认值 | 28800 |
改后生效方式 | 重启生效 |
名字 | cache_max_num |
---|
描述 | 缓存中存储的最大用户数量 |
类型 | int32 |
默认值 | 100 |
改后生效方式 | 重启生效 |
名字 | cache_init_num |
---|
描述 | 缓存初始容量 |
类型 | int32 |
默认值 | 10 |
改后生效方式 | 重启生效 |
名字 | trust_store_path |
---|
描述 | keyStore 密码(非必填) |
类型 | String |
默认值 | "" |
改后生效方式 | 重启生效 |
名字 | trust_store_pwd |
---|
描述 | trustStore 密码(非必填) |
类型 | String |
默认值 | "" |
改后生效方式 | 重启生效 |
名字 | idle_timeout |
---|
描述 | SSL 超时时间,单位为秒 |
类型 | int32 |
默认值 | 5000 |
改后生效方式 | 重启生效 |
- dn_default_space_move_thresholds
名字 | dn_default_space_move_thresholds |
---|
描述 | 1.3.0/1版本:定义每个层级数据目录的最小剩余空间比例;当剩余空间少于该比例时,数据会被自动迁移至下一个层级;当最后一个层级的剩余存储空间到低于此阈值时,会将系统置为 READ_ONLY |
类型 | double |
默认值 | 0.15 |
改后生效方式 | 热加载 |
- dn_default_space_usage_thresholds
名字 | dn_default_space_usage_thresholds |
---|
描述 | 1.3.2版本:定义每个层级数据目录的最小剩余空间比例;当剩余空间少于该比例时,数据会被自动迁移至下一个层级;当最后一个层级的剩余存储空间到低于此阈值时,会将系统置为 READ_ONLY |
类型 | double |
默认值 | 0.85 |
改后生效方式 | 热加载 |
名字 | remote_tsfile_cache_dirs |
---|
描述 | 云端存储在本地的缓存目录 |
类型 | string |
默认值 | data/datanode/data/cache |
改后生效方式 | 重启生效 |
- remote_tsfile_cache_page_size_in_kb
名字 | remote_tsfile_cache_page_size_in_kb |
---|
描述 | 云端存储在本地缓存文件的块大小 |
类型 | int |
默认值 | 20480 |
改后生效方式 | 重启生效 |
- remote_tsfile_cache_max_disk_usage_in_mb
名字 | remote_tsfile_cache_max_disk_usage_in_mb |
---|
描述 | 云端存储本地缓存的最大磁盘占用大小 |
类型 | long |
默认值 | 51200 |
改后生效方式 | 重启生效 |
名字 | object_storage_type |
---|
描述 | 云端存储类型 |
类型 | string |
默认值 | AWS_S3 |
改后生效方式 | 重启生效 |
名字 | object_storage_bucket |
---|
描述 | 云端存储 bucket 的名称 |
类型 | string |
默认值 | iotdb_data |
改后生效方式 | 重启生效 |
名字 | object_storage_endpoiont |
---|
描述 | 云端存储的 endpoint |
类型 | string |
默认值 | 无 |
改后生效方式 | 重启生效 |
- object_storage_access_key
名字 | object_storage_access_key |
---|
描述 | 云端存储的验证信息 key |
类型 | string |
默认值 | 无 |
改后生效方式 | 重启生效 |
- object_storage_access_secret
名字 | object_storage_access_secret |
---|
描述 | 云端存储的验证信息 secret |
类型 | string |
默认值 | 无 |
改后生效方式 | 重启生效 |