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á.
# Replicação multirregional para Amazon Keyspaces (para Apache Cassandra)
Você pode usar a replicação multirregional do Amazon Keyspaces para replicar seus dados com replicação *ativa-ativa* automatizada, totalmente gerenciada e em todas as áreas de sua escolha. Regiões da AWS Com a replicação ativa-ativa, cada Região é capaz de realizar leituras e gravações isoladamente. Você pode melhorar a disponibilidade e a resiliência da degradação Regional, além de se beneficiar de leituras e gravações locais de baixa latência para aplicativos globais.
Com a replicação multirregional, o Amazon Keyspaces replica dados de forma assíncrona entre regiões, e os dados normalmente são propagados entre regiões em um segundo. Além disso, com a replicação multirregional, você não tem mais o trabalho difícil de resolver conflitos e corrigir problemas de divergência de dados, para que possa se concentrar em seu aplicativo.
Por padrão, o Amazon Keyspaces replica dados em três [zonas de disponibilidade](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) dentro da mesma Região da AWS para maior durabilidade e alta disponibilidade. Com a replicação multirregional, você pode criar espaços de chave multirregionais que replicam suas tabelas em diferentes regiões geográficas de sua escolha. Regiões da AWS
**Topics**
+ [Benefícios do uso da replicação multirregional](#mrr-benefits)
+ [Modos de capacidade e preços](#mrr-pricing)
+ [Como a replicação multirregional funciona no Amazon Keyspaces](multiRegion-replication_how-it-works.md)
+ [Notas de uso da replicação multirregional do Amazon Keyspaces](multiRegion-replication_usage-notes.md)
+ [Configurar a replicação multirregional para Amazon Keyspaces (para Apache Cassandra)](multiRegion-replication-configure.md)
## Benefícios do uso da replicação multirregional
A replicação multirregional oferece os seguintes benefícios.
+ **Leituras e gravações globais com latência de um dígito em milissegundos**: no Amazon Keyspaces, a replicação é ativa-ativa. Você pode fornecer leituras e gravações localmente nas Regiões mais próximas de seus clientes, com latência de um dígito de milissegundos em qualquer escala. Você pode usar tabelas multirregionais do Amazon Keyspaces para aplicações globais que precisam de um tempo de resposta rápido em qualquer lugar do mundo.
+ **Continuidade de negócios aprimorada e proteção contra a degradação em uma única região — Com a replicação** em várias regiões, você pode se recuperar da degradação em uma única região Região da AWS redirecionando seu aplicativo para uma região diferente em seu keyspace multirregional. Como o Amazon Keyspaces oferece replicação ativa-ativa, não há impacto em suas leituras e gravações.
O Amazon Keyspaces acompanhará as gravações executadas em seu espaço de chaves multirregionais que não foram propagadas para todas as Regiões da réplica. Depois que a Região voltar a ficar on-line, o Amazon Keyspaces sincroniza automaticamente todas as alterações ausentes para que você possa se recuperar sem nenhum impacto no aplicativo.
+ **Replicação de alta velocidade entre regiões** — A replicação multirregional usa replicação física rápida e baseada em armazenamento de dados entre regiões, com um atraso de replicação que normalmente é inferior a 1 segundo.
A replicação no Amazon Keyspaces tem pouco ou nenhum impacto em suas consultas de banco de dados porque não compartilha recursos computacionais com seu aplicativo. Isso significa que você pode abordar casos de uso de alto throughput de gravação ou aqueles que apresentam picos ou picos repentinos no throughput sem nenhum impacto no aplicativo.
+ **Consistência e resolução de conflitos**: todas as alterações feitas nos dados em qualquer Região são replicadas para as outras Regiões em um espaço chave multirregional. Conflitos poderão ocorrer se as aplicações atualizarem o mesmo item em Regiões diferentes e quase ao mesmo tempo.
Para ajudar a fornecer consistência eventual, o Amazon Keyspaces usa a data e a hora em nível de célula e um *último gravador obtém* a reconciliação entre atualizações simultâneas. A resolução de conflitos é totalmente gerenciada e ocorre em segundo plano, sem nenhum impacto no aplicativo.
Para obter mais informações sobre configurações e atributos compatíveis, consulte [Notas de uso da replicação multirregional do Amazon Keyspaces](multiRegion-replication_usage-notes.md).
## Modos de capacidade e preços
Para um espaço de chaves multirregional, você pode usar o *modo de capacidade sob demanda* ou o *modo de capacidade provisionada*. Para obter mais informações, consulte [Configurar modos de read/write capacidade no Amazon Keyspaces](ReadWriteCapacityMode.md).
No modo sob demanda, você paga 1 unidade de solicitação de gravação (WRU) para gravar até 1 KB de dados por linha, da mesma forma que nas tabelas de uma única região. Mas você é cobrado pelas gravações em cada região do seu keyspace multirregional. Por exemplo, escrever uma linha de 3 KB de dados em um keyspace multirregional com duas regiões requer 6 WRUs: 3 \$1 2 = 6. WRUs Além disso, gravações que incluem dados estáticos e não estáticos exigem operações adicionais de gravação.
No modo provisionado, você paga 1 unidade de capacidade de gravação (WCU) para gravar até 1 KB de dados por linha, da mesma forma que nas tabelas de uma única região. Mas você é cobrado pelas gravações em cada região do seu keyspace multirregional. Por exemplo, escrever uma linha de 3 KB de dados por segundo em um keyspace multirregional com duas regiões exige 6 WCUs: 3 \$1 2 = 6. WCUs Além disso, gravações que incluem dados estáticos e não estáticos exigem operações adicionais de gravação.
Para obter mais informações sobre preços, consulte o [Amazon Keyspaces (para Apache Cassandra)](https://aws.amazon.com/keyspaces/pricing).
# Como a replicação multirregional funciona no Amazon Keyspaces
Esta seção fornece uma visão geral de como a replicação multirregional do Amazon Keyspaces funciona. Para obter mais informações sobre preços, consulte o [Amazon Keyspaces (para Apache Cassandra)](https://aws.amazon.com/keyspaces/pricing).
**Topics**
+ [Como a replicação multirregional funciona no Amazon Keyspaces](#multiRegion-replication_how-it-works-overview)
+ [Resolução de conflitos de replicação em várias regiões](#multiRegion-replication_how-it-works-conflict-resolution)
+ [Recuperação de desastres de replicação em várias regiões](#howitworks_disaster_recovery)
+ [A replicação multirregional está Regiões da AWS desativada por padrão](#howitworks_mrr_opt_in)
+ [Replicação multirregional e integração com point-in-time recuperação (PITR)](#howitworks_mrr_pitr)
+ [Replicação e integração em várias regiões com serviços AWS](#howitworks_integration)
## Como a replicação multirregional funciona no Amazon Keyspaces
A replicação multirregional do Amazon Keyspaces implementa uma arquitetura de resiliência de dados que distribui seus dados de forma independente e distribuída geograficamente. Regiões da AWS Ele usa *replicação ativa-ativa*, que fornece baixa latência local, com cada região sendo capaz de realizar leituras e gravações isoladamente.
Ao criar um keyspace multirregional do Amazon Keyspaces, você pode selecionar regiões adicionais para as quais os dados serão replicados. Cada tabela criada em um espaço de chaves multirregional consiste em várias tabelas-réplica (uma por Região) que o Amazon Keyspaces considera como uma única unidade.
Cada réplica possui o mesmo nome de tabela e o mesmo esquema de chave primária. Quando uma aplicação grava dados em uma tabela local em uma Região, os dados são gravados de forma permanente usando o nível de consistência `LOCAL_QUORUM`. O Amazon Keyspaces replica automaticamente os dados de forma assíncrona para as outras Regiões de replicação. O atraso de replicação entre Regiões geralmente é inferior a um segundo e não afeta o desempenho nem o throughput do seu aplicativo.
Depois que os dados forem gravados, você poderá lê-los na tabela multirregional em outra Região de replicação com os níveis de consistência `LOCAL_ONE/LOCAL_QUORUM`. Para obter mais informações sobre configurações e atributos compatíveis, consulte [Notas de uso da replicação multirregional do Amazon Keyspaces](multiRegion-replication_usage-notes.md).
![\[Os usuários estão lendo e gravando dados armazenados em uma tabela do Amazon Keyspaces localmente em suas respectivas tabelas, enquanto o Região da AWS Amazon Keyspaces replica de forma assíncrona as gravações entre tabelas em todas as regiões disponíveis.\]](http://docs.aws.amazon.com/pt_br/keyspaces/latest/devguide/images/keyspaces_multi_Region_replication.png)
## Resolução de conflitos de replicação em várias regiões
A replicação multirregional do Amazon Keyspaces é totalmente gerenciada, o que significa que você não precisa realizar tarefas de replicação, como executar regularmente operações de reparo para resolver problemas de sincronização de dados. O Amazon Keyspaces monitora a consistência de dados entre tabelas em diferentes, Regiões da AWS detectando e reparando conflitos, e sincroniza réplicas automaticamente.
O Amazon Keyspaces usa o método de reconciliação de dados do *último gravador vence*. Com esse mecanismo de resolução de conflitos, todas as Regiões em um espaço de chaves multirregional concordam com a atualização mais recente e convergem para um estado em que todas possuem dados idênticos. O processo de reconciliação não tem impacto no desempenho do aplicativo. Para apoiar a resolução de conflitos, a data e a hora do lado do cliente são ativadas automaticamente para tabelas multirregionais e não podem ser desativadas. Para obter mais informações, consulte [Carimbos de data/hora do lado do cliente no Amazon Keyspaces](client-side-timestamps.md).
## Recuperação de desastres de replicação em várias regiões
Com a replicação multirregional do Amazon Keyspaces, as gravações são replicadas de forma assíncrona em cada região. No caso raro de degradação ou falha em uma única região, a replicação em várias regiões ajuda você a se recuperar de um desastre com pouco ou nenhum impacto em seu aplicativo. A recuperação de desastres é normalmente medida usando valores de objetivo de tempo de recuperação (RTO) e objetivo de ponto de recuperação (RPO).
**Objetivo de tempo de recuperação**: o tempo que um sistema leva para retornar a um estado de trabalho após um desastre. O RTO mede a quantidade de tempo de inatividade sua workload pode tolerar, medida em tempo. Para planos de recuperação de desastres que usam replicação multirregional para fazer failover para uma região não afetada, o RTO pode ser quase zero. O RTO é limitado pela rapidez com que seu aplicativo pode detectar a condição de falha e redirecionar o tráfego para outra Região.
**Objetivo de ponto de recuperação**: a quantidade de dados que podem ser perdidos (medidos no tempo). Para planos de recuperação de desastres que usam replicação multirregional para fazer failover para uma região não afetada, o RPO geralmente é de um dígito de segundos. O RPO é limitado pela latência de replicação para a réplica de destino do failover.
No caso de uma falha ou degradação Regional, você não precisa promover uma região secundária ou realizar procedimentos de failover do banco de dados porque a replicação no Amazon Keyspaces é ativa-ativa. Em vez disso, você pode usar o Amazon Route 53 para encaminhar a aplicação para a Região íntegra mais próxima. Para saber mais sobre o Route 53, consulte [O que é o Amazon Route 53?](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/Welcome.html) .
Se uma única Região da AWS ficar isolada ou degradada, seu aplicativo poderá redirecionar o tráfego para uma região diferente usando o Route 53 para realizar leituras e gravações em uma tabela de réplica diferente. Você também pode aplicar lógica de negócios personalizada para determinar quando redirecionar solicitações para outras regiões. Um exemplo disso é tornar seu aplicativo ciente dos vários endpoints disponíveis.
Quando a Região voltar a ficar online, o Amazon Keyspaces retomará a propagação de todas as gravações pendentes dessa região para as tabelas-réplica nas outras regiões. Ele também retomará a propagação de gravações de outras tabelas-réplica para a região que está online novamente.
## A replicação multirregional está Regiões da AWS desativada por padrão
A replicação multirregional do Amazon Keyspaces é suportada nas seguintes opções, Regiões da AWS que são desativadas por padrão:
+ Região África (Cidade do Cabo)
+ Região do Oriente Médio (Emirados Árabes Unidos)
+ Região Ásia-Pacífico (Hong Kong)
+ Região Oriente Médio (Bahrein)
Antes de usar uma região que está desativada por padrão com a replicação multirregional do Amazon Keyspaces, primeiro você precisa habilitar a região. Para obter mais informações, consulte [Ativar ou desativar Regiões da AWS em sua conta](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) no [https://docs.aws.amazon.com/organizations/latest/userguide/](https://docs.aws.amazon.com/organizations/latest/userguide/).
Depois de habilitar uma região, você pode criar novos recursos do Amazon Keyspaces na região e adicionar a região a um keyspace multirregional.
Quando você desativa uma região que é usada pela replicação multirregional do Amazon Keyspaces, o Amazon Keyspaces inicia um período de carência de 24 horas. Durante essa janela de tempo, você pode esperar o seguinte comportamento:
+ O Amazon Keyspaces continua realizando operações de linguagem de manipulação de dados (DML) em regiões habilitadas.
+ O Amazon Keyspaces pausa a replicação de atualizações de dados das regiões habilitadas para a região desativada.
+ O Amazon Keyspaces bloqueia todas as solicitações de linguagem de definição de dados (DDL) na região desativada.
Se você desativou a região por engano, poderá reativá-la em 24 horas. Se você reativar a região durante o período de carência de 24 horas, o Amazon Keyspaces tomará as seguintes medidas:
+ Retomar automaticamente todas as replicações para a região reativada.
+ Replique todas as atualizações de dados que ocorreram nas regiões habilitadas enquanto a região estava desativada para garantir a consistência dos dados.
+ Continue com todas as operações adicionais de replicação em várias regiões automaticamente.
Caso a região permaneça desativada após o fechamento da janela de 24 horas, o Amazon Keyspaces toma as seguintes ações para remover permanentemente a região da replicação multirregional:
+ Remova a região desativada de todos os espaços de chave de replicação multirregional.
+ Converta réplicas de tabelas de replicação multirregional na região desativada em tabelas e espaços chave de região única.
+ O Amazon Keyspaces não exclui nenhum recurso da região desativada.
Depois que o Amazon Keyspaces remover permanentemente a região desativada do keyspace multirregional, você não poderá adicionar a região desativada novamente.
## Replicação multirregional e integração com point-in-time recuperação (PITR)
Point-in-time a recuperação é suportada para tabelas multirregionais. Para restaurar com êxito uma tabela multirregional com PITR, as seguintes condições devem ser atendidas.
+ As tabelas de origem e de destino devem ser configuradas como tabelas multirregionais.
+ As Regiões de replicação para o espaço de chaves da tabela de origem e para o espaço de chaves da tabela de destino devem ser as mesmas.
+ A PITR deve estar habilitada em todas as réplicas da tabela de origem.
Você pode executar a instrução de restauração de qualquer uma das Regiões em que a tabela de origem está disponível. O Amazon Keyspaces restaura automaticamente a tabela de destino em cada Região. Para ter mais informações sobre o PITR, consulte [Como point-in-time a recuperação funciona no Amazon Keyspaces](PointInTimeRecovery_HowItWorks.md).
Quando você cria uma tabela multirregional, as configurações de PITR que você define durante o processo de criação são aplicadas automaticamente a todas as tabelas em todas as regiões. Quando você altera as configurações de PITR usando`ALTER TABLE`, o Amazon Keyspaces aplica a atualização somente à tabela local e não às réplicas em outras regiões. Para habilitar a PITR para uma tabela multirregional existente, você precisa repetir a `ALTER TABLE` instrução para todas as réplicas.
## Replicação e integração em várias regiões com serviços AWS
Você pode monitorar o desempenho da replicação entre tabelas diferentes Regiões da AWS usando CloudWatch métricas da Amazon. A métrica a seguir fornece monitoramento contínuo de espaços de chaves multirregionais.
+ `ReplicationLatency`: essa métrica mede o tempo necessário para replicar `updates`, `inserts` ou `deletes` de uma tabela de réplica para outra tabela de réplica em um espaço de chaves multirregional.
Para obter mais informações sobre como monitorar CloudWatch métricas, consulte[Monitorando o Amazon Keyspaces com a Amazon CloudWatch](monitoring-cloudwatch.md).
# Notas de uso da replicação multirregional do Amazon Keyspaces
Considere o seguinte ao usar a replicação multirregional com o Amazon Keyspaces.
+ Você pode selecionar qualquer um dos [públicos disponíveis](programmatic.endpoints.md#global_endpoints) Regiões da AWS. Para obter mais informações sobre [os Regiões da AWS que estão desativados por padrão](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable), consulte[A replicação multirregional está Regiões da AWS desativada por padrão](multiRegion-replication_how-it-works.md#howitworks_mrr_opt_in).
+ AWS GovCloud (US) Regions e as regiões da China não são suportadas.
+ Considere as seguintes soluções alternativas até que os recursos estejam disponíveis:
Configure a vida útil (TTL) ao criar a tabela multirregional. Você não poderá ativar e desativar a TTL nem ajustar o valor da TTL posteriormente. Para obter mais informações, consulte [Dados expirados com vida útil (TTL) para Amazon Keyspaces (para Apache Cassandra)](TTL.md).
+ Para criptografia em repouso, use uma AWS chave própria. No momento, as chaves gerenciadas pelo cliente não são compatíveis com tabelas multirregionais. Para obter mais informações, consulte .
[Criptografia em repouso: como funciona no Amazon Keyspaces](encryption.howitworks.md).
+ Você pode usar `ALTER KEYSPACE` para adicionar uma região a um espaço de chave de região única ou multirregião. Para obter mais informações, consulte [Adicionar um Região da AWS a um keyspace no Amazon Keyspaces](keyspaces-multi-region-add-replica.md).
+ Antes de adicionar uma região a um espaço de chave de região única, certifique-se de que nenhuma tabela abaixo do espaço de chaves esteja configurada com chaves gerenciadas pelo cliente.
+ Todas as tags existentes configuradas para espaços de chave ou tabelas não são replicadas para a nova região.
+ Ao usar o gerenciamento de capacidade provisionada com o ajuste de escala automático do Amazon Keyspaces, certifique-se de usar as operações da API do Amazon Keyspaces para criar e configurar suas tabelas multirregionais. As operações subjacentes da API Application Auto Scaling que o Amazon Keyspaces chama em seu nome não têm recursos multirregionais.
Para obter mais informações, consulte [Atualize a capacidade provisionada e as configurações de ajuste de escala automático para uma tabela multirregional no Amazon Keyspaces](tables-mrr-autoscaling.md). Para obter mais informações sobre como estimar o throughput da capacidade de gravação de tabelas multirregionais provisionadas, consulte [Estimar e provisionar a capacidade para uma tabela multirregional no Amazon Keyspaces](tables-multi-region-capacity.md).
+ Embora os dados sejam replicados automaticamente nas Regiões selecionadas de uma tabela multirregional, quando um cliente se conecta a um endpoint em uma Região e consulta a tabela `system.peers`, a consulta retorna somente informações locais. O resultado da consulta aparece como um único cluster de datacenter para o cliente.
+ A replicação multirregional do Amazon Keyspaces é assíncrona e oferece suporte à consistência para gravações. `LOCAL_QUORUM` `LOCAL_QUORUM`a consistência exige que uma atualização em uma linha seja mantida de forma duradoura em duas réplicas na região local antes de retornar o sucesso ao cliente. A propagação das gravações na(s) Região(ões) replicada(s) é então executada de forma assíncrona.
A replicação multirregional do Amazon Keyspaces não oferece suporte à replicação síncrona nem à consistência. `QUORUM`
+ Quando você cria uma tabela ou espaço de chaves multirregional, todas as tags que você define durante o processo de criação são aplicadas automaticamente a todos os espaços de chaves e tabelas em todas as Regiões. Quando você altera as tags existentes usando `ALTER KEYSPACE` ou `ALTER TABLE`, a atualização é aplicada somente ao espaço de chaves ou à tabela na Região em que você está fazendo a alteração.
+ A Amazon CloudWatch fornece uma `ReplicationLatency` métrica para cada região replicada. Ele calcula essa métrica rastreando as linhas que chegam, comparando o tempo de chegada com o tempo de gravação inicial e calculando uma média. Os horários são armazenados CloudWatch na região de origem. Para obter mais informações, consulte [Monitorando o Amazon Keyspaces com a Amazon CloudWatch](monitoring-cloudwatch.md).
Pode ser útil exibir os tempos médios e máximos para determinar o atraso médio e o maior atraso de replicação. Não há SLA sobre essa latência.
+ Ao usar uma tabela multirregional no modo sob demanda, você poderá observar um aumento na latência da replicação assíncrona de gravações se uma réplica de tabela apresentar um novo pico de tráfego. Da mesma forma que o Amazon Keyspaces adapta automaticamente a capacidade de uma tabela sob demanda de uma única região ao tráfego do aplicativo que ela recebe, o Amazon Keyspaces adapta automaticamente a capacidade de uma réplica de tabela sob demanda de várias regiões ao tráfego que ela recebe. O aumento na latência de replicação é transitório porque o Amazon Keyspaces aloca automaticamente mais capacidade à medida que o volume de tráfego aumenta. Depois que todas as réplicas se adaptarem ao seu volume de tráfego, a latência da replicação deverá voltar ao normal. Para obter mais informações, consulte [Tráfego de pico e propriedades de dimensionamento](ReadWriteCapacityMode.OnDemand.md#ReadWriteCapacityMode.PeakTraffic).
+ Ao usar uma tabela multirregional no modo provisionado, se seu aplicativo exceder a capacidade de throughput provisionada, você poderá observar erros de capacidade insuficientes e um aumento na latência de replicação. Para garantir que sempre haja capacidade suficiente de leitura e gravação para todas as réplicas Regiões da AWS de tabelas em toda uma tabela multirregional, recomendamos que você configure o escalonamento automático do Amazon Keyspaces. O ajuste de escala automático do Amazon Keyspaces ajuda você a provisionar a capacidade de throughput de forma eficiente para workloads variáveis, ajustando automaticamente a capacidade de throughput em resposta ao tráfego real do aplicativo. Para obter mais informações, consulte [Como o ajuste de escala automático funciona para tabelas multirregionais](autoscaling.md#autoscaling.multi-region).
# Configurar a replicação multirregional para Amazon Keyspaces (para Apache Cassandra)
Você pode usar o console, o Cassandra Query Language (CQL) ou o AWS Command Line Interface para criar e gerenciar tabelas e espaços chave multirregionais no Amazon Keyspaces.
Esta seção fornece exemplos de como criar e gerenciar espaços de chaves e tabelas multirregionais. Todas as tabelas criadas em um espaço de chaves multirregional herdam automaticamente as configurações multirregionais do espaço de chaves.
Para obter mais informações sobre configurações e atributos compatíveis, consulte [Notas de uso da replicação multirregional do Amazon Keyspaces](multiRegion-replication_usage-notes.md).
**Topics**
+ [Configurar permissões de IAM necessárias para criar e espaços de chaves e tabelas multirregionais](howitworks_replication_permissions.md)
+ [Configure as permissões do IAM necessárias para adicionar um Região da AWS a um keyspace](howitworks_replication_permissions_addReplica.md)
+ [Criar um espaço de chaves multirregional no Amazon Keyspaces](keyspaces-mrr-create.md)
+ [Adicionar um Região da AWS a um keyspace no Amazon Keyspaces](keyspaces-multi-region-add-replica.md)
+ [Verifique o progresso da replicação ao adicionar uma nova região a um keyspace](keyspaces-multi-region-replica-status.md)
+ [Criar uma tabela multirregional com as configurações padrão no Amazon Keyspaces](tables-mrr-create-default.md)
+ [Criar uma tabela multirregional no modo provisionado com ajuste de escala automático no Amazon Keyspaces](tables-mrr-create-provisioned.md)
+ [Atualize a capacidade provisionada e as configurações de ajuste de escala automático para uma tabela multirregional no Amazon Keyspaces](tables-mrr-autoscaling.md)
+ [Exibir a capacidade provisionada e as configurações de ajuste de escala automático para uma tabela multirregional no Amazon Keyspaces](tables-mrr-view.md)
+ [Desativar o ajuste de escala automático para uma tabela no Amazon Keyspaces](tables-mrr-autoscaling-off.md)
+ [Definir manualmente a capacidade provisionada de uma tabela multirregional no Amazon Keyspaces](tables-mrr-capacity-manually.md)
# Configurar permissões de IAM necessárias para criar e espaços de chaves e tabelas multirregionais
Para criar tabelas e espaços de chaves multirregionais bem-sucedidos, a entidade principal do IAM precisa ser capaz de criar uma função vinculada ao serviço. Essa função vinculada ao serviço é um tipo exclusivo de perfil do IAM predefinida pelo Amazon Keyspaces. Isso inclui todas as permissões que o Amazon Keyspaces exige para executar ações em seu nome. Para saber mais sobre a função vinculada ao serviço do , consulte [Uso de perfis para replicação multirregional do Amazon Keyspaces](using-service-linked-roles-multi-region-replication.md).
Para criar a função vinculada ao serviço exigida pela replicação multirregional, a política do IAM principal exige os seguintes elementos:
+ `iam:CreateServiceLinkedRole`: a **ação** que a entidade principal pode executar.
+ `arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication`: o **recurso** no qual as ações podem ser executadas.
+ `iam:AWSServiceName": "replication.cassandra.amazonaws.com`— O único AWS serviço ao qual essa função pode ser associada é o Amazon Keyspaces.
Veja a seguir um exemplo da política que concede as permissões mínimas necessárias a uma entidade principal para criar tabelas e espaços de chaves multirregionais.
```
{
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication",
"Condition": {"StringLike": {"iam:AWSServiceName": "replication.cassandra.amazonaws.com"}}
}
```
Para obter permissões adicionais do IAM para espaços de chaves e tabelas multirregionais, consulte [Ações, recursos e chaves de condição do Amazon Keyspaces (para Apache Cassandra)](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html) na *Referência de autorização do serviço*.
# Configure as permissões do IAM necessárias para adicionar um Região da AWS a um keyspace
Para adicionar uma região a um keyspace, o diretor do IAM precisa das seguintes permissões:
+ `cassandra:Alter`
+ `cassandra:AlterMultiRegionResource`
+ `cassandra:Create`
+ `cassandra:CreateMultiRegionResource`
+ `cassandra:Select`
+ `cassandra:SelectMultiRegionResource`
+ `cassandra:Modify`
+ `cassandra:ModifyMultiRegionResource`
Se a tabela estiver configurada no modo provisionado com o escalonamento automático ativado, as seguintes permissões adicionais serão necessárias.
+ `application-autoscaling:RegisterScalableTarget`
+ `application-autoscaling:DeregisterScalableTarget`
+ `application-autoscaling:DescribeScalableTargets`
+ `application-autoscaling:PutScalingPolicy`
+ `application-autoscaling:DescribeScalingPolicies`
Para adicionar com sucesso uma região a um keyspace de região única, o diretor do IAM também precisa ser capaz de criar uma função vinculada ao serviço. Essa função vinculada ao serviço é um tipo exclusivo de perfil do IAM predefinida pelo Amazon Keyspaces. Isso inclui todas as permissões que o Amazon Keyspaces exige para executar ações em seu nome. Para saber mais sobre a função vinculada ao serviço do , consulte [Uso de perfis para replicação multirregional do Amazon Keyspaces](using-service-linked-roles-multi-region-replication.md).
Para criar a função vinculada ao serviço exigida pela replicação multirregional, a política do IAM principal exige os seguintes elementos:
+ `iam:CreateServiceLinkedRole`: a **ação** que a entidade principal pode executar.
+ `arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication`: o **recurso** no qual as ações podem ser executadas.
+ `iam:AWSServiceName": "replication.cassandra.amazonaws.com`— O único AWS serviço ao qual essa função pode ser associada é o Amazon Keyspaces.
Veja a seguir um exemplo da política que concede as permissões mínimas necessárias a um principal para adicionar uma região a um keyspace.
```
{
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication",
"Condition": {"StringLike": {"iam:AWSServiceName": "replication.cassandra.amazonaws.com"}}
}
```
# Criar um espaço de chaves multirregional no Amazon Keyspaces
Esta seção fornece exemplos de como criar um espaço de chaves multirregional. Você pode fazer isso no console do Amazon Keyspaces, usando CQL ou a AWS CLI. Todas as tabelas criadas em um espaço de chaves multirregional herdam automaticamente as configurações multirregionais do espaço de chaves.
**nota**
Ao criar um espaço de chaves multirregional, o Amazon Keyspaces cria uma função vinculada ao serviço com o nome `AWSServiceRoleForAmazonKeyspacesReplication` em sua conta. Essa função permite que o Amazon Keyspaces replique gravações em 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 ]
**Criar um espaço de chaves multirregional (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, selecione **Espaços de chaves** e, em seguida, escolha **Criar espaço de chaves**.
1. Em **Nome do espaço de chaves**, insira o nome do espaço de chaves.
1. Na seção **Replicação multirregional**, você pode adicionar as regiões adicionais que estão disponíveis na lista.
1. Para finalizar, selecione **Criar espaço de chaves**.
------
#### [ Cassandra Query Language (CQL) ]
**Criar um espaço de chaves multirregional usando o CQL**
1. Para criar um espaço de chave multirregional, use `NetworkTopologyStrategy` para especificar o espaço de chave em Regiões da AWS que o espaço de chave será replicado. Você deve incluir sua Região atual e pelo menos uma Região adicional.
Todas as tabelas no espaço de chaves herdam a estratégia de replicação do espaço de chaves. Não é possível alterar a estratégia de replicação no nível da tabela.
`NetworkTopologyStrategy`— O fator de replicação para cada região é três porque o Amazon Keyspaces replica dados em [três zonas de disponibilidade](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/) dentro da Região da AWS mesma, por padrão.
A seguinte instrução CQL é um exemplo disso.
```
CREATE KEYSPACE mykeyspace
WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3' };
```
1. Você pode usar uma instrução CQL para consultar a tabela `tables` no espaço de chaves `system_multiregion_info` para listar programaticamente as Regiões e o status da tabela multirregional especificada. O código a seguir é um exemplo disso.
```
SELECT * from system_multiregion_info.tables WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
A saída da instrução é semelhante ao seguinte:
```
keyspace_name | table_name | region | status
----------------+----------------+----------------+--------
mykeyspace | mytable | us-east-1 | ACTIVE
mykeyspace | mytable | ap-southeast-1 | ACTIVE
mykeyspace | mytable | eu-west-1 | ACTIVE
```
------
#### [ CLI ]
**Crie um novo espaço de chave multirregional usando o AWS CLI**
+ Para criar um espaço de chaves multirregional, você pode usar a instrução CLI a seguir. Especifique sua Região atual e pelo menos uma Região adicional no `regionList`.
```
aws keyspaces create-keyspace --keyspace-name mykeyspace \
--replication-specification replicationStrategy=MULTI_REGION,regionList=us-east-1,eu-west-1
```
------
Para criar uma tabela multirregional, consulte [Criar uma tabela multirregional com as configurações padrão no Amazon Keyspaces](tables-mrr-create-default.md) e [Criar uma tabela multirregional no modo provisionado com ajuste de escala automático no Amazon Keyspaces](tables-mrr-create-provisioned.md).
# Adicionar um Região da AWS a um keyspace no Amazon Keyspaces
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"}'
```
------
# Verifique o progresso da replicação ao adicionar uma nova região a um keyspace
Adicionar uma nova região a um keyspace do Amazon Keyspaces é uma operação de longa duração. Para monitorar o progresso, você pode usar as consultas mostradas nesta seção.
------
#### [ Cassandra Query Language (CQL) ]
**Usando o CQL para verificar o progresso da adição da região**
+ Para verificar o progresso da criação das novas réplicas de tabela em um determinado espaço de chave, você pode consultar a `system_multiregion_info.keyspaces` tabela. A seguinte instrução CQL é um exemplo disso.
```
SELECT keyspace_name, region, status, tables_replication_progress
FROM system_multiregion_info.keyspaces
WHERE keyspace_name = 'my_keyspace';
```
Enquanto uma operação de replicação está em andamento, o status mostra o progresso da criação da tabela na nova região. Este é um exemplo em que 5 em cada 10 tabelas foram replicadas para a nova região.
```
keyspace_name | region | status | tables_replication_progress
---------------+-----------+-----------+-------------------------
my_keyspace | us-east-1 | Updating |
my_keyspace | us-west-2 | Updating |
my_keyspace | eu-west-1 | Creating | 50%
```
Depois que o processo de replicação for concluído com êxito, a saída deverá ser semelhante a este exemplo.
```
keyspace_name | region | status
---------------+-----------+-----------
my_keyspace | us-east-1 | Active
my_keyspace | us-west-2 | Active
my_keyspace | eu-west-1 | Active
```
------
#### [ CLI ]
**Usando o AWS CLI para verificar o progresso da adição da região**
+ Para confirmar o status da criação da réplica da tabela para um determinado espaço de chave, você pode usar o exemplo a seguir.
```
aws keyspaces get-keyspace \
--keyspace-name my_keyspace
```
A saída deve ser semelhante a este exemplo:
```
{
"keyspaceName": "my_keyspace",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/",
"replicationStrategy": "MULTI_REGION",
"replicationRegions": [
"us-east-1",
"eu-west-1"
]
"replicationGroupStatus": [
{
"RegionName": "us-east-1",
"KeyspaceStatus": "Active"
},
{
"RegionName": "eu-west-1",
"KeyspaceStatus": "Creating",
"TablesReplicationProgress": "50.0%"
}
]
}
```
------
# Criar uma tabela multirregional com as configurações padrão no Amazon Keyspaces
Esta seção fornece exemplos de como criar uma tabela multirregional no modo sob demanda com todas as configurações padrão. Você pode fazer isso no console do Amazon Keyspaces, usando CQL ou a AWS CLI. Todas as tabelas criadas em um espaço de chaves multirregional herdam automaticamente as configurações multirregionais do espaço de chaves.
Para criar um espaço de chaves multirregional, consulte [Criar um espaço de chaves multirregional no Amazon Keyspaces](keyspaces-mrr-create.md).
------
#### [ Console ]
**Criar uma tabela multirregional com as configurações padrão (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. Selecione um espaço de chaves multirregional.
1. Na guia **Tabelas**, selecione **Criar tabela**.
1. Em **Nome da tabela** insira o nome para a nova tabela. As Regiões da AWS em que essa tabela está sendo replicada são mostradas na caixa de informações.
1. Continue com o esquema da tabela.
1. Em **Configurações da tabela**, continue com a opção **Configurações padrão**. Observe as seguintes configurações padrão para tabelas multirregionais.
+ **Modo de capacidade**: o modo de capacidade padrão é **Sob demanda**. Para obter mais informações sobre como configurar o modo **provisionado**, consulte [Criar uma tabela multirregional no modo provisionado com ajuste de escala automático no Amazon Keyspaces](tables-mrr-create-provisioned.md).
+ **Gerenciamento de chaves de criptografia**: apenas a opção **Chave pertencente à AWS** é compatível.
+ **Data e hora do lado do cliente**: esse atributo é necessário para tabelas multirregionais.
+ Selecione **Personalizar configurações** se precisar ativar a vida útil (TTL) para a tabela e todas as suas réplicas.
**nota**
Você não poderá alterar as configurações de TTL em uma tabela multirregional existente.
1. Para finalizar, selecione **Criar tabela**.
------
#### [ Cassandra Query Language (CQL) ]
**Criar uma tabela multirregional no modo sob demanda com configurações padrão**
+ Para criar uma tabela multirregional com as configurações padrão, você pode usar a instrução CQL a seguir.
```
CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck))
WITH CUSTOM_PROPERTIES = {
'capacity_mode':{
'throughput_mode':'PAY_PER_REQUEST'
},
'point_in_time_recovery':{
'status':'enabled'
},
'encryption_specification':{
'encryption_type':'AWS_OWNED_KMS_KEY'
},
'client_side_timestamps':{
'status':'enabled'
}
};
```
------
#### [ CLI ]
**Usando o AWS CLI**
1. Para criar uma tabela multirregional com configurações padrão, você só precisa especificar o esquema. Você pode usar o seguinte exemplo.
```
aws keyspaces create-table --keyspace-name mykeyspace --table-name mytable \
--schema-definition 'allColumns=[{name=pk,type=int}],partitionKeys={name= pk}'
```
A saída do comando é:
```
{
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable"
}
```
1. Para confirmar as configurações da tabela, você pode usar a instrução a seguir.
```
aws keyspaces get-table --keyspace-name mykeyspace --table-name mytable
```
A saída mostra todas as configurações padrão de uma tabela multirregional.
```
{
"keyspaceName": "mykeyspace",
"tableName": "mytable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable",
"creationTimestamp": "2023-12-19T16:50:37.639000+00:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "pk",
"type": "int"
}
],
"partitionKeys": [
{
"name": "pk"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2023-12-19T16:50:37.639000+00:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "DISABLED"
},
"defaultTimeToLive": 0,
"comment": {
"message": ""
},
"clientSideTimestamps": {
"status": "ENABLED"
},
"replicaSpecifications": [
{
"region": "us-east-1",
"status": "ACTIVE",
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": 1702895811.469
}
},
{
"region": "eu-north-1",
"status": "ACTIVE",
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": 1702895811.121
}
}
]
}
```
------
# Criar uma tabela multirregional no modo provisionado com ajuste de escala automático no Amazon Keyspaces
Esta seção fornece exemplos de como criar uma tabela multirregional no modo provisionado com ajuste de escala automático. Você pode fazer isso no console do Amazon Keyspaces, usando CQL ou a AWS CLI.
Para obter mais informações sobre as configurações suportadas e os recursos de replicação multirregional, consulte. [Notas de uso da replicação multirregional do Amazon Keyspaces](multiRegion-replication_usage-notes.md)
Para criar um espaço de chaves multirregional, consulte [Criar um espaço de chaves multirregional no Amazon Keyspaces](keyspaces-mrr-create.md).
Ao criar uma nova tabela multirregional no modo provisionado com configurações de ajuste de escala automático, você pode especificar as configurações gerais da tabela que são válidas para todas as Regiões da AWS em que a tabela é replicada. Em seguida, você pode sobrescrever as configurações de capacidade de leitura e ler as configurações de ajuste de escala automático para cada réplica. No entanto, a capacidade de gravação permanece sincronizada entre todas as réplicas para garantir que haja capacidade suficiente para replicar gravações em todas as regiões.
**nota**
O ajuste de escala automático do Amazon Keyspaces requer a presença de um perfil vinculado ao serviço (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) que realize ações de ajuste em seu nome. Esta função é criada automaticamente para você. Para obter mais informações, consulte [Uso de perfis vinculados ao serviço para o Amazon Keyspaces](using-service-linked-roles.md).
------
#### [ Console ]
**Criar uma tabela multirregional com ajuste de escala automático habilitado**
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. Selecione um espaço de chaves multirregional.
1. Na guia **Tabelas**, selecione **Criar tabela**.
1. Na página **Criar tabela**, na seção **Detalhes da tabela**, selecione um espaço de chaves e forneça um nome para a nova tabela.
1. Na seção **Colunas**, crie o esquema para sua tabela.
1. Na seção **Chave primária**, defina a chave primária da tabela e selecione colunas de clustering opcionais.
1. Na seção **Configurações da tabela**, selecione **Personalizar configurações**.
1. Continue com as configurações de **capacidade de leitura/gravação**.
1. Para o **Modo de capacidade**, escolha **Provisionado**.
1. Na seção **Capacidade de leitura**, confirme se a opção **Escalar automaticamente** está selecionada.
Você pode optar por configurar as mesmas unidades de capacidade de leitura para todas as Regiões da AWS em que a tabela é replicada. Como alternativa, você pode desmarcar a caixa de seleção e configurar a capacidade de leitura para cada região de forma diferente.
Se você optar por configurar cada região de forma diferente, selecione as unidades de capacidade de leitura mínima e máxima para cada réplica da tabela, bem como a utilização desejada.
+ **Unidades de capacidade mínima**: insira o valor do nível mínimo de throughput que a tabela deve estar sempre pronta para suportar. O valor deve estar entre 1 e a cota máxima de throughput por segundo da sua conta (40.000 por padrão).
+ **Unidades de capacidade máxima**: insira a quantidade máxima de throughput que você deseja provisionar para a tabela. O valor deve estar entre 1 e a cota máxima de throughput por segundo da sua conta (40.000 por padrão).
+ **Utilização desejada**: insira uma taxa de utilização desejada entre 20% e 90%. Quando o tráfego excede a taxa de utilização desejada definida, a capacidade é automaticamente aumentada. Quando o tráfego fica abaixo da meta definida, ela é automaticamente reduzida novamente.
+ Desmarque a caixa de seleção **Escalar automaticamente** se quiser provisionar a capacidade de leitura da tabela manualmente. Essa configuração se aplica a todas as réplicas da tabela.
**nota**
Para garantir que haja capacidade de leitura suficiente para todas as réplicas, recomendamos o recurso de ajuste de escala automático do Amazon Keyspaces para tabelas multirregionais provisionadas.
**nota**
Para saber mais sobre as cotas padrão da sua conta e como aumentá-las, consulte [Cotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
1. Na seção **Capacidade de gravação**, confirme se a opção **Escalar automaticamente** está selecionada. Em seguida, configure as unidades de capacidade para a tabela. As unidades de capacidade de gravação permanecem sincronizadas em todas as Regiões da AWS para garantir que haja capacidade suficiente para replicar eventos de gravação em todas as regiões.
+ Desmarque **Escalar automaticamente** se quiser provisionar a capacidade de gravação da tabela manualmente. Essa configuração se aplica a todas as réplicas da tabela.
**nota**
Para garantir que haja capacidade de gravação suficiente para todas as réplicas, recomendamos o recurso de ajuste de escala automático do Amazon Keyspaces para tabelas multirregionais provisionadas.
1. Escolha **Criar tabela**. Sua tabela é criada com os parâmetros padrão de ajuste de escala automático.
------
#### [ Cassandra Query Language (CQL) ]
**Criar uma tabela multirregional com modo de capacidade provisionada e ajuste de escala automático usando CQL**
+ Para criar uma tabela multirregional no modo provisionado com ajuste de escala automático, primeiro você deve especificar o modo de capacidade definindo `CUSTOM_PROPERTIES` para a tabela. Depois de especificar o modo de capacidade provisionada, você pode definir as configurações do ajuste de escala automático para a tabela usando `AUTOSCALING_SETTINGS`.
Para obter informações detalhadas sobre as configurações do ajuste de escala automático, a política de rastreamento de metas, o valor alvo e as configurações opcionais, consulte [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md).
Para definir a capacidade de leitura de uma réplica de tabela em uma região específica, você pode configurar os seguintes parâmetros como parte do `replica_updates` da tabela:
+ A região
+ As unidades de capacidade de leitura provisionadas (opcional)
+ Configurações do ajuste de escala automático para a capacidade de leitura (opcional)
O exemplo a seguir mostra uma instrução `CREATE TABLE` para uma tabela multirregional no modo provisionado. As configurações gerais do ajuste de escala automático da capacidade de gravação e leitura são as mesmas. No entanto, as configurações do ajuste de escala automático de leitura especificam períodos de espera adicionais de 60 segundos antes de aumentar ou diminuir a capacidade de leitura da tabela. Além disso, as configurações do ajuste de escala automático da capacidade de leitura para a Região Leste dos EUA (N. da Virgínia) são maiores do que as de outras réplicas. Além disso, o valor alvo é definido como 70% em vez de 50%.
```
CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck))
WITH CUSTOM_PROPERTIES = {
'capacity_mode': {
'throughput_mode': 'PROVISIONED',
'read_capacity_units': 5,
'write_capacity_units': 5
}
} AND AUTOSCALING_SETTINGS = {
'provisioned_write_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50
}
}
},
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50,
'scale_in_cooldown': 60,
'scale_out_cooldown': 60
}
}
},
'replica_updates': {
'us-east-1': {
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 20,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 70
}
}
}
}
}
};
```
------
#### [ CLI ]
**Crie uma nova tabela multirregional no modo provisionado com escalonamento automático usando o AWS CLI**
+ Para criar uma tabela multirregional no modo provisionado com configuração de ajuste de escala automático, você pode usar a AWS CLI. Observe que você deve usar o comando `create-table` da CLI do Amazon Keyspaces para definir configurações de ajuste de escala automático multirregionais. Isso ocorre porque o Application Auto Scaling, o serviço que o Amazon Keyspaces usa para realizar o ajuste de escala automático em seu nome, não oferece suporte a várias regiões.
Para obter mais informações sobre as configurações de ajuste de escala automático, a política de rastreamento de metas, o valor alvo e as configurações opcionais, consulte [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md).
Para definir a capacidade de leitura de uma réplica de tabela em uma região específica, você pode configurar os seguintes parâmetros como parte do `replicaSpecifications` da tabela:
+ A região
+ As unidades de capacidade de leitura provisionadas (opcional)
+ Configurações do ajuste de escala automático para a capacidade de leitura (opcional)
Ao criar tabelas multirregionais provisionadas com configurações complexas de ajuste de escala automático e configurações diferentes para réplicas de tabela, é útil carregar as configurações de ajuste de escala automático e de réplica da tabela a partir de arquivos JSON.
Para usar o exemplo de código a seguir, você pode baixar os arquivos JSON de exemplo do [auto-scaling.zip](samples/auto-scaling.zip) e extrair `auto-scaling.json` e `replication.json`. Anote o caminho para os arquivos.
Neste exemplo, os arquivos JSON estão localizados no diretório atual. Para diferentes opções de caminho de arquivo, consulte [ Como carregar parâmetros de um arquivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how).
```
aws keyspaces create-table --keyspace-name mykeyspace --table-name mytable \
--schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=int}],partitionKeys=[{name=pk},{name=ck}]' \
--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
--auto-scaling-specification file://auto-scaling.json \
--replica-specifications file://replication.json
```
------
# Atualize a capacidade provisionada e as configurações de ajuste de escala automático para uma tabela multirregional no Amazon Keyspaces
Esta seção inclui exemplos de como usar o console, o CQL e o AWS CLI para gerenciar as configurações de auto scaling do Amazon Keyspaces de tabelas multirregionais provisionadas. Para obter mais informações sobre as opções gerais de configuração de ajuste de escala automático e como elas funcionam, consulte [Gerencia automaticamente a capacidade de throughput com o ajuste de escala automático do Amazon Keyspaces](autoscaling.md).
Observe que, se você estiver usando o modo de capacidade provisionada para tabelas multirregionais, você deve sempre usar as chamadas de API do Amazon Keyspaces para configurar o ajuste de escala automático. Isso ocorre porque as operações subjacentes da API Application Auto Scaling não reconhecem a região.
Para obter mais informações sobre como estimar o throughput da capacidade de gravação de tabelas multirregionais provisionadas, consulte [Estimar e provisionar a capacidade para uma tabela multirregional no Amazon Keyspaces](tables-multi-region-capacity.md).
Para obter mais informações sobre a API do Amazon Keyspaces, consulte [https://docs.aws.amazon.com/keyspaces/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/keyspaces/latest/APIReference/Welcome.html).
Ao atualizar o modo provisionado ou as configurações de ajuste de escala automático de uma tabela multirregional, você pode atualizar as configurações de capacidade de leitura e a configuração de ajuste de escala automático de leitura para cada réplica da tabela.
No entanto, a capacidade de gravação permanece sincronizada entre todas as réplicas para garantir que haja capacidade suficiente para replicar gravações em todas as regiões.
------
#### [ Cassandra Query Language (CQL) ]
**Atualize a capacidade provisionada e as configurações de ajuste de escala automático de uma tabela multirregional usando CQL**
+ Você pode usar `ALTER TABLE` para atualizar o modo de capacidade e as configurações de ajuste de escala automático de uma tabela existente. Se estiver atualizando uma tabela que está atualmente no modo de capacidade sob demanda, é necessário usar `capacity_mode`. Se sua tabela já estiver no modo de capacidade provisionada, esse campo poderá ser omitido.
Para obter informações detalhadas sobre as configurações do ajuste de escala automático, a política de rastreamento de metas, o valor alvo e as configurações opcionais, consulte [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md).
Na mesma declaração, você também pode atualizar as configurações de capacidade de leitura e ajuste de escala automático de réplicas de tabela em regiões específicas atualizando a propriedade `replica_updates` da tabela. A instrução a seguir é um exemplo disso.
```
ALTER TABLE mykeyspace.mytable
WITH CUSTOM_PROPERTIES = {
'capacity_mode': {
'throughput_mode': 'PROVISIONED',
'read_capacity_units': 1,
'write_capacity_units': 1
}
} AND AUTOSCALING_SETTINGS = {
'provisioned_write_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50
}
}
},
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50,
'scale_in_cooldown': 60,
'scale_out_cooldown': 60
}
}
},
'replica_updates': {
'us-east-1': {
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 20,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 70
}
}
}
}
}
};
```
------
#### [ CLI ]
**Atualize a capacidade provisionada e as configurações de escalabilidade automática de uma tabela multirregional usando o AWS CLI**
+ Para atualizar o modo provisionado e a configuração de escalonamento automático de uma tabela existente, você pode usar o comando. AWS CLI `update-table`
Observe que você deve usar os comandos da CLI do Amazon Keyspaces para criar ou modificar configurações de ajuste de escala automático multirregional. Isso ocorre porque o Application Auto Scaling, o serviço que o Amazon Keyspaces usa para realizar o ajuste de escala automático da capacidade da tabela em seu nome, não suporta várias Regiões da AWS.
Para atualizar a capacidade de leitura de uma réplica de tabela em uma região específica, você pode alterar um dos seguintes parâmetros opcionais do `replicaSpecifications` da tabela:
+ As unidades de capacidade de leitura provisionadas (opcional)
+ Configurações do ajuste de escala automático para a capacidade de leitura (opcional)
Ao atualizar tabelas multirregionais com configurações complexas de ajuste de escala automático e configurações diferentes para réplicas de tabela, é útil carregar as configurações de ajuste de escala automático e as configurações de réplica da tabela a partir de arquivos JSON.
Para usar o exemplo de código a seguir, você pode baixar os arquivos JSON de exemplo do [auto-scaling.zip](samples/auto-scaling.zip) e extrair `auto-scaling.json` e `replication.json`. Anote o caminho para os arquivos.
Neste exemplo, os arquivos JSON estão localizados no diretório atual. Para diferentes opções de caminho de arquivo, consulte [ Como carregar parâmetros de um arquivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how).
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
--auto-scaling-specification file://auto-scaling.json \
--replica-specifications file://replication.json
```
------
# Exibir a capacidade provisionada e as configurações de ajuste de escala automático para uma tabela multirregional no Amazon Keyspaces
Você pode exibir a capacidade provisionada e as configurações de ajuste de escala automático de uma tabela multirregional no console do Amazon Keyspaces, usando CQL ou a AWS CLI. Esta seção fornece exemplos de como fazer isso usando CQL e o. AWS CLI
------
#### [ Cassandra Query Language (CQL) ]
**Exibir a capacidade provisionada e as configurações de ajuste de escala automático de uma tabela multirregional usando CQL**
+ Para ver a configuração do ajuste de escala automático de uma tabela multirregional, use o comando a seguir.
```
SELECT * FROM system_multiregion_info.autoscaling WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
A saída desse comando é semelhante à seguinte:
```
keyspace_name | table_name | region | provisioned_read_capacity_autoscaling_update | provisioned_write_capacity_autoscaling_update
----------------+------------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
mykeyspace | mytable | ap-southeast-1 | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
mykeyspace | mytable | us-east-1 | {'minimum_units': 5, 'maximum_units': 20, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 70, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
mykeyspace | mytable | eu-west-1 | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
```
------
#### [ CLI ]
**Visualize a capacidade provisionada e as configurações de escalabilidade automática de uma tabela multirregional usando o AWS CLI**
+ Para exibir a configuração de ajuste de escala automático de uma tabela multirregional, você pode usar a operação `get-table-auto-scaling-settings`. O comando CLI a seguir é um exemplo disso.
```
aws keyspaces get-table-auto-scaling-settings --keyspace-name mykeyspace --table-name mytable
```
Você verá a saída a seguir.
```
{
"keyspaceName": "mykeyspace",
"tableName": "mytable",
"resourceArn": "arn:aws:cassandra:us-east-1:777788889999:/keyspace/mykeyspace/table/mytable",
"autoScalingSpecification": {
"writeCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 0,
"scaleOutCooldown": 0,
"targetValue": 50.0
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 20,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 60,
"scaleOutCooldown": 60,
"targetValue": 70.0
}
}
}
},
"replicaSpecifications": [
{
"region": "us-east-1",
"autoScalingSpecification": {
"writeCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 0,
"scaleOutCooldown": 0,
"targetValue": 50.0
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 20,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 60,
"scaleOutCooldown": 60,
"targetValue": 70.0
}
}
}
}
},
{
"region": "eu-north-1",
"autoScalingSpecification": {
"writeCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 0,
"scaleOutCooldown": 0,
"targetValue": 50.0
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 60,
"scaleOutCooldown": 60,
"targetValue": 50.0
}
}
}
}
}
]
}
```
------
# Desativar o ajuste de escala automático para uma tabela no Amazon Keyspaces
Esta seção fornece exemplos de como desativar o ajuste de escala automático para uma tabela multirregional no modo de capacidade provisionada. Você pode fazer isso no console do Amazon Keyspaces, usando CQL ou a AWS CLI.
**Importante**
Recomendamos usar o ajuste de escala automático para tabelas multirregionais que usam o modo de capacidade provisionada. Para obter mais informações, consulte [Estimar e provisionar a capacidade para uma tabela multirregional no Amazon Keyspaces](tables-multi-region-capacity.md).
**nota**
Para excluir a função vinculada ao serviço usada pelo Application Auto Scaling, você deve desativar o ajuste de escala automático em todas as tabelas da conta em todas as Regiões da AWS.
------
#### [ Console ]
**Desativar o ajuste de escala automático do Amazon Keyspaces para uma tabela multirregional existente no 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. Escolha a tabela com a qual você deseja trabalhar e depois escolha a guia **Capacidade**.
1. Na seção **Configurações de capacidade**, escolha **Editar**.
1. Para desativar o ajuste de escala automático do Amazon Keyspaces, desmarque a opção **Escalar automaticamente.** A desativação do ajuste de escala automático cancela o registro da tabela como um destino escalável com o Application Auto Scaling. Para excluir a função vinculada ao serviço usada pelo Application Auto Scaling para acessar a tabela do Amazon Keyspaces, siga as etapas descritas em [Exclusão de um perfil vinculado ao serviço do Amazon Keyspaces](using-service-linked-roles-app-auto-scaling.md#delete-service-linked-role-app-auto-scaling).
1. Quando as configurações de escala automática estiverem definidas, escolha **Salvar**.
------
#### [ Cassandra Query Language (CQL) ]
**Desative o ajuste de escala automático para uma tabela multirregional usando CQL**
+ Você pode usar `ALTER TABLE` para desativar o ajuste de escala automático de uma tabela existente. Observe que você não pode desativar o ajuste de escala automático para uma réplica de tabela individual.
No exemplo a seguir, o ajuste de escala automático está desativado para a capacidade de leitura da tabela.
```
ALTER TABLE mykeyspace.mytable
WITH AUTOSCALING_SETTINGS = {
'provisioned_read_capacity_autoscaling_update': {
'autoscaling_disabled': true
}
};
```
------
#### [ CLI ]
**Desative o escalonamento automático para uma tabela multirregional usando o AWS CLI**
+ Você pode usar o AWS CLI `update-table` comando para desativar o escalonamento automático de uma tabela existente. Observe que você não pode desativar o ajuste de escala automático para uma réplica de tabela individual.
No exemplo a seguir, o ajuste de escala automático está desativado para a capacidade de leitura da tabela.
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable
\ --auto-scaling-specification readCapacityAutoScaling={autoScalingDisabled=true}
```
------
# Definir manualmente a capacidade provisionada de uma tabela multirregional no Amazon Keyspaces
Se precisar desativar o ajuste de escala automático de uma tabela multirregional, você pode provisionar manualmente a capacidade de leitura para uma tabela de réplica usando CQL ou a AWS CLI.
**nota**
Recomendamos usar o ajuste de escala automático para tabelas multirregionais que usam o modo de capacidade provisionada. Para obter mais informações, consulte [Estimar e provisionar a capacidade para uma tabela multirregional no Amazon Keyspaces](tables-multi-region-capacity.md).
------
#### [ Cassandra Query Language (CQL) ]
**Configurar a capacidade provisionada de uma tabela multirregional manualmente usando o CQL**
+ Você pode usar `ALTER TABLE` para provisionar manualmente a capacidade de leitura da tabela para uma tabela de réplica.
```
ALTER TABLE mykeyspace.mytable
WITH CUSTOM_PROPERTIES = {
'capacity_mode': {
'throughput_mode': 'PROVISIONED',
'read_capacity_units': 1,
'write_capacity_units': 1
},
'replica_updates': {
'us-east-1': {
'read_capacity_units': 2
}
}
};
```
------
#### [ CLI ]
**Defina manualmente a capacidade provisionada de uma tabela multirregional usando o AWS CLI**
+ Se você precisar desativar o ajuste de escala automático de uma tabela multirregional, pode usar o `update-table` para provisionar manualmente a capacidade de leitura da tabela para uma tabela de réplica.
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
--replica-specifications region="us-east-1",readCapacityUnits=5
```
------