IoTDB Website

...大约 3 分钟

元数据模板

IoTDB 支持元数据模板功能，实现同类型不同实体的物理量元数据共享，减少元数据内存占用，同时简化同类型实体的管理。

注：以下语句中的 schema 关键字可以省略。

创建元数据模板

创建元数据模板的 SQL 语法如下：

CREATE SCHEMA? TEMPLATE <templateName> ALIGNED? '(' <measurementId> <attributeClauses> [',' <measurementId> <attributeClauses>]+ ')'

示例1： 创建包含两个非对齐序列的元数据模板

IoTDB> create schema template t1 (temperature FLOAT encoding=RLE, status BOOLEAN encoding=PLAIN compression=SNAPPY)

示例2： 创建包含一组对齐序列的元数据模板

IoTDB> create schema template t2 aligned (lat FLOAT encoding=Gorilla, lon FLOAT encoding=Gorilla)

其中，物理量 lat 和 lon 是对齐的。

挂载元数据模板

为了更好地适配未来版本的更新及各模块的协作，我们强烈建议您将模板设置在存储组及存储组下层的节点中。

挂载元数据模板的 SQL 语句如下所示：

IoTDB> set schema template t1 to root.sg1.d1

挂载好元数据模板后，即可进行数据的写入。例如存储组为 root.sg1，模板 t1 被挂载到了节点 root.sg1.d1，那么可直接向时间序列（如 root.sg1.d1.temperature 和 root.sg1.d1.status）写入时间序列数据，该时间序列已可被当作正常创建的序列使用。

注意：在插入数据之前，模板定义的时间序列不会被创建。可以使用如下SQL语句在插入数据前创建时间序列：

IoTDB> create timeseries of schema template on root.sg1.d1

示例： 执行以下语句

set schema template t1 to root.sg1.d1
set schema template t2 to root.sg1.d2
create timeseries of schema template on root.sg1.d1
create timeseries of schema template on root.sg1.d2

查看此时的时间序列：

show timeseries root.sg1.**

+-----------------------+-----+-------------+--------+--------+-----------+----+----------+--------+-------------------+
|             timeseries|alias|storage group|dataType|encoding|compression|tags|attributes|deadband|deadband parameters|
+-----------------------+-----+-------------+--------+--------+-----------+----+----------+--------+-------------------+
|root.sg1.d1.temperature| null|     root.sg1|   FLOAT|     RLE|     SNAPPY|null|      null|    null|               null|
|     root.sg1.d1.status| null|     root.sg1| BOOLEAN|   PLAIN|     SNAPPY|null|      null|    null|               null|
|        root.sg1.d2.lon| null|     root.sg1|   FLOAT| GORILLA|     SNAPPY|null|      null|    null|               null|
|        root.sg1.d2.lat| null|     root.sg1|   FLOAT| GORILLA|     SNAPPY|null|      null|    null|               null|
+-----------------------+-----+-------------+--------+--------+-----------+----+----------+--------+-------------------+

查看此时的设备：

show devices root.sg1.**

+---------------+---------+
|        devices|isAligned|
+---------------+---------+
|    root.sg1.d1|    false|
|    root.sg1.d2|     true|
+---------------+---------+

查看元数据模板

查看所有元数据模板

SQL 语句如下所示：

IoTDB> show schema templates

执行结果如下：

+-------------+
|template name|
+-------------+
|           t2|
|           t1|
+-------------+

查看某个元数据模板下的物理量

SQL 语句如下所示：

IoTDB> show nodes in schema template t1

执行结果如下：

+-----------+--------+--------+-----------+
|child nodes|dataType|encoding|compression|
+-----------+--------+--------+-----------+
|temperature|   FLOAT|     RLE|     SNAPPY|
|     status| BOOLEAN|   PLAIN|     SNAPPY|
+-----------+--------+--------+-----------+

查看挂载了某个元数据模板的路径前缀

IoTDB> show paths set schema template t1

执行结果如下：

+-----------+
|child paths|
+-----------+
|root.sg1.d1|
+-----------+

查看使用了某个元数据模板（即序列已创建）的路径前缀

IoTDB> show paths using schema template t1

执行结果如下：

+-----------+
|child paths|
+-----------+
|root.sg1.d1|
+-----------+

解除元数据模板

对于挂载了元数据模板的节点或其孩子节点，如果：1）曾按模板中的序列写入了数据，或2）使用了 create timeseries of schema template，则在使用以下命令之前，不能够卸载或删除元数据模板：

IoTDB> deactivate schema template t1 from root.sg.d1

注意：这一操作会删除对应节点下按照模板中的序列写入的数据。

卸载元数据模板

卸载元数据模板的 SQL 语句如下所示：

IoTDB> unset schema template t1 from root.sg1.d1

删除元数据模板

删除元数据模板的 SQL 语句如下所示：

IoTDB> drop schema template t1

注意：不能删除尚未卸载的模板。