influxdb3 delete database
The influxdb3 delete database command deletes a database.
Usage
influxdb3 delete database [OPTIONS] <DATABASE_NAME>
Arguments
DATABASE_NAME: The name of the database to delete. Valid database names are alphanumeric and start with a letter or number. Dashes (
-) and underscores (_) are allowed.Environment variable:
INFLUXDB3_DATABASE_NAME
Options
| Option | Description | |
|---|---|---|
-H | --host | Host URL of the running InfluxDB 3 Core server (default is http://127.0.0.1:8181) |
--hard-delete | When to hard delete data (never/now/default/timestamp). Default behavior is a soft delete that allows recovery | |
--token | Authentication token | |
--tls-ca | Path to a custom TLS certificate authority (for testing or self-signed certificates) | |
-h | --help | Print help information |
--help-all | Print detailed help information |
Option environment variables
You can use the following environment variables to set command options:
| Environment Variable | Option |
|---|---|
INFLUXDB3_HOST_URL | --host |
INFLUXDB3_AUTH_TOKEN | --token |
Examples
- Delete a database
- Delete a database while specifying the token inline
- Hard delete a database immediately
- Hard delete a database at a specific time
In the examples below, replace the following:
DATABASE_NAME: Database nameAUTH_TOKEN: Authentication token
Delete a database
influxdb3 delete database DATABASE_NAME
Delete a database while specifying the token inline
influxdb3 delete database --token AUTH_TOKEN DATABASE_NAME
Hard delete a database immediately
Permanently delete a database and all its data immediately without the ability to recover.
influxdb3 delete database --hard-delete now DATABASE_NAME
Hard delete a database at a specific time
Schedule a database for permanent deletion at a specific timestamp.
influxdb3 delete database --hard-delete "2024-01-01T00:00:00Z" DATABASE_NAME
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Core and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.