71 lines
2.7 KiB
Markdown
71 lines
2.7 KiB
Markdown
---
|
|
title: Undelete a database
|
|
description: >
|
|
Use the [`influxctl database undelete` command](/influxdb3/clustered/reference/cli/influxctl/database/undelete/)
|
|
to restore a previously deleted database in your {{< product-name omit=" Cluster" >}} cluster.
|
|
menu:
|
|
influxdb3_clustered:
|
|
parent: Manage databases
|
|
weight: 204
|
|
list_code_example: |
|
|
```sh
|
|
influxctl database undelete <DATABASE_NAME>
|
|
```
|
|
related:
|
|
- /influxdb3/clustered/reference/cli/influxctl/database/undelete/
|
|
- /influxdb3/clustered/admin/databases/delete/
|
|
- /influxdb3/clustered/admin/tokens/database/create/
|
|
---
|
|
|
|
Use the [`influxctl database undelete` command](/influxdb3/clustered/reference/cli/influxctl/database/undelete/)
|
|
to restore a previously deleted database in your {{< product-name omit=" Cluster" >}} cluster.
|
|
|
|
> [!Important]
|
|
> To undelete a database:
|
|
>
|
|
> - The database name must match the name of the deleted database.
|
|
> - A new database with the same name cannot already exist.
|
|
> - You must have appropriate permissions to manage databases.
|
|
|
|
When you undelete a database, it is restored with the same retention period,
|
|
table limits, and column limits as when it was deleted.
|
|
|
|
> [!Warning]
|
|
> Databases can only be undeleted for
|
|
> {{% show-in "cloud-dedicated" %}}approximately 14 days{{% /show-in %}}{{% show-in "clustered" %}}a configurable "hard-delete" grace period{{% /show-in %}}
|
|
> after they are deleted.
|
|
> After this grace period, all Parquet files associated with the deleted database
|
|
> are permanently removed and the database cannot be undeleted.
|
|
|
|
## Undelete a database using the influxctl CLI
|
|
|
|
{{% code-placeholders "DATABASE_NAME" %}}
|
|
```sh
|
|
influxctl database undelete DATABASE_NAME
|
|
```
|
|
{{% /code-placeholders %}}
|
|
|
|
Replace the following:
|
|
|
|
- {{% code-placeholder-key %}}`DATABASE_NAME`{{% /code-placeholder-key %}}:
|
|
Name of the deleted database to restore
|
|
|
|
## Recreate tokens for the database
|
|
|
|
After successfully undeleting a database:
|
|
|
|
1. **Verify the database was restored** by [listing all databases](/influxdb3/clustered/admin/databases/list/).
|
|
2. **If you previously deleted tokens associated with the deleted database, create new database tokens**
|
|
- Any tokens that existed before deletion are not restored.
|
|
[Create new database tokens](/influxdb3/clustered/admin/tokens/database/create/)
|
|
with appropriate permissions for the restored database.
|
|
3. **Update your applications** to use the new database tokens.
|
|
|
|
{{% note %}}
|
|
#### Undeleted databases retain their original configuration
|
|
|
|
When a database is undeleted, it retains the same database ID, retention period,
|
|
and table/column limits it had before deletion. However, database tokens are not
|
|
restored and must be recreated.
|
|
{{% /note %}}
|