Add an Amazon Web Services Region to a keyspace in Amazon Keyspaces
You can add a new Amazon Web Services Region to a keyspace that is either a single or a multi-Region keyspace. The new replica Region is applied to all tables in the keyspace.
To change a single-Region to a multi-Region keyspace, you have to enable client-side timestamps for all tables in the keyspace. For more information, see Client-side timestamps in Amazon Keyspaces.
If you're adding an additional Region to a multi-Region keyspace, Amazon Keyspaces has to
replicate the existing table(s) into the new Region using a one-time cross-Region
restore for each existing table. The restore charges for each table are billed per GB,
for more information see Backup and restore
You can use the ALTER KEYSPACE
statement in CQL, the update-keyspace
command with the Amazon CLI, or
the console to add a new Region to a single or to a multi-Region keyspace in Amazon Keyspaces.
In order to run the statement successfully, the account you're using has to be located in one of the Regions where the keyspace is already
available. While the replica is being added, you can't perform any other data definition language (DDL) operations on the resources that are
being updated and replicated.
For more information about the permissions required to add a Region, see Configure the IAM permissions required to add an Amazon Web Services Region to a keyspace.
Note
When adding an additional Region to a single-Region keyspace, Amazon Keyspaces creates a service-linked role
with the name AWSServiceRoleForAmazonKeyspacesReplication
in
your account. This role allows Amazon Keyspaces to replicate tables to new Regions and to replicate writes from one table
to all replicas of a multi-Region table on your behalf. To learn more, see Using roles for Amazon Keyspaces Multi-Region Replication.