delete-database
Deletes a database.
Syntax
fauna delete-database DBNAME [--url <value>] [--timeout <value>] [--secret <value>] [--endpoint <value>] [--environment <value>]
Description
The delete-database command deletes a database.
Create a top-level database
To delete a top-level database using delete-database, you must use an
authentication secret scoped to
the account’s top-level context. You can create a top-level secret using the
fauna cloud-login command.
Create a child database
To delete a child database using delete-database, you must use an
authentication secret scoped to
the parent database.
Considerations
When you delete a database, its data becomes inaccessible and is asynchronously deleted. As part of the deletion process, Fauna recursively deletes:
-
Any keys scoped to the database.
-
The database’s child databases, including any nested databases.
Deleting a database with a large number of keys can exceed Transactional Write Ops throughput limits and cause errors with a 429 HTTP status code.
Deleting a database with a large number of child databases can cause errors with a 440 HTTP status code.
To avoid throttling or timeouts, incrementally delete all keys and child databases before deleting the database. See delete all keys and delete all child databases.
Options
| Option | Description |
|---|---|
|
Connection endpoint from |
|
Environment to use, from a Fauna project. |
|
Help for |
|
Secret key. Overrides the secret in |
|
Connection timeout (milliseconds). |
|
Database URL. Overrides the URL in |
Is this article helpful?
Tell Fauna how the article can be improved:
Visit Fauna's forums
or email docs@fauna.com
Thank you for your feedback!