Manage databases and tokens in InfluxDB 3 Explorer (#6162)
* Manage databases and tokens in Explorer * Update content/influxdb3/explorer/manage-tokens.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>pull/6177/head
Scott Anderson
GitHub
parent
d6383cd5a0
commit
d176eea4e7
|
|
@ -12,6 +12,7 @@ influxdb3/core/tags: [databases]
|
|||
related:
|
||||
- /influxdb3/core/write-data/best-practices/schema-design/
|
||||
- /influxdb3/core/reference/cli/influxdb3/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
alt_links:
|
||||
cloud: /influxdb/cloud/admin/buckets/
|
||||
cloud_dedicated: /influxdb3/cloud-dedicated/admin/databases/
|
||||
|
|
|
|||
|
|
@ -17,6 +17,7 @@ list_code_example: |
|
|||
{{% /code-placeholders %}}
|
||||
related:
|
||||
- /influxdb3/core/reference/cli/influxdb3/create/database/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
source: /shared/influxdb3-admin/databases/create.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -16,6 +16,7 @@ list_code_example: |
|
|||
{{% /code-placeholders %}}
|
||||
related:
|
||||
- /influxdb3/core/reference/cli/influxdb3/delete/database/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
source: /shared/influxdb3-admin/databases/delete.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -13,6 +13,7 @@ list_code_example: |
|
|||
```
|
||||
related:
|
||||
- /influxdb3/core/reference/cli/influxdb3/show/databases/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
source: /shared/influxdb3-admin/databases/list.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -12,6 +12,7 @@ influxdb3/enterprise/tags: [databases]
|
|||
related:
|
||||
- /influxdb3/enterprise/write-data/best-practices/schema-design/
|
||||
- /influxdb3/enterprise/reference/cli/influxdb3/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
alt_links:
|
||||
cloud: /influxdb/cloud/admin/buckets/
|
||||
cloud_dedicated: /influxdb3/cloud-dedicated/admin/databases/
|
||||
|
|
|
|||
|
|
@ -17,6 +17,7 @@ list_code_example: |
|
|||
{{% /code-placeholders %}}
|
||||
related:
|
||||
- /influxdb3/enterprise/reference/cli/influxdb3/create/database/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
source: /shared/influxdb3-admin/databases/create.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -16,6 +16,7 @@ list_code_example: |
|
|||
{{% /code-placeholders %}}
|
||||
related:
|
||||
- /influxdb3/enterprise/reference/cli/influxdb3/delete/database/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
source: /shared/influxdb3-admin/databases/delete.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -13,6 +13,7 @@ list_code_example: |
|
|||
```
|
||||
related:
|
||||
- /influxdb3/enterprise/reference/cli/influxdb3/show/databases/
|
||||
- /influxdb3/explorer/manage-databases/
|
||||
source: /shared/influxdb3-admin/databases/list.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -6,6 +6,8 @@ menu:
|
|||
influxdb3_enterprise:
|
||||
parent: Administer InfluxDB
|
||||
weight: 202
|
||||
related:
|
||||
- /influxdb3/explorer/manage-tokens/
|
||||
source: /shared/influxdb3-admin/tokens/_index.md
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -10,6 +10,9 @@ menu:
|
|||
parent: Manage tokens
|
||||
name: Admin tokens
|
||||
weight: 101
|
||||
cascade:
|
||||
related:
|
||||
- /influxdb3/explorer/manage-tokens/
|
||||
influxdb3/enterprise/tags: [tokens]
|
||||
source: /shared/influxdb3-admin/tokens/admin/_index.md
|
||||
---
|
||||
|
|
|
|||
|
|
@ -1,35 +1,38 @@
|
|||
---
|
||||
title: Manage databases with InfluxDB 3 Explorer
|
||||
seotitle: Manage InfluxDB databases with InfluxDB 3 Explorer
|
||||
description: >
|
||||
Use InfluxDB 3 Explorer to manage databases in an InfluxDB 3 instance.
|
||||
menu:
|
||||
influxdb3_explorer:
|
||||
name: Manage Databases
|
||||
draft: true
|
||||
name: Manage databases
|
||||
weight: 4
|
||||
related:
|
||||
- /influxdb3/core/admin/databases/, Manage databases in InfluxDB 3 Core
|
||||
- /influxdb3/enterprise/admin/databases/, Manage databases in InfluxDB 3 Enterprise
|
||||
---
|
||||
|
||||
<!--
|
||||
MARKED AS DRAFT.
|
||||
SAVING CONTENT FOR A FUTURE PR.
|
||||
-->
|
||||
|
||||
## View databases
|
||||
|
||||
## Create a database
|
||||
{{% product-name %}} lets you manage databases in your InfluxDB 3 Core instance
|
||||
or InfluxDB 3 Enterprise cluster.
|
||||
|
||||
> [!Important]
|
||||
> Using {{% product-name %}} to create a database in InfluxDB 3 requires that
|
||||
> Using {{% product-name %}} to manage a database in InfluxDB 3 requires that
|
||||
> Explorer is running in [admin mode](/influxdb3/explorer/install/#run-in-query-or-admin-mode)
|
||||
> and that the token used in the InfluxDB 3 server configuration is an
|
||||
> [admin token](/influxdb3/enterprise/admin/tokens/admin/).
|
||||
|
||||
To use {{% product-name %}} to create a new database in an InfluxDB 3 instance:
|
||||
To manage databases, navigate to **Manage Databases** in Explorer.
|
||||
This page provides a list of databases in the connected InfluxDB 3 server that
|
||||
contains the database name, retention period, and number of tables
|
||||
(which includes system tables).
|
||||
|
||||
1. Navigate to **Manage Databases**.
|
||||
2. Click **+ Create New**.
|
||||
3. Provide a **Database name**.
|
||||
## Create a database
|
||||
|
||||
1. On the **Manage Databases** page, click **+ Create New**.
|
||||
2. Provide a **Database name**.
|
||||
_For information about naming restrictions, see
|
||||
[InfluxDB 3 naming restrictions](/influxdb3/enterprise/admin/databases/create/#database-naming-restrictions)._
|
||||
4. _(Optional)_ Specify a **Retention Period** for the database.
|
||||
3. _(Optional)_ Specify a **Retention Period** for the database.
|
||||
This determines how long InfluxDB retains data (based on timestamp) in the
|
||||
database before expiring and removing the data. If no retention period is
|
||||
specified, InfluxDB does not expire data in the database.
|
||||
|
|
@ -39,6 +42,12 @@ To use {{% product-name %}} to create a new database in an InfluxDB 3 instance:
|
|||
- **Retention Period**: The number of time units to retain data.
|
||||
- **Unit**: The unit of time to use in the retention period definition.
|
||||
|
||||
5. Click **{{< icon "check" >}} Create Database**.
|
||||
4. Click **{{< icon "check" >}} Create Database**.
|
||||
|
||||
## Delete a database
|
||||
## Delete a database
|
||||
|
||||
1. On the **Manage Databases** page, click **{{< icon "trash" >}}**.
|
||||
2. Confirm that you want to delete the database.
|
||||
|
||||
> [!Caution]
|
||||
> Deleting a database is a destructive action and cannot be undone.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,104 @@
|
|||
---
|
||||
title: Manage tokens with InfluxDB 3 Explorer
|
||||
seotitle: Manage InfluxDB tokens with InfluxDB 3 Explorer
|
||||
description: >
|
||||
Use InfluxDB 3 Explorer to manage authorization tokens for an InfluxDB 3 instance.
|
||||
menu:
|
||||
influxdb3_explorer:
|
||||
name: Manage tokens
|
||||
weight: 4
|
||||
related:
|
||||
- /influxdb3/core/admin/tokens/, Manage tokens in InfluxDB 3 Core
|
||||
- /influxdb3/enterprise/admin/tokens/, Manage tokens in InfluxDB 3 Enterprise
|
||||
---
|
||||
|
||||
{{% product-name %}} lets you manage authorization tokens for your InfluxDB 3
|
||||
Core instance or InfluxDB 3 Enterprise cluster.
|
||||
|
||||
> [!Important]
|
||||
> Using {{% product-name %}} to manage authorization tokens in InfluxDB 3 requires that
|
||||
> Explorer is running in [admin mode](/influxdb3/explorer/install/#run-in-query-or-admin-mode)
|
||||
> and that the token used in the InfluxDB 3 server configuration is an
|
||||
> [admin token](/influxdb3/enterprise/admin/tokens/admin/).
|
||||
|
||||
To manage InfluxDB authorization tokens, navigate to **Manage Tokens** in Explorer.
|
||||
This page provides a list of databases in the connected InfluxDB 3 server that
|
||||
contains the database name, retention period, and number of tables
|
||||
(which includes system tables).
|
||||
|
||||
## Create a token
|
||||
|
||||
Use {{% product-name %}} to create an admin token or a resource token
|
||||
_(Enterprise only)_ for your InfluxDB 3 instance or cluster.
|
||||
|
||||
For more information about InfluxDB tokens, see:
|
||||
|
||||
- [Manage tokens in InfluxDB 3 Core](/influxdb3/core/admin/tokens/)
|
||||
- [Manage tokens in InfluxDB 3 Enterprise](/influxdb3/enterprise/admin/tokens/)
|
||||
|
||||
{{< tabs-wrapper >}}
|
||||
{{% tabs %}}
|
||||
[Admin Token](#)
|
||||
[Resource Token _(Enterprise only)_](#)
|
||||
{{% /tabs %}}
|
||||
{{% tab-content %}}
|
||||
|
||||
<!----------------------------- BEGIN ADMIN TOKEN ----------------------------->
|
||||
|
||||
To create an _admin_ token:
|
||||
|
||||
1. On the **Manage Databases** page, click **+ Create New**.
|
||||
2. Select **Admin Token** to create an admin token.
|
||||
3. Provide a **Token Name**.
|
||||
4. Click **Create Admin Token**.
|
||||
5. Copy the generated token string and store it in a secure place.
|
||||
|
||||
<!------------------------------ END ADMIN TOKEN ------------------------------>
|
||||
|
||||
{{% /tab-content %}}
|
||||
{{% tab-content %}}
|
||||
|
||||
<!---------------------------- BEGIN RESOURCE TOKEN --------------------------->
|
||||
|
||||
To create a _resource_ token with read or write permissions for specific databases:
|
||||
|
||||
1. On the **Manage Databases** page, click **+ Create New**.
|
||||
2. Select **Database Token** to create a resource token _(InfluxDB 3 Enterprise only)_.
|
||||
3. Provide a **Token Name**.
|
||||
4. _(Optional)_ Select a **Token Expiry**.
|
||||
5. Select **Database Permissions** to assign to the token.
|
||||
|
||||
To grant the token read or write permissions on all databases, select the
|
||||
_Read_ and _Write_ column headings.
|
||||
To grant permissions for specific databases, select the checkboxes next
|
||||
to each respective database name.
|
||||
|
||||
6. Copy the generated token string and store it in a secure place.
|
||||
|
||||
<!----------------------------- END RESOURCE TOKEN ---------------------------->
|
||||
|
||||
{{% /tab-content %}}
|
||||
{{< /tabs-wrapper >}}
|
||||
|
||||
> [!Note]
|
||||
> #### Store tokens in a secure secret store
|
||||
>
|
||||
> This is the _only_ time you are able to view and copy the raw token string.
|
||||
> We recommend storing tokens in a **secure secret store**.
|
||||
|
||||
|
||||
## Delete a token
|
||||
|
||||
On the **Manage Databases** page, click the **{{< icon "trash" >}}** button
|
||||
on the row of the token you want to delete.
|
||||
|
||||
> [!Caution]
|
||||
> Deleting a token is a destructive action and cannot be undone.
|
||||
> Any clients using the deleted token will no longer be able to access your
|
||||
> InfluxDB 3 instance.
|
||||
|
||||
> [!Note]
|
||||
> #### You cannot delete the _admin token
|
||||
>
|
||||
> When using InfluxDB 3 Enterprise, the first token created in the cluster is
|
||||
> named `_admin`. This functions as the "operator" token and cannot be deleted.
|
||||
Loading…
Reference in New Issue