列出数据库

使用 influxdb3 show databases 命令、/api/v3/configure/database HTTP API 端点或 InfluxDB 3 Explorer 来列出 InfluxDB 3 Core 中的数据库。

• 使用 influxdb3 CLI 列出数据库
• 使用 HTTP API 列出数据库
• 使用 InfluxDB 3 Explorer 列出数据库

使用 influxdb3 CLI 列出数据库

提供以下内容

• (可选) 使用 --format 选项设置 输出格式
• (可选) 使用 --show-deleted 选项 显示已删除的数据库
• InfluxDB 3 Core 管理员令牌，使用 -t、--token 选项

influxdb3 show databases

输出格式

influxdb3 show databases 命令支持以下输出格式：

• pretty (默认)
• json
• jsonl
• csv

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

influxdb3 show databases --format json

示例输出

+---------------+
| iox::database |
+---------------+
| home          |
| home_actions  |
| noaa          |
+---------------+

[{"iox::database":"home"},{"iox::database":"home_actions"},{"iox::database":"noaa"}]

{"iox::database":"home"}
{"iox::database":"home_actions"}
{"iox::database":"noaa"}

iox::database
home
home_actions
noaa

列出已删除的数据库

要列出已删除的数据库，请在 influxdb3 show databases 命令中包含 --show-deleted 选项。

influxdb3 show databases --show-deleted

使用 HTTP API 列出数据库

要使用 HTTP API 列出数据库，请向 /api/v3/configure/database 端点发送 GET 请求。

GET localhost:8181/api/v3/configure/database

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

• Headers:
  • Authorization: Bearer 加上您的 令牌

curl --request GET "localhost:8181/api/v3/configure/database" \
  --header "Authorization: Bearer 
AUTH_TOKEN
"

替换以下内容：

• AUTH_TOKEN：您的 管理员令牌

响应

成功的请求将返回 HTTP 状态码 200，以及一个数据库对象的 JSON 数组。

[
  {
    "db": "home",
    "retention_period": "30d"
  },
  {
    "db": "home_actions",
    "retention_period": "7d"
  },
  {
    "db": "noaa",
    "retention_period": "none"
  }
]

使用 InfluxDB 3 Explorer 列出数据库

您还可以通过 InfluxDB 3 Explorer Web 界面查看所有数据库。

1. 如果您还没有这样做，请参阅如何 开始使用 Explorer 并连接到您的 InfluxDB 3 Core 服务器。
2. 在 Explorer 中，点击左侧导航栏中的 **Databases**。
3. “Databases”页面会显示所有数据库的列表，其中包含以下信息：
   • 数据库名称
   • 保留期（如果已配置）
   • 数据库中的表数量
   • 创建日期

有关更多信息，请参阅 使用 InfluxDB 3 Explorer 管理数据库。