文档说明

创建数据库

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

  1. 如果您还没有安装,请下载并安装influxctlCLI

  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中,可以使用--max-tables--max-columns标志配置表(度量)和列限制。

表限制

默认最大表数: 500

每个度量在数据库中由一个表表示。您可以将数据库的表限制从默认的500个限制提高到更高。InfluxData有生产集群的示例,多个数据库中有20,000+个活动表。

增加您的表限制会影响您的InfluxDB集群,以下是一些方式

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

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

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

列限制

默认最大列数: 250

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

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

自定义分区

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

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

分区模板只能在使用时应用

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


这个页面有帮助吗?

感谢您的反馈!


Flux 的未来

Flux 正进入维护模式。您可以在不更改代码的情况下继续像现在一样使用它。

阅读更多

InfluxDB v3 增强功能和 InfluxDB 集群现在已普遍可用

包括更快查询性能和管理工具在内的新功能,推动了 InfluxDB v3 产品线的进步。InfluxDB 集群现在已普遍可用。

InfluxDB v3 性能和功能

InfluxDB v3 产品线在查询性能方面取得了显著增强,并提供了新的管理工具。这些增强包括用于监控 InfluxDB 集群健康的操作仪表板,InfluxDB 云专用版中的单点登录(SSO)支持,以及用于令牌和数据库的新管理 API。

了解新的 v3 增强


InfluxDB 集群普遍可用

InfluxDB 集群现在已普遍可用,为您在自行管理堆栈中提供了 InfluxDB v3 的功能。

与我们谈谈 InfluxDB 集群