list-databases

Lists child databases in the current database.

fauna list-databases

Description

The list-databases command lists child databases. If you don’t pass any options at the command line, FaunaDB uses the default options specified in the fauna-shell configuration file.

Options

Option Description

--domain=<domain>

Optional - The FaunaDB server domain, that is, the hostname where FaunaDB is running. Defaults to db.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 FaunaDB, 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

fauna list-databases
listing databases
my_test_db

To verify this, run fauna shell and query for a list of databases; you see that the child database my_test_db is listed:

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

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!