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á.
# 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
```
------