文档文档

列出表

使用 influxdb3 query 命令HTTP API 来列出 InfluxDB 3 Core 中指定数据库的表。

在 InfluxDB 3 Core 中,表和度量是同义的。本指南展示了如何检索数据库中所有表(度量)的列表。

使用 influxdb3 CLI 列出表

使用 influxdb3 query 命令和 SHOW TABLES SQL 语句

influxdb3 query \
  --database 
DATABASE_NAME
\
--token
AUTH_TOKEN
\
"SHOW TABLES"

替换以下内容:

  • DATABASE_NAME:要从中列出表的数据库名称
  • AUTH_TOKEN:您的 管理员令牌

示例输出

+---------------+---------------+------------+------------+
| table_catalog | table_schema  | table_name | table_type |
+---------------+---------------+------------+------------+
| public        | iox           | home       | BASE TABLE |
| public        | iox           | sensors    | BASE TABLE |
+---------------+---------------+------------+------------+

替代方法:使用 InfluxQL 列出表

您还可以使用 InfluxQL 语法来列出度量(表)

influxdb3 query \
  --language influxql \
  --database 
DATABASE_NAME
\
--token
AUTH_TOKEN
\
"SHOW MEASUREMENTS"

使用 HTTP API 列出表

要使用 HTTP API 列出表,请将 GET 请求发送到 /api/v3/query_sql 端点,并附带 SHOW TABLES 查询

GET localhost:8181/api/v3/query_sql

在您的请求中包含以下内容

  • 查询参数:
    • db:数据库名称
    • q:SQL 查询(SHOW TABLES
    • format:响应格式(可选,默认为 json
  • Headers:
    • Authorization: Bearer 加上您的身份验证令牌
curl --get "localhost:8181/api/v3/query_sql" \
  --header "Authorization: Bearer 
AUTH_TOKEN
"
\
--data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SHOW TABLES" \ --data-urlencode "format=json"

替换以下内容:

  • DATABASE_NAME:要从中列出表的数据库名称
  • AUTH_TOKEN:您的 管理员令牌

示例响应

{
  "results": [
    {
      "series": [
        {
          "name": "tables",
          "columns": ["table_catalog", "table_schema", "table_name", "table_type"],
          "values": [
            ["public", "iox", "home", "BASE TABLE"],
            ["public", "iox", "sensors", "BASE TABLE"]
          ]
        }
      ]
    }
  ]
}

以 CSV 格式获取响应

要以 CSV 格式获取响应,请将 format 参数设置为 csv

curl --get "localhost:8181/api/v3/query_sql" \
  --header "Authorization: Bearer 
AUTH_TOKEN
"
\
--data-urlencode "db=
DATABASE_NAME
"
\
--data-urlencode "q=SHOW TABLES" \ --data-urlencode "format=csv"

此页面是否有帮助?

感谢您的反馈!


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