列出数据库
使用influxctl CLI或管理HTTP API在您的InfluxDB Cloud Dedicated集群中创建数据库。
使用influxctl database list 命令来列出您在InfluxDB Cloud Dedicated集群中的数据库。
如果您还没有,下载并安装
influxctlCLI,然后为您的集群influxctl配置连接配置文件。在你的终端中,运行
influxctl database list命令并提供以下内容:- 可选: 输出格式
influxctl database list --format table
此示例使用 cURL 发送管理 HTTP API 请求,但您可以使用任何 HTTP 客户端。
如果您还没有,请按照说明 安装 cURL 到您的系统。
在您的终端中,使用 cURL 向以下 InfluxDB Cloud 专用端点发送请求:
GET https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/databases
在URL中提供以下凭据:
提供以下请求头:
以下示例展示了如何使用管理 API 列出集群中的数据库:
curl \
--location "https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/databases" \
--header "Accept: application/json" \
--header "Authorization: Bearer MANAGEMENT_TOKEN"
在您的请求中替换以下内容:
输出格式
命令 influxctl database list 支持两种输出格式: table 和 json。 默认情况下,命令输出格式化为表格的数据库列表。 为了更方便地以编程方式访问命令输出,可以在命令中包含 --format json 来将输出格式化为 JSON。
管理 API 在响应体中输出 JSON 格式。
保留期语法
以表格格式,保留期限是由数字值加上持续单位组成的时间duration值——例如,30d 意味着 30 天。
infinite 保留期限意味着数据不会过期。
在JSON格式中,保留期值是一个整数 (),表示纳秒数——例如, 2592000000000 意味着30天。零 (0) 的保留期意味着数据不会过期。
示例输出
+---------------+------------------+------------+-----------------------+
| DATABASE NAME | RETENTION PERIOD | MAX TABLES | MAX COLUMNS PER TABLE |
+---------------+------------------+------------+-----------------------+
| mydb1 | infinite | 500 | 250 |
| mydb2 | infinite | 500 | 200 |
| mydb3 | 24h | 100 | 200 |
+---------------+------------------+------------+-----------------------+
[
{
"account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
"cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
"database_name": "mydb1",
"retention_period_ns": 0,
"max_tables": 500,
"max_columns_per_table": 250
},
{
"account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
"cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
"database_name": "mydb2",
"retention_period_ns": 0,
"max_tables": 500,
"max_columns_per_table": 200
},
{
"account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
"cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
"database_name": "mydb3",
"retention_period_ns": 86400000000000,
"max_tables": 100,
"max_columns_per_table": 200
},
]