delete-database

Deletes a child database from the current database.

fauna delete-database DBNAME

Description

The delete-database command deletes a child database. If you don’t pass any options at the command line, Fauna uses the default options specified in the fauna-shell configuration file.

This command deletes the database and all of its contents.
It is not possible to use this command to delete a parent or peer database. To delete a database outside of the current database, use the Fauna Dashboard.

Arguments

Argument Description

DBNAME

The name of the database to delete.

Options

Option Description

--domain=<domain>

Optional - The Fauna server domain, that is, the hostname where Fauna is running. Defaults to db.fauna.com.
Since the introduction of Region Groups, three cloud domains are available. Use the correct domain for your database’s Region Group.
Classic (US and EU): db.fauna.com
United States (US): db.us.fauna.com
Europe (EU): db.eu.fauna.com

--endpoint=<endpoint>

Optional - The name of the endpoint to use for the command.

--port=<port>

Optional - The connection port. Defaults to 8443.

--scheme=<scheme>

Optional - The connection scheme. Must be one of https or http. Defaults to https.

--secret=<secret>

Optional - The secret to use. A secret authenticates your connection to Fauna, and connects you to a specific database.

--timeout=<timeout>

Optional - The connection timeout, an integer number of milliseconds. When the specified period has elapsed, fauna-shell stops waiting for a response and displays an error.

The default is zero, which means that fauna-shell waits until a response is received.

Examples

Assume that the current database has only one child database, my_test_db. To delete it, run:

fauna delete-database my_test_db
deleting database 'my_test_db'
database 'my_test_db' deleted

To verify that the database was deleted, run fauna shell and query the list of child databases; you see that there are now none:

fauna shell
Connected to https://db.fauna.com
Type Ctrl+D or .exit to exit the shell
Paginate(Databases())
{ data: [] }

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve!
Visit Fauna's Discourse forums or email docs@fauna.com

Thank you for your feedback!