文档说明

查看分区信息

InfluxDB集群版将分区信息存储在InfluxDB v3的系统表中。查询分区信息以查看分区模板并验证分区是否按预期工作。

查询系统表可能会影响整体集群性能

分区信息存储在InfluxDB v3的系统表中。查询系统表可能会影响您InfluxDB集群的整体写入和查询性能。

系统表可能会更改

系统表不是InfluxDB稳定API的一部分,可能会随着新版本而更改。提供的架构信息和查询示例截至2024年9月24日有效。如果您发现架构更改或查询示例无法正常工作,请提交问题

从系统表中查询分区信息

使用influxctl query命令和SQL查询InfluxDB系统表中的与分区相关的信息。提供以下内容

  • 使用带有--enable-system-tables命令标志的启用系统表

  • 数据库令牌:具有对指定数据库读取权限的数据库令牌。使用influxctl连接配置文件中的token设置或--token命令标志。

  • 数据库名称:要查询其信息的数据库的名称。使用influxctl连接配置文件中的database设置或--database命令标志。

  • SQL查询:要执行的SQL查询。以下方式之一传递查询

    • 命令行上的字符串
    • 包含查询的文件的路径
    • 单个短横线(-)从stdin读取查询
influxctl query \
  --enable-system-tables \
  --database 
DATABASE_NAME
\
--token
DATABASE_TOKEN
\
"
SQL_QUERY
"

替换以下内容

  • DATABASE_TOKEN:具有对指定数据库读取访问权限的数据库令牌
  • DATABASE_NAME:要查询其信息的数据库的名称。
  • SQL_QUERY:要执行的SQL查询。有关示例,请参阅系统查询示例

当提示时,输入y以确认查询系统表可能对您的集群产生的影响。

使用以下查询返回关于您InfluxDB集群分区信息。


在以下示例中,将TABLE_NAME替换为您要查询信息的表名。


查看特定表的分区模板

SELECT * FROM system.tables WHERE table_name = '
TABLE_NAME
'

示例结果

table_namepartition_template
weather{"parts":[{"timeFormat":"%Y-%m-%d"},{"bucket":{"tagName":"location","numBuckets":250}}]}

如果某个表在命令输出的分区模板中未包含,则该表使用默认(1天)分区策略,不按标签或标签桶进行分区。

查看表的全部分区

SELECT * FROM system.partitions WHERE table_name = '
TABLE_NAME
'

示例结果

partition_idtable_namepartition_keylast_new_file_created_atnum_filestotal_size_mb
1362weather43 | 2020-05-27168374741876381371310
800weather234 | 2021-08-02168374742189940079610
630weather325 | 2022-03-17168374741761668903610
1401weather12 | 2021-01-09168374741778612229510
1012weather115 | 2022-07-04168374741761421914810

查看每个表的分区数量

SELECT
  table_name,
  COUNT(*) AS partition_count
FROM
  system.partitions
WHERE
  table_name IN ('
TABLE_NAME_1
'
, '
TABLE_NAME_2
'
, '
TABLE_NAME_3
'
)
GROUP BY table_name

示例结果

table_namepartition_count
weather1096
home24
numbers1

查看特定表的分区数量

SELECT
  COUNT(*) AS partition_count
FROM
  system.partitions
WHERE
  table_name = '
TABLE_NAME
'

示例结果

table_namepartition_count
weather1096

这个页面有帮助吗?

感谢您的反馈!


Flux的未来

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

阅读更多

InfluxDB v3增强功能和InfluxDB Clustered现已普遍可用

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

InfluxDB v3性能和功能

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

了解新的v3增强功能


InfluxDB Clustered普遍可用

InfluxDB Clustered现已普遍可用,并为您提供了在自管理的堆栈中使用InfluxDB v3的能力。

与我们谈谈InfluxDB Clustered