文档文档

创建数据库

使用 influxctl database create 命令 在您的 InfluxDB 集群中创建数据库。

  1. 如果您还没有 下载并安装 influxctl CLI

  2. 运行 influxctl database create 命令并提供以下信息

    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 保留策略名称新数据库名称
dbrpdb/rp
telegrafautogentelegraf/autogen
webmetrics1w-downsampledwebmetrics/1w-downsampled

表和列限制

在 InfluxDB Clustered 中,表(measurement)和列限制可以使用 --max-tables--max-columns 标志进行配置。

表限制

默认最大表数: 500

每个 measurement 都由数据库中的一个表表示。您的数据库的表限制可以提高到超出默认限制 500。InfluxData 拥有在多个数据库中拥有 20,000 多个活动表的集群的生产示例。

增加表限制会以下列方式影响您的 InfluxDB 集群

可能提高查询性能 查看更多信息

更多对象存储的 PUT 请求 查看更多信息

压缩器更多工作 查看更多信息

列限制

默认最大列数: 250

时间、字段和标签都由表中的一列表示。增加列限制会以下列方式影响您的 InfluxDB 集群

可能会对查询性能产生不利影响

自定义分区

InfluxDB Clustered 允许您为每个数据库定义自定义分区策略。分区 是存储在 InfluxDB 3 存储引擎中 Apache Parquet 格式的逻辑数据分组。默认情况下,数据按天分区,但根据您的模式和工作负载,自定义分区策略可以提高查询性能。

使用 --template-tag--template-tag-bucket 和 –template-timeformat` 标志来定义用于生成数据库分区键的分区模板部分。有关更多信息,请参阅 管理数据分区

分区模板只能在创建时应用

您只能在创建数据库时应用分区模板。您无法更新现有数据库上的分区模板。


此页内容是否对您有帮助?

感谢您的反馈!


Flux 的未来

Flux 即将进入维护模式。您可以继续像目前一样使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB 3 开源版现已公开发布 Alpha 版本

InfluxDB 3 开源版现已可用于 Alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 Alpha 版本的一部分。

InfluxDB 3 Core 是我们新的开源产品。它是一个用于时间序列和事件数据的最新数据引擎。InfluxDB 3 Enterprise 是一个商业版本,它建立在 Core 的基础上,增加了历史查询功能、读取副本、高可用性、可扩展性和细粒度的安全性。

有关如何开始使用的更多信息,请查看