创建一个表
使用influxctl table create命令在您指定的数据库中创建一个表,位于您的InfluxDB Cloud Dedicated集群中。
在 InfluxDB Cloud Dedicated 中,表和测量是同义的。通常,在使用写入到 InfluxDB 的行协议中指定的测量名称进行写入时,表会自动创建。但是,要将自定义分区模板应用于表,必须在写入任何数据之前手动创建该表。
如果您还没有,下载并安装
influxctlCLI。运行
influxctl table create命令并提供以下内容:- 可选: InfluxDB 标签 用于分区模板
- 可选: InfluxDB 标签桶 用于分区模板
- 可选: 一个支持的 Rust strftime 日期和时间字符串,用于指定分区模板中的时间格式,并确定分区的时间间隔 (默认值是
%Y-%m-%d) - 要在其中创建表的数据库名称
- 要创建的表的名称
InfluxDB Cloud Dedicated 在分区模板中支持最多 7 个总标签或标签桶。
influxctl table create \
--template-tag tag1 \
--template-tag tag2 \
--template-tag-bucket tag3,100 \
--template-tag-bucket tag4,300 \
--template-timeformat '%Y-%m-%d' \
DATABASE_NAME \
TABLE_NAME
自定义分区
InfluxDB Cloud Dedicated 允许您为每个表定义自定义分区策略。 一个 分区 是在 InfluxDB 3 存储引擎中以 Apache Parquet 格式存储的数据的逻辑分组。 默认情况下,数据按天分区, 但根据您的架构和工作负载,自定义分区策略可以提高查询性能。
使用 --template-tag、--template-tag-bucket 和 --template-timeformat
标志来定义用于生成表的分区键的分区模板部分。如果没有提供模板标志,则表使用目标数据库的分区模板。
有关更多信息,请参见 管理数据分区。
分区模板只能在创建时应用
在创建表时,您只能应用分区模板。没有办法在现有表上更新分区模板。