配置参数

为方便 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_PORT

• MAX_HEAP_SIZE

• HEAP_NEWSIZE

系统配置项

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

RPC配置

• rpc_address

• rpc_port

• rpc_thrift_compression_enable

• rpc_advanced_compression_enable

• rpc_max_concurrent_client_num

• thrift_max_frame_size

• thrift_init_buffer_size

InfluxDB 协议适配器配置

• enable_influxdb_rpc_service

• influxdb_rpc_port

写前日志配置

• enable_wal

• enable_discard_out_of_order_data

• flush_wal_threshold

• force_wal_period_in_ms

目录配置

• system_dir

• data_dirs

• multi_dir_strategy

• wal_dir

• tsfile_storage_fs

• core_site_path

• hdfs_site_path

• hdfs_ip

• hdfs_port

• dfs_nameservices

• dfs_ha_namenodes

• dfs_ha_automatic_failover_enabled

• dfs_client_failover_proxy_provider

• hdfs_use_kerberos

• kerberos_keytab_file_path

• kerberos_principal

存储引擎配置

• timestamp_precision

• default_ttl

• wal_buffer_size

• seq_tsfile_size

• unseq_tsfile_size

• mlog_buffer_size

• sync_mlog_period_in_ms

• memtable_size_threshold

• enable_timed_flush_seq_memtable

• seq_memtable_flush_interval_in_ms

• seq_memtable_flush_check_interval_in_ms

• enable_timed_flush_unseq_memtable

• unseq_memtable_flush_interval_in_ms

• unseq_memtable_flush_check_interval_in_ms

• enable_timed_close_tsfile

• close_tsfile_interval_after_flushing_in_ms

• close_tsfile_check_interval_in_ms

• avg_series_point_number_threshold

• concurrent_flush_thread

• concurrent_query_thread

• concurrent_sub_rawQuery_thread

• raw_query_blocking_queue_capacity

• chunk_buffer_pool_enable

• batch_size

• tag_attribute_total_size

• tag_attribute_flush_interval

• enable_partial_insert

• enable_mtree_snapshot

• mtree_snapshot_interval

• mtree_snapshot_threhold_time

内存控制配置

• enable_mem_control

• write_read_schema_free_memory_proportion

• primary_array_size

• flush_proportion

• time_index_memory_proportion

• buffered_arrays_memory_proportion

• reject_proportion

• storage_group_report_threshold

• max_deduplicated_path_num

• check_period_when_insert_blocked

• max_waiting_time_when_insert_blocked

• estimated_series_size

• io_task_queue_size_for_flushing

升级配置

• update_thread_num

查询配置

• default_fill_interval

• group_by_fill_cache_size_in_mb

合并配置

• enable_seq_space_compaction

• enable_unseq_space_compaction

• enable_cross_space_compaction

• cross_compaction_strategy

• inner_compaction_strategy

• compaction_priority

• target_compaction_file_size

• target_chunk_size

• target_chunk_point_num

• chunk_size_lower_bound_in_compaction

• chunk_point_num_lower_bound_in_compaction

• max_inner_compaction_candidate_file_num

• max_cross_compaction_candidate_file_num

• cross_compaction_file_selection_time_budget

• cross_compaction_memory_budget

• concurrent_compaction_thread

• compaction_schedule_interval_in_ms

• compaction_submission_interval_in_ms

• compaction_write_throughput_mb_per_sec

插入配置

• insert_multi_tablet_enable_multithreading_column_threshold

• query_timeout_threshold

元数据缓存配置

• meta_data_cache_enable

• chunk_timeseriesmeta_free_memory_proportion

• metadata_node_cache_size

最新点缓存配置

• enable_last_stat

统计监控器配置

• enable_stat_monitor

• enable_monitor_series_write

WAL 直接缓冲池配置

• wal_pool_trim_interval_ms

• max_wal_bytebuffer_num_for_each_partition

外部排序配置

• enable_external_sort

• external_sort_threshold

同步服务器配置

• is_sync_enable

• sync_server_port

• ip_white_list

性能统计配置

• enable_performance_stat

• tracing_dir

水印模块配置

• watermark_module_opened

• watermark_secret_key

• watermark_bit_string

• watermark_method

数据类型自动推断

• enable_auto_create_schema

• default_storage_group_level

• boolean_string_infer_type

• integer_string_infer_type

• long_string_infer_type

• floating_string_infer_type

• nan_string_infer_type

• default_boolean_encoding

• default_int32_encoding

• default_int64_encoding

• default_float_encoding

• default_double_encoding

• default_text_encoding

文件层配置

• group_size_in_byte

• page_size_in_byte

• max_number_of_points_in_page

• max_string_length

• float_precision

• time_encoder

• value_encoder

• compressor

• max_degree_of_index_node

• frequency_interval_in_minute

• slow_query_threshold

MQTT代理配置

• enable_mqtt_service

• mqtt_host

• mqtt_port

• mqtt_handler_pool_size

• mqtt_payload_formatter

• mqtt_max_message_size

授权配置

• authorizer_provider_class

• openID_url

UDF查询配置

• udf_initial_byte_array_length_for_memory_control

• udf_memory_budget_in_mb

• udf_reader_transformer_collector_memory_proportion

• udf_root_dir

索引配置

• index_root_dir

• enable_index

• concurrent_index_build_thread

• default_index_window_range

• index_buffer_size

• enable_partition

• partition_interval

• virtual_storage_group_num

• concurrent_writing_time_partition

• admin_name

• admin_password

SELECT-INTO配置

• select_into_insert_tablet_plan_row_limit

触发器配置

• concurrent_window_evaluation_thread

• max_pending_window_evaluation_tasks

连续查询配置

• continuous_query_execution_thread

• max_pending_continuous_query_tasks

• continuous_query_min_every_interval

开启 GC 日志

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

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

或者

1. sbin\start-server.bat printgc

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