Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
docs-v2/content/shared/influxdb3-admin/databases/list.md

4.3 KiB
Raw Blame History

Use the influxdb3 show databases command, the /api/v3/configure/database HTTP API endpoint, or InfluxDB 3 Explorer to list databases in {{< product-name >}}.

List databases using the influxdb3 CLI

Provide the following:

  • (Optional) Output format with the --format option
  • (Optional) Show deleted databases with the --show-deleted option
  • {{< product-name >}} {{% token-link "admin" "admin" %}} with the -t, --token option
influxdb3 show databases

Output formats

The influxdb3 show databases command supports output formats:

  • pretty (default)
  • json
  • jsonl
  • csv

Use the --format flag to specify the output format:

influxdb3 show databases --format json

Example output

{{< expand-wrapper >}} {{% expand "View example pretty-formatted output" %}} {{% influxdb/custom-timestamps %}}

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

{{% /influxdb/custom-timestamps %}} {{% /expand %}} {{% expand "View example JSON-formatted output" %}} {{% influxdb/custom-timestamps %}}

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

{{% /influxdb/custom-timestamps %}} {{% /expand %}} {{% expand "View example JSON-line-formatted output" %}} {{% influxdb/custom-timestamps %}}

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

{{% /influxdb/custom-timestamps %}} {{% /expand %}} {{% expand "View example CSV-formatted output" %}} {{% influxdb/custom-timestamps %}}

iox::database
home
home_actions
noaa

{{% /influxdb/custom-timestamps %}} {{% /expand %}} {{< /expand-wrapper >}}

List deleted databases

To list deleted databases, include the --show-deleted option with your influxdb3 show databases command:

influxdb3 show databases --show-deleted

List databases using the HTTP API

To list databases using the HTTP API, send a GET request to the /api/v3/configure/database endpoint:

{{% api-endpoint method="GET" endpoint="{{< influxdb/host >}}/api/v3/configure/database" %}}

Include the following in your request:

  • Headers:
    • Authorization: Bearer with your {{% token-link %}}
curl --request GET "{{< influxdb/host >}}/api/v3/configure/database" \
  --header "Authorization: Bearer AUTH_TOKEN"

Replace the following:

  • {{% code-placeholder-key %}}AUTH_TOKEN{{% /code-placeholder-key %}}: your {{% token-link "admin" %}}

Response

A successful request returns HTTP status 200 with a JSON array of database objects:

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

List databases using InfluxDB 3 Explorer

You can also view all databases using the InfluxDB 3 Explorer web interface:

  1. If you haven't already, see how to get started with Explorer and connect to your {{% product-name %}} server.
  2. In Explorer, click Databases in the left navigation.
  3. The Databases page displays a list of all databases with the following information:
    • Database name
    • Retention period (if configured)
    • Number of tables in the database
    • Creation date

For more information, see Manage databases with InfluxDB 3 Explorer.