influxctl 表创建
命令 influxctl table create 在指定的数据库中创建一个新表,在 InfluxDB Cloud Dedicated 集群中。
自定义分区
您可以用 --template-tag、--template-tag-bucket 和 --template-timeformat 标志覆盖默认的分区模板(目标数据库的分区模板)来创建表。使用 Rust strftime 提供时间格式,按特定标签分区,或将分区标签值分配到指定数量的“桶”中。每个选项都可以作为分区模板的一部分。请确保遵循 分区最佳实践。
使用自定义分区时始终提供时间格式
如果使用任何--template-*标志为您的表定义自定义分区模板,请始终包括--template-timeformat标志,并提供要在您的分区模板中使用的时间格式。否则,InfluxDB 将从分区模板中省略时间,并且不会压缩分区。
用法
influxctl table create [flags] <DATABASE_NAME> <TABLE_NAME>
参数
| 参数 | 描述 |
|---|---|
| DATABASE_NAME | 目标数据库的名称 |
| TABLE_NAME | 表名 |
标志
| 标志 | 描述 | |
|---|---|---|
--template-tag | 添加到分区模板的标签(可以包含多个此标志) | |
--template-tag-bucket | 标签和将标签值划分到的桶的数量,以逗号分隔–例如: tag1,100 (可以包含多个此标志) | |
--template-timeformat | 分区模板的时间戳格式 | |
-h | --help | 输出命令帮助 |
另见 influxctl 全局标志.
示例
在以下示例中,替换:
DATABASE_NAME: 在其中创建表的数据库名称。TABLE_NAME: 要创建的表的名称。
创建一个表
influxctl table create DATABASE_NAME TABLE_NAME
使用自定义分区模板创建表
以下示例创建一个新表,并应用一个分区模板,该模板通过两个标签 (room 和 sensor-type) 以及按天进行分区,使用时间格式 %Y-%m-%d:
influxctl table create \
--template-tag room \
--template-tag sensor-type \
--template-tag-bucket customerID,1000 \
--template-timeformat '%Y-%m-%d' \
DATABASE_NAME \
TABLE_NAME
有关自定义分区的更多信息,请参见 管理数据分区.