Check out v4 of the Fauna CLI
v4 of the Fauna CLI is now GA. The new version introduces enhancements to the developer experience, including an improved authentication workflow. To get started, check out the CLI v4 quick start. Migrating from v3 of the CLI? See the CLI migration guide. |
database.replace()
Learn: Databases and multi-tenancy |
---|
Replace a child database's metadata and settings.
Description
Replaces all fields in a child
database's metadata and settings, represented as an
Database
document, with fields
from a provided data object. Fields not present in the data object, excluding
the coll
and ts
metadata fields, are removed.
Fauna stores child databases as documents in the parent database’s
Database
system collection.
Database
documents have the DatabaseDef type.
Database backups
You can’t use this method to enable or disable backups on a child database. You can only enable or disable backups in the Fauna Dashboard. See Database backup and restore .
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
data |
Fields for the
For supported document fields, see
The object can’t include the following metadata fields:
|
Examples
Database.byName("childDB")!.replace({name: "childDB2"})
{
name: "childDB2",
coll: Database,
ts: Time("2099-06-24T21:54:13.225Z"),
global_id: "ysjpyeykhyyr4"
}
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!