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/influxdb3/clustered/admin/databases/undelete.md

2.7 KiB
Raw Permalink Blame History

title description menu weight list_code_example related
Undelete a database 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.
influxdb3_clustered
parent
Manage databases
204 ```sh influxctl database undelete <DATABASE_NAME> ```
/influxdb3/clustered/reference/cli/influxctl/database/undelete/
/influxdb3/clustered/admin/databases/delete/
/influxdb3/clustered/admin/tokens/database/create/

Use the influxctl database undelete command 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" %}}

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.
  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 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 %}}