ALTER DATABASE

Warning:
As of May 16, 2023, CockroachDB v21.2 is no longer supported. For more details, refer to the Release Support Policy.

The ALTER DATABASE statement applies a schema change to a database. For information on using ALTER DATABASE, see the pages for its relevant subcommands.

Note:

The ALTER DATABASE statement performs a schema change. For more information about how online schema changes work in CockroachDB, see Online Schema Changes.

Subcommands

Subcommand Description
CONFIGURE ZONE Configure replication zones for a database.
CONVERT TO SCHEMA Convert a database to a schema.
OWNER TO Change the owner of a database.
RENAME TO Change the name of a database.
ADD REGION Add a region to a multi-region database.
DROP REGION Drop a region from a multi-region database.
SET PRIMARY REGION Set the primary region of a multi-region database.
SET {session variable} New in v21.2: Set the default session variable values for the database. This syntax is identical to ALTER ROLE ALL IN DATABASE SET {session variable}.
RESET {session variable} New in v21.2: Reset the default session variable values for the database to the system defaults. This syntax is identical to ALTER ROLE ALL IN DATABASE RESET {session variable}.
SURVIVE {ZONE,REGION} FAILURE Add a survival goal to a multi-region database.

Viewing schema changes

This schema change statement is registered as a job. You can view long-running jobs with SHOW JOBS.


Yes No