silos global
Create globally-replicated databases and manage replica regions from the command line.
The silos global command group creates globally-replicated databases — a
primary in one region with read replicas materialized in others — and manages the set
of replica regions over time.
Global databases and replica materialization are rolling out. The commands and APIs exist, but multi-region production availability and global WAL streaming are still maturing. Treat regional replica behavior as a preview and check the Replication overview before depending on it.
silos global <subcommand> [options]global create
Create a global database with a primary region and an optional set of replica regions.
silos global create \
--name my-global-app \
--primary-region iad \
--replicas dal,sfo,fra \
--consistency read-your-writes| Flag | Default | Description |
|---|---|---|
--name <name> | — | Name for the global database. |
--primary-region <code> | iad | Region that holds the writable primary. |
--replicas <codes> | — | Comma-separated replica regions. Also accepts --replicate-to. |
--consistency <model>, -c | read-your-writes | Consistency model: eventual, read-your-writes, or strong. |
See Consistency levels for what each model guarantees.
global list
List your global databases.
silos global listglobal status
Show a global database's details, including the status of each replica region.
silos global status my-global-appThe positional argument is the global database ID or name.
global add-replica
Add a replica region to an existing global database.
silos global add-replica my-global-app sfo| Argument | Description |
|---|---|
<database> | Global database ID or name. |
<region> | Region to add as a replica. |
global remove-replica
Remove a replica region from a global database.
silos global remove-replica my-global-app sfo| Argument | Description |
|---|---|
<database> | Global database ID or name. |
<region> | Region to remove. |
Replicas serve reads locally for low latency; writes always route to the primary region. The freshness a replica can serve depends on the consistency level you choose per query.