自动创建元数据

自动创建元数据指的是根据写入数据的特征自动创建出用户未定义的时间序列， 这既能解决海量序列场景下设备及测点难以提前预测与建模的难题，又能为用户提供开箱即用的写入体验。

自动创建存储组的元数据

  • enable_auto_create_schema
名字 enable_auto_create_schema
描述 是否开启自动创建元数据功能
类型 boolean
默认值 true
改后生效方式 重启服务生效
  • default_storage_group_level
名字 default_storage_group_level
描述 指定存储组在时间序列所处的层级，默认为第 1 层（root为第 0 层）
类型 int
默认值 1
改后生效方式 仅允许在第一次启动服务前修改

以下图为例：

  • 当 default_storage_group_level=1 时，将使用 root.turbine1 和 root.turbine2 作为存储组。
  • 当 default_storage_group_level=2 时，将使用 root.turbine1.d1、root.turbine1.d2、root.turbine2.d1 和 root.turbine2.d2 作为存储组。

auto create storage group example

自动创建序列的元数据（前端指定数据类型）

  • 用户在写入时精确指定数据类型：

  • Session中的insertTablet接口。

  • Session中带有TSDataType的insert接口。

    1. public void insertRecord(String deviceId, long time, List<String> measurements, List<TSDataType> types, Object... values); 2. public void insertRecords(List<String> deviceIds, List<Long> times, List<List<String>> measurementsList, List<List<TSDataType>> typesList, List<List<Object>> valuesList); - …… - 插入数据的同时自动创建序列，效率较高。

自动创建序列的元数据（类型推断）

  • 在写入时直接传入字符串，数据库推断数据类型：

  • CLI的insert命令。

  • Session中不带有TSDataType的insert接口。

    1. public void insertRecord(String deviceId, long time, List<String> measurements, List<TSDataType> types, List<Object> values); 2. public void insertRecords(List<String> deviceIds, List<Long> times, List<List<String>> measurementsList, List<List<String>> valuesList); - …… - 由于类型推断会增加写入时间，所以通过类型推断自动创建序列元数据的效率要低于通过前端指定数据类型自动创建序列元数据，建议用户在可行时先选用前端指定数据类型的方式自动创建序列的元数据。

类型推断

数据(String) 字符串格式 iotdb-engine.properties配置项 默认值
true boolean boolean_string_infer_type BOOLEAN
1 integer integer_string_infer_type FLOAT
17000000（大于 2^24 的整数） integer long_string_infer_type DOUBLE
1.2 floating floating_string_infer_type FLOAT
NaN nan nan_string_infer_type DOUBLE
‘I am text’ text 无 无
  • 可配置的数据类型包括：BOOLEAN, INT32, INT64, FLOAT, DOUBLE, TEXT
  • long_string_infer_type 配置项的目的是防止使用 FLOAT 推断 integer_string_infer_type 而造成精度缺失。

编码方式

数据类型 iotdb-engine.properties配置项 默认值
BOOLEAN default_boolean_encoding RLE
INT32 default_int32_encoding RLE
INT64 default_int64_encoding RLE
FLOAT default_float_encoding GORILLA
DOUBLE default_double_encoding GORILLA
TEXT default_text_encoding PLAIN
  • 可配置的编码方式包括：PLAIN, RLE, TS_2DIFF, GORILLA, DICTIONARY
  • 数据类型与编码方式的对应关系详见 编码方式。