元数据操作

数据库管理

数据库（Database）可以被视为关系数据库中的Database。

创建数据库

我们可以根据存储模型建立相应的数据库。如下所示：

IoTDB > CREATE DATABASE root.ln

需要注意的是，database 的父子节点都不能再设置 database。例如在已经有root.ln和root.sgcc这两个 database 的情况下，创建root.ln.wf01 database 是不可行的。系统将给出相应的错误提示，如下所示：

IoTDB> CREATE DATABASE root.ln.wf01
Msg: 300: root.ln has already been created as database.

Database 节点名只支持中英文字符、数字、下划线的组合，如果想设置为纯数字或者包含其他字符，需要用反引号(``)把 database 名称引起来。

还需注意，如果在 Windows 系统上部署，database 名是大小写不敏感的。例如同时创建root.ln 和 root.LN 是不被允许的。

查看数据库

在 database 创建后，我们可以使用 SHOW DATABASES 语句和 SHOW DATABASES <PathPattern> 来查看 database，SQL 语句如下所示：

IoTDB> show databases
IoTDB> show databases root.*
IoTDB> show databases root.**

执行结果为：

+-------------+----+-------------------------+-----------------------+-----------------------+
|     database| ttl|schema_replication_factor|data_replication_factor|time_partition_interval|
+-------------+----+-------------------------+-----------------------+-----------------------+
|    root.sgcc|null|                        2|                      2|                 604800|
|      root.ln|null|                        2|                      2|                 604800|
+-------------+----+-------------------------+-----------------------+-----------------------+
Total line number = 2
It costs 0.060s

删除数据库

用户可以使用DELETE DATABASE <PathPattern>语句删除该路径模式匹配的所有的数据库。在删除的过程中，需要注意的是数据库的数据也会被删除。

IoTDB > DELETE DATABASE root.ln
IoTDB > DELETE DATABASE root.sgcc
// 删除所有数据，时间序列以及数据库
IoTDB > DELETE DATABASE root.**

统计数据库数量

用户可以使用COUNT DATABASES <PathPattern>语句统计数据库的数量，允许指定PathPattern 用来统计匹配该PathPattern 的数据库的数量

SQL 语句如下所示：

IoTDB> show databases
IoTDB> count databases
IoTDB> count databases root.*
IoTDB> count databases root.sgcc.*
IoTDB> count databases root.sgcc

执行结果为：

+-------------+
|     database|
+-------------+
|    root.sgcc|
| root.turbine|
|      root.ln|
+-------------+
Total line number = 3
It costs 0.003s

+-------------+
|     Database|
+-------------+
|            3|
+-------------+
Total line number = 1
It costs 0.003s

+-------------+
|     Database|
+-------------+
|            3|
+-------------+
Total line number = 1
It costs 0.002s

+-------------+
|     Database|
+-------------+
|            0|
+-------------+
Total line number = 1
It costs 0.002s

+-------------+
|     database|
+-------------+
|            1|
+-------------+
Total line number = 1
It costs 0.002s

设置异构数据库（进阶操作）

在熟悉 IoTDB 元数据建模的前提下，用户可以在 IoTDB 中设置异构的数据库，以便应对不同的生产需求。

目前支持的数据库异构参数有：

参数名	参数类型	参数描述
TTL	Long	数据库的 TTL
SCHEMA_REPLICATION_FACTOR	Integer	数据库的元数据副本数
DATA_REPLICATION_FACTOR	Integer	数据库的数据副本数
SCHEMA_REGION_GROUP_NUM	Integer	数据库的 SchemaRegionGroup 数量
DATA_REGION_GROUP_NUM	Integer	数据库的 DataRegionGroup 数量

用户在配置异构参数时需要注意以下三点：

• TTL 和 TIME_PARTITION_INTERVAL 必须为正整数。
• SCHEMA_REPLICATION_FACTOR 和 DATA_REPLICATION_FACTOR 必须小于等于已部署的 DataNode 数量。
• SCHEMA_REGION_GROUP_NUM 和 DATA_REGION_GROUP_NUM 的功能与 iotdb-common.properties 配置文件中的
  schema_region_group_extension_policy 和 data_region_group_extension_policy 参数相关，以 DATA_REGION_GROUP_NUM 为例：
  若设置 data_region_group_extension_policy=CUSTOM，则 DATA_REGION_GROUP_NUM 将作为 Database 拥有的 DataRegionGroup 的数量；
  若设置 data_region_group_extension_policy=AUTO，则 DATA_REGION_GROUP_NUM 将作为 Database 拥有的 DataRegionGroup 的配额下界，即当该 Database 开始写入数据时，将至少拥有此数量的 DataRegionGroup。

用户可以在创建 Database 时设置任意异构参数，或在单机/分布式 IoTDB 运行时调整部分异构参数。

创建 Database 时设置异构参数

用户可以在创建 Database 时设置上述任意异构参数，SQL 语句如下所示：

CREATE DATABASE prefixPath (WITH databaseAttributeClause (COMMA? databaseAttributeClause)*)?

例如：

CREATE DATABASE root.db WITH SCHEMA_REPLICATION_FACTOR=1, DATA_REPLICATION_FACTOR=3, SCHEMA_REGION_GROUP_NUM=1, DATA_REGION_GROUP_NUM=2;

运行时调整异构参数

用户可以在 IoTDB 运行时调整部分异构参数，SQL 语句如下所示：

ALTER DATABASE prefixPath WITH databaseAttributeClause (COMMA? databaseAttributeClause)*

例如：

ALTER DATABASE root.db WITH SCHEMA_REGION_GROUP_NUM=1, DATA_REGION_GROUP_NUM=2;

注意，运行时只能调整下列异构参数：

• SCHEMA_REGION_GROUP_NUM
• DATA_REGION_GROUP_NUM

查看异构数据库

用户可以查询每个 Database 的具体异构配置，SQL 语句如下所示：

SHOW DATABASES DETAILS prefixPath?

例如：

IoTDB> SHOW DATABASES DETAILS
+--------+--------+-----------------------+---------------------+---------------------+--------------------+-----------------------+-----------------------+------------------+---------------------+---------------------+
|Database|     TTL|SchemaReplicationFactor|DataReplicationFactor|TimePartitionInterval|SchemaRegionGroupNum|MinSchemaRegionGroupNum|MaxSchemaRegionGroupNum|DataRegionGroupNum|MinDataRegionGroupNum|MaxDataRegionGroupNum|
+--------+--------+-----------------------+---------------------+---------------------+--------------------+-----------------------+-----------------------+------------------+---------------------+---------------------+
|root.db1|    null|                      1|                    3|            604800000|                   0|                      1|                      1|                 0|                    2|                    2|
|root.db2|86400000|                      1|                    1|            604800000|                   0|                      1|                      1|                 0|                    2|                    2|
|root.db3|    null|                      1|                    1|            604800000|                   0|                      1|                      1|                 0|                    2|                    2|
+--------+--------+-----------------------+---------------------+---------------------+--------------------+-----------------------+-----------------------+------------------+---------------------+---------------------+
Total line number = 3
It costs 0.058s

各列查询结果依次为：

• 数据库名称
• 数据库的 TTL
• 数据库的元数据副本数
• 数据库的数据副本数
• 数据库的时间分区间隔
• 数据库当前拥有的 SchemaRegionGroup 数量
• 数据库需要拥有的最小 SchemaRegionGroup 数量
• 数据库允许拥有的最大 SchemaRegionGroup 数量
• 数据库当前拥有的 DataRegionGroup 数量
• 数据库需要拥有的最小 DataRegionGroup 数量
• 数据库允许拥有的最大 DataRegionGroup 数量