create-database

Creates a database.

Syntax

fauna create-database DBNAME [--url <value>] [--timeout <value>] [--secret <value>] [--endpoint <value>] [--environment <value>]

Description

The create-database command creates a database with the provided database name.

If command line options are omitted, Fauna uses the default configuration file options.

Create a top-level database

To create a top-level database using create-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 create a child database using create-database, you must use an authentication secret scoped to the parent database.

Arguments

Argument Description

DBNAME

Database name.

Options

Option Description

--endpoint

Connection endpoint from ~/.fauna-shell.

--environment

Environment to use, from a Fauna project.

--help

Help for create-database command.

--secret

Secret key. Overrides the secret in ~/.fauna-shell.

--timeout

Connection timeout (milliseconds).

--url

Database URL. Overrides the URL in ~/.fauna-shell.

Examples

Create a top-level database

To create a top-level database named ECommerce:

fauna create-database ECommerce

If you’re using a .fauna-project file and want to create a top-level database, add --environment='':

fauna create-database --environment='' <DATABASE_NAME>

To create a top-level database, you must use a secret scoped to the account’s top-level context. To create this secret and use it by default, use the cloud-login command.

Create a child database

To create a child database, you must use a secret scoped to the parent database. You can pass a secret using --secret.

The following command creates a child database named childDB:

fauna create-database --secret='fn...' childDB

See also

list-databases
delete-database

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!