As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Adicionar um Região da AWS a um keyspace no Amazon Keyspaces
<a name="keyspaces-multi-region-add-replica"></a>

Você pode adicionar um novo Região da AWS a um espaço de chave que seja um espaço de chave único ou multirregional. A nova região de réplica é aplicada a todas as tabelas no keyspace. 

Para alterar um espaço de chave de região única para um espaço de chave de várias regiões, você precisa habilitar os carimbos de data/hora do lado do cliente para todas as tabelas no espaço de chaves. Para obter mais informações, consulte [Carimbos de data/hora do lado do cliente no Amazon Keyspaces](client-side-timestamps.md).

Se você estiver adicionando uma região adicional a um keyspace multirregional, o Amazon Keyspaces precisa replicar as tabelas existentes na nova região usando uma restauração única entre regiões para cada tabela existente. As taxas de restauração de cada tabela são cobradas por GB. Para obter mais informações, consulte [Backup e restauração na página](https://aws.amazon.com/keyspaces/pricing/#:~:text=per%20GB-month-,Restoring%20a%20table,-Restoring%20a%20table) de preços do Amazon Keyspaces (para Apache Cassandra). Não há cobrança pela transferência de dados entre regiões para essa operação de restauração. Além dos dados, todas as propriedades da tabela, com exceção das tags, serão replicadas para a nova região.

Você pode usar a `ALTER KEYSPACE` instrução no CQL, o `update-keyspace` comando com o AWS CLI ou o console para adicionar uma nova região a um único keyspace ou a um multirregional no Amazon Keyspaces. Para executar o extrato com sucesso, a conta que você está usando precisa estar localizada em uma das regiões onde o espaço chave já está disponível. Enquanto a réplica está sendo adicionada, você não pode realizar nenhuma outra operação de linguagem de definição de dados (DDL) nos recursos que estão sendo atualizados e replicados.

Para obter mais informações sobre as permissões necessárias para adicionar uma região, consulte[Configure as permissões do IAM necessárias para adicionar um Região da AWS a um keyspace](howitworks_replication_permissions_addReplica.md).

**nota**  
Ao adicionar uma região adicional a um keyspace de uma única região, o Amazon Keyspaces cria uma função vinculada ao serviço com o nome em sua conta. `AWSServiceRoleForAmazonKeyspacesReplication` Essa função permite que o Amazon Keyspaces replique tabelas para novas regiões e replique gravações de uma tabela para todas as réplicas de uma tabela multirregional em seu nome. Para saber mais, consulte [Uso de perfis para replicação multirregional do Amazon Keyspaces](using-service-linked-roles-multi-region-replication.md).

------
#### [ Console ]

Siga estas etapas para adicionar uma região a um keyspace usando o console do Amazon Keyspaces.

**Adicionar uma região a um keyspace (console)**

1. [Faça login no Console de gerenciamento da AWS e abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.](https://console.aws.amazon.com/keyspaces/home)

1. No painel de navegação, escolha **Keyspaces** e, em seguida, escolha um keyspace na lista.

1. Escolha a guia **Regiões da AWS**.

1. Na **Regiões da AWS**guia, escolha **Adicionar região**.

1. Na caixa de diálogo **Adicionar região**, escolha a região adicional que você deseja adicionar ao espaço de teclas.

1. Para finalizar, escolha **Adicionar**.

------
#### [ Cassandra Query Language (CQL) ]

**Adicionar uma região a um keyspace usando CQL**
+ Para adicionar uma nova região a um keyspace, você pode usar a seguinte declaração. Neste exemplo, o keyspace já está disponível nas regiões Leste dos EUA (Norte da Virgínia) e Oeste dos EUA (Oregon), e a instrução CQL está adicionando a Região Oeste dos EUA (Norte da Califórnia). 

  ```
  ALTER KEYSPACE my_keyspace
  WITH REPLICATION = {
      'class': 'NetworkTopologyStrategy',
      'us-east-1': '3',
      'us-west-2': '3',
      'us-west-1': '3'
  } AND CLIENT_SIDE_TIMESTAMPS = {'status': 'ENABLED'};
  ```

------
#### [ CLI ]

**Adicione uma região a um espaço de teclas usando a AWS CLI**
+ Para adicionar uma nova região a um keyspace usando a CLI, você pode usar o exemplo a seguir. Observe que o valor padrão para `client-side-timestamps` é `DISABLED`. Com o `update-keyspace` comando, você deve alterar o valor para`ENABLED`.

  ```
  aws keyspaces update-keyspace \
  --keyspace-name my_keyspace \
  --replication-specification '{"replicationStrategy": "MULTI_REGION", "regionList": ["us-east-1", "eu-west-1", "eu-west-3"] }' \
  --client-side-timestamps '{"status": "ENABLED"}'
  ```

------