文档文档

使用 influxdb3 CLI 查询数据

使用 influxdb3 query 命令 使用 SQL 或 InfluxQL 查询 InfluxDB 3 Core 中的数据。

在命令中提供以下内容

  • 授权令牌:您的 InfluxDB 3 Core 管理员令牌,拥有对数据库的读取权限。通过以下任一方式提供:

    • --token 命令选项
    • INFLUXDB3_AUTH_TOKEN 环境变量
  • 数据库名称:要查询的数据库名称。通过以下任一方式提供:

    • -d, --database 命令选项
    • INFLUXDB3_DATABASE_NAME 环境变量
  • 查询语言 (可选):查询的查询语言。使用 -l, --language 选项指定以下任一查询语言:

    • sql (默认)
    • influxql
  • 查询:要执行的 SQL 或 InfluxQL 查询。通过以下任一方式提供查询:

    • 字符串
    • --file 选项以及包含查询的文件的路径
    • 来自 stdin
influxdb3 query \
  --token 
AUTH_TOKEN
\
--database
DATABASE_NAME
\
"SELECT * FROM home"
influxdb3 query \
  --token 
AUTH_TOKEN
\
--database
DATABASE_NAME
\
--file ./query.sql
cat ./query.sql | influxdb3 query --token 
AUTH_TOKEN
--database
DATABASE_NAME
influxdb3 query \
  --token 
AUTH_TOKEN
\
--language influxql \ --database
DATABASE_NAME
\
"SELECT * FROM home"
influxdb3 query \
  --token 
AUTH_TOKEN
\
--language influxql \ --file ./query.influxql
cat ./query.influxql | influxdb3 query \
  --token 
AUTH_TOKEN
\
--language influxql \ --database
DATABASE_NAME

在上例和下例中,请替换以下内容:

  • DATABASE_NAME:要查询的数据库名称

输出格式

influxdb3 query 命令支持以下输出格式:

使用 --format 标志指定输出格式。

influxdb3 query \
  --token 
AUTH_TOKEN
\
--database
DATABASE_NAME
\
--format json \ "SELECT * FROM home WHERE time >= '2022-01-01T08:00:00Z' LIMIT 5"

查看格式化后的示例结果

查看 JSON 格式的示例结果

查看 JSON-line 格式的示例结果

查看 CSV 格式的示例结果

将查询结果输出到 Parquet 文件

要将查询结果输出到 Parquet 文件,请在 influxdb3 query 命令中提供以下选项:

  • --format: parquet
  • -o, --output: 用于存储结果的 Parquet 文件的文件路径
influxdb3 query \
  --token 
AUTH_TOKEN
\
--database
DATABASE_NAME
\
--format parquet \ --output path/to/results.parquet \ "SELECT * FROM home WHERE time >= '2022-01-01T08:00:00Z' LIMIT 5"

此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2