创建数据库
使用 influxctl database create
命令 在您的 InfluxDB 集群中创建数据库。
如果您还没有 下载并安装
influxctl
CLI。运行
influxctl database create
命令并提供以下信息- 可选: 数据库 保留期 (默认为无限)
- 可选:数据库表(measurement)限制 (默认为 500)
- 可选:数据库列限制 (默认为 250)
- 可选:InfluxDB 标签 以在分区模板中使用
- 可选:InfluxDB 标签桶 以在分区模板中使用
- 可选:Rust strftime 日期和时间字符串,用于指定分区模板中的时间格式并确定分区的时间间隔 (默认为
%Y-%m-%d
) - 数据库名称 (参见 数据库命名限制)
InfluxDB Clustered 在分区模板中最多支持 7 个标签或标签桶。
influxctl database create \
--retention-period 30d \
--max-tables 500 \
--max-columns 250 \
--template-tag tag1 \
--template-tag tag2 \
--template-tag-bucket tag3,100 \
--template-tag-bucket tag4,300 \
--template-timeformat '%Y-%m-%d' \
DATABASE_NAME
保留期语法
使用 --retention-period
标志为数据库定义特定的 保留期。保留期值是由数值和持续时间单位组成的时间持续值。例如,30d
表示 30 天。零持续时间 (0d
) 保留期是无限的,数据不会过期。保留期值不能为负数或包含空格。
有效的持续时间单位包括
- m:分钟
- h:小时
- d:天
- w:周
- mo:月
- y:年
保留期值示例
0d
:无限/无3d
:3 天6w
:6 周1mo
:1 个月(30 天)1y
:1 年30d30d
:60 天2.5d
:60 小时
数据库命名限制
数据库名称必须遵守以下命名限制
- 不能包含空格、标点符号或特殊字符。仅允许使用字母数字字符、下划线 (
_
)、短划线 (-
) 和正斜杠 (/
) 字符。 - 不应以下划线 (
_
) 开头。 - 最大长度为 64 个字符。
InfluxQL DBRP 命名约定
在 InfluxDB 1.x 中,数据存储在 数据库 和 保留策略 中。在 InfluxDB Clustered 中,数据库和保留策略已合并为数据库,其中数据库具有保留期,但保留策略不再是数据模型的一部分。由于 InfluxQL 使用 1.x 数据模型,因此数据库必须映射到 v1 数据库和保留策略 (DBRP) 才能使用 InfluxQL 查询。
当命名要使用 InfluxQL 查询的数据库时,请使用以下命名约定自动将 v1 DBRP 组合映射到 InfluxDB Clustered 数据库
database_name/retention_policy_name
数据库命名示例
v1 数据库名称 | v1 保留策略名称 | 新数据库名称 |
---|---|---|
db | rp | db/rp |
telegraf | autogen | telegraf/autogen |
webmetrics | 1w-downsampled | webmetrics/1w-downsampled |
表和列限制
在 InfluxDB Clustered 中,表(measurement)和列限制可以使用 --max-tables
和 --max-columns
标志进行配置。
表限制
默认最大表数: 500
每个 measurement 都由数据库中的一个表表示。您的数据库的表限制可以提高到超出默认限制 500。InfluxData 拥有在多个数据库中拥有 20,000 多个活动表的集群的生产示例。
增加表限制会以下列方式影响您的 InfluxDB 集群
列限制
默认最大列数: 250
时间、字段和标签都由表中的一列表示。增加列限制会以下列方式影响您的 InfluxDB 集群
自定义分区
InfluxDB Clustered 允许您为每个数据库定义自定义分区策略。分区 是存储在 InfluxDB 3 存储引擎中 Apache Parquet 格式的逻辑数据分组。默认情况下,数据按天分区,但根据您的模式和工作负载,自定义分区策略可以提高查询性能。
使用 --template-tag
、--template-tag-bucket 和
–template-timeformat` 标志来定义用于生成数据库分区键的分区模板部分。有关更多信息,请参阅 管理数据分区。
分区模板只能在创建时应用
您只能在创建数据库时应用分区模板。您无法更新现有数据库上的分区模板。
此页内容是否对您有帮助?
感谢您的反馈!
支持和反馈
感谢您成为我们社区的一份子!我们欢迎并鼓励您提供关于 InfluxDB Clustered 和本文档的反馈和错误报告。要获得支持,请使用以下资源
拥有年度或支持合同的客户 可以 联系 InfluxData 支持。