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á. # Gerencia automaticamente a capacidade de throughput com o ajuste de escala automático do Amazon Keyspaces Muitas cargas de trabalho de banco de dados são cíclicas por natureza ou são difíceis de prever com antecedência. Por exemplo, considere um aplicativo de rede social na qual a maioria dos usuários está ativa durante o horário diurno. O banco de dados deve ser capaz de lidar com a atividade durante o dia, mas não há necessidade dos mesmos níveis de throughput à noite. Outro exemplo pode ser um novo aplicativo de jogos para celular que está passando por uma rápida adoção. Se o jogo se tornar muito popular, talvez ele exceda os recursos de banco de dados disponíveis, podendo resultar em desempenho lento e clientes insatisfeitos. Esses tipos de cargas de trabalho muitas vezes exigem intervenção manual para dimensionar recursos de banco de dados, aumentando-os ou diminuindo-os em resposta a diferentes níveis de uso. O Amazon Keyspaces (para Apache Cassandra) 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. O Amazon Keyspaces usa o serviço Application Auto Scaling para aumentar e diminuir a capacidade de leitura e gravação de uma tabela por você. Para obter mais informações sobre o Application Auto Scaling, consulte o [Guia do usuário do Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/). **nota** Para começar a trabalhar rapidamente com o ajuste de escala automático do Amazon Keyspaces, consulte [Configure e atualize políticas de ajuste de escala automático do Amazon Keyspaces](autoscaling.configure.md). ## Como funciona o ajuste de escala automático do Amazon Keyspaces O diagrama a seguir fornece uma visão geral de alto nível de como o ajuste de escala automático do Amazon Keyspaces gerencia a capacidade de throughput de uma tabela. ![\[Um diagrama mostrando os diferentes serviços envolvidos quando um usuário faz uma alteração em uma tabela do Amazon Keyspaces. Os serviços são Amazon CloudWatch, Amazon SNS e Application Auto Scaling, que emitem a declaração ALTER TABLE para alterar a capacidade com base no uso de leitura ou gravação dos usuários.\]](http://docs.aws.amazon.com/pt_br/keyspaces/latest/devguide/images/keyspaces_auto-scaling.png) Para habilitar o ajuste de escala automático para uma tabela, você cria uma *política de ajuste de escala*. A política de ajuste de escala especifica se você deseja escalar a capacidade de leitura ou a capacidade de gravação (ou ambas), bem como as configurações mínimas e máximas de unidades de capacidade provisionadas para a tabela. A política de ajuste de escala também define uma *meta de utilização*. A utilização pretendida é a proporção entre unidades de capacidade consumidas e unidades de capacidade provisionadas em um dado momento, expressa como um percentual. O ajuste de escala automático usa um *algoritmo de rastreamento* para ajustar o throughput provisionado da tabela para cima ou para baixo em resposta a workloads reais. Isso é feito para que a utilização real da capacidade permaneça igual ou próxima à sua meta de utilização. É possível definir os valores de utilização do destino de ajuste de escala automático entre 20% e 90% como sua capacidade de gravação e leitura. A meta padrão de taxa de utilização é de 70 por cento. Você pode definir a meta de utilização como uma porcentagem menor se o tráfego mudar rapidamente e quiser que a capacidade comece a aumentar mais cedo. Você também pode definir a taxa de utilização desejada para uma taxa mais alta se o tráfego do aplicativo mudar mais lentamente e você quiser reduzir o custo do throughput. Para obter mais informações sobre políticas de ajuste de escala, consulte [ Target Tracking Scaling Policies for Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) no [https://docs.aws.amazon.com/autoscaling/application/userguide/](https://docs.aws.amazon.com/autoscaling/application/userguide/). Quando você cria uma política de escalabilidade, o Amazon Keyspaces cria dois pares de alarmes da CloudWatch Amazon em seu nome. Cada par representa seus limites superiores e inferiores para configurações de throughput provisionado e consumido. Esses CloudWatch alarmes são acionados quando a utilização real da tabela se desvia da sua meta de utilização por um longo período de tempo. Para saber mais sobre a Amazon CloudWatch, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). Quando um dos CloudWatch alarmes é acionado, o Amazon Simple Notification Service (Amazon SNS) envia uma notificação (se você a tiver ativado). O CloudWatch alarme então invoca o Application Auto Scaling para avaliar sua política de escalabilidade. Isso, por sua vez, emite uma solicitação Alter Table para o Amazon Keyspaces para ajustar a capacidade provisionada da tabela para cima ou para baixo conforme apropriado. Para saber mais sobre as notificações do Amazon SNS, consulte [ Como configurar as notificações do Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html). O Amazon Keyspaces processa a solicitação de alteração da tabela, aumentando (ou diminuindo) a capacidade de throughput provisionado da tabela de forma que ela se aproxime da sua utilização prevista. **nota** O ajuste de escala automático do Amazon Keyspaces modifica as configurações de throughput provisionado somente quando a workload real permanece elevada (ou baixa) por um período prolongado de vários minutos. O algoritmo de rastreamento previsto do procura manter a utilização prevista em ou perto do seu valor escolhido em longo prazo. Picos de atividade súbitos de curta duração são acomodados pela capacidade de expansão interna da tabela. ## Como o ajuste de escala automático funciona para tabelas multirregionais Para garantir que sempre haja capacidade suficiente de leitura e gravação para todas as réplicas de tabelas em toda uma tabela multirregional no modo Regiões da AWS de capacidade provisionada, recomendamos que você configure o Amazon Keyspaces auto scaling. Ao usar uma tabela multirregional no modo provisionado com ajuste de escala automático, você não pode desativar o ajuste de escala automático para uma única réplica de tabela. Mas você pode ajustar as configurações de ajuste de escala automático de leitura da tabela para diferentes regiões. Por exemplo, você pode especificar diferentes configurações de capacidade de leitura e ajuste de escala automático de leitura para cada região na qual a tabela é replicada. As configurações de ajuste de escala automático de leitura que você define para uma réplica de tabela em uma região especificada substituem as configurações gerais de ajuste de escala automático da tabela. No entanto, a capacidade de gravação precisa permanecer sincronizada em todas as réplicas da tabela para garantir que haja capacidade suficiente para replicar gravações em todas as regiões. O ajuste de escala automático do Amazon Keyspaces atualiza de forma independente a capacidade provisionada da tabela em cada Região da AWS com base no uso naquela região. Como resultado, a capacidade provisionada em cada região para uma tabela multirregional pode ser diferente quando o ajuste de escala automático está ativo. Você pode definir as configurações de auto scaling de uma tabela multirregional e suas réplicas usando o console, a API ou a CQL do Amazon Keyspaces. AWS CLI Para obter mais informações sobre como criar e atualizar as configurações de ajuste de escala automático para tabelas multirregionais, 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). **nota** Se você usa o ajuste de escala automático para tabelas multirregionais, deve sempre usar as operações de API do Amazon Keyspaces para definir as configurações de ajuste de escala automático. Se você usa as operações da API Application Auto Scaling diretamente para definir as configurações de escalonamento automático, você não tem a capacidade de especificar a tabela Regiões da AWS multirregional. Isso pode resultar em configurações não suportadas. ## Observações de uso Antes de começar a usar o ajuste de escala automático do Amazon Keyspaces, você deve estar ciente do seguinte: + A escalabilidade automática do Amazon Keyspaces não está disponível na região Oriente Médio (EAU). + O ajuste de escala automático do Amazon Keyspaces pode aumentar a capacidade de leitura ou gravação sempre que necessário, de acordo com a sua política de ajuste de escala automático. Todas as cotas do Amazon Keyspaces permanecem em vigor, conforme descrito em [Cotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md). + O ajuste de escala automático do Amazon Keyspaces não impede a modificação manual de configurações de throughput provisionado. Esses ajustes manuais não afetam nenhum CloudWatch alarme existente anexado à política de escalabilidade. + Se você usar o console para criar uma tabela com capacidade de throughput provisionada, o ajuste de escala automático do Amazon Keyspaces será habilitado por padrão. É possível modificar as configurações de ajuste de escala automático a qualquer momento. Para obter mais informações, consulte [Desativar o ajuste de escala automático do Amazon Keyspaces para uma tabela](autoscaling.turnoff.md). + Se você estiver usando CloudFormation para criar políticas de escalabilidade, você deve gerenciar as políticas de escalabilidade CloudFormation para que a pilha esteja sincronizada com o modelo da pilha. Se você alterar as políticas de escalabilidade do Amazon Keyspaces, elas serão substituídas pelos valores originais do modelo da pilha quando CloudFormation a pilha for redefinida. + Se você usa CloudTrail para monitorar a escalabilidade automática do Amazon Keyspaces, você pode ver alertas de chamadas feitas pelo Application Auto Scaling como parte de seu processo de validação de configuração. Para filtrar esses alertas, use o campo `invokedBy`, que conterá `application-autoscaling.amazonaws.com` para essas verificações de validação. # Configure e atualize políticas de ajuste de escala automático do Amazon Keyspaces Você pode usar o console, o CQL ou o AWS Command Line Interface (AWS CLI) para configurar a escalabilidade automática do Amazon Keyspaces para tabelas novas e existentes. Você também pode modificar as configurações de ajuste de escala automático ou desabilitá-lo. Para recursos mais avançados, como definir tempos de espera de expansão e redução, recomendamos que você use o CQL ou o para gerenciar as políticas de escalabilidade do AWS CLI Amazon Keyspaces. **Topics** + [Configure permissões para ajuste de escala automático do Amazon Keyspaces](autoscaling.permissions.md) + [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md) + [Configurar o ajuste de escala automático em uma tabela existente](autoscaling.configureTable.md) + [Veja a configuração de ajuste de escala automático do Amazon Keyspaces da sua tabela](autoscaling.viewPolicy.md) + [Desativar o ajuste de escala automático do Amazon Keyspaces para uma tabela](autoscaling.turnoff.md) + [Veja a atividade de auto scaling para uma tabela do Amazon Keyspaces na Amazon CloudWatch](autoscaling.activity.md) # Configure permissões para ajuste de escala automático do Amazon Keyspaces Para começar, confirme se a entidade principal tem as permissões apropriadas para criar e gerenciar as configurações de ajuste de escala automático. No AWS Identity and Access Management (IAM), a política AWS gerenciada `AmazonKeyspacesFullAccess` é necessária para gerenciar as políticas de escalabilidade do Amazon Keyspaces. **Importante** Permissões do `application-autoscaling:*` são necessárias para desativar o ajuste de escala automático em uma tabela. É necessário desativar o ajuste de escala automático de uma tabela antes de excluí-la. Para configurar um usuário do IAM ou função para acesso ao console do Amazon Keyspaces e ajuste de escala automático do Amazon Keyspaces, adicione a política a seguir. **Para anexar a política `AmazonKeyspacesFullAccess`** 1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. No painel do console do IAM, escolha **Usuários** e, em seguida, escolha seu usuário do IAM ou função na lista. 1. Na página **Summary (Resumo)**, escolha **Add permissions (Adicionar permissões)**. 1. Escolha **Anexar políticas existentes diretamente**. 1. Na lista de políticas, escolha e **AmazonKeyspacesFullAccess**, em seguida, escolha **Avançar: Revisão**. 1. Escolha **Adicionar permissões**. # Crie uma nova tabela com dimensionamento automático Ao criar uma nova tabela do Amazon Keyspaces, você pode habilitar automaticamente o ajuste de escala automático para a capacidade de gravação ou leitura da tabela. Isso permite que o Amazon Keyspaces entre em contato com o Application Auto Scaling em seu nome para registrar a tabela como uma meta escalável e ajustar a capacidade provisionada de gravação ou leitura. Para obter mais informações sobre como criar uma tabela multirregional e definir diferentes configurações de ajuste de escala automático para réplicas de tabela, consulte [Criar uma tabela multirregional no modo provisionado com ajuste de escala automático no Amazon Keyspaces](tables-mrr-create-provisioned.md). **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 ] **Como criar uma nova tabela com ajuste de escala automático habilitado 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. No painel de navegação, selecione **Tables (Tabelas)** e **Create table (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. Nesta etapa, você seleciona as unidades de capacidade de leitura mínima e máxima para a 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. **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**, escolha as mesmas configurações definidas na etapa anterior para capacidade de leitura ou configure os valores da capacidade manualmente. 1. Escolha **Create table**. Sua tabela é criada com os parâmetros padrão de ajuste de escala automático. ------ #### [ Cassandra Query Language (CQL) ] **Crie uma nova tabela com ajuste de escala automático do Amazon Keyspaces usando CQL** Para definir as configurações de ajuste de escala automático para uma tabela de forma programática, você usa a instrução `AUTOSCALING_SETTINGS` que contém os parâmetros para ajuste de escala automático do Amazon Keyspaces. Os parâmetros definem as condições que conduzem o Amazon Keyspaces a ajustar o throughput provisionado da tabela e as ações opcionais adicionais que serão executadas. Neste exemplo, você define as configurações de ajuste de escala automático para *mytable*. A política contém os elementos a seguir: + `AUTOSCALING_SETTINGS`: especifica se o Amazon Keyspaces tem permissão para ajustar a capacidade de throughput em seu nome. Os valores a seguir são necessários: + `provisioned_write_capacity_autoscaling_update`: + `minimum_units` + `maximum_units` + `provisioned_read_capacity_autoscaling_update`: + `minimum_units` + `maximum_units` + `scaling_policy`: o Amazon Keyspaces oferece suporte à política de rastreamento de alvos. Para definir a política de rastreamento de alvos, você configura os seguintes parâmetros. + `target_value`: o ajuste de escala automático do Amazon Keyspaces garante que o índice de capacidade consumida para capacidade provisionada permaneça nesse valor ou próximo a ele. Você define `target_value` como uma porcentagem. + `disableScaleIn`: (Opcional) um `boolean` que especifica se `scale-in` está desativado ou ativado para a tabela. Por padrão, esse parâmetro é desabilitado. Para ativar `scale-in`, defina o valor de `boolean` como `FALSE`. Isso significa que a capacidade é reduzida automaticamente para uma tabela em seu nome. + `scale_out_cooldown`: a atividade de expansão aumenta a capacidade de throughput provisionado de sua tabela. Para adicionar um período de espera nas atividades de aumento da escala horizontalmente, especifique um valor, em segundos, para `scale_out_cooldown`. Se você não especificar um valor, o valor padrão é 0. Para obter mais informações sobre rastreamento de destino e período de espera, consulte [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) no *Guia do usuário do Application Auto Scaling*. + `scale_in_cooldown`: uma atividade de redução da escala diminui o throughput provisionado de sua tabela. Para adicionar um período de espera nas atividades de redução da escala horizontalmente, especifique um valor, em segundos, para `scale_in_cooldown`. Se você não especificar um valor, o valor padrão é 0. Para obter mais informações sobre rastreamento de destino e período de espera, consulte [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) no *Guia do usuário do Application Auto Scaling*. **nota** Para compreender melhor como o `target_value` funciona, suponha que você tenha uma tabela com uma configuração de throughput provisionado de 200 unidades de capacidade de gravação. Você decide criar uma política de dimensionamento para essa tabela, com um `target_value` de 70%. Agora, suponha que você comece a direcionar tráfego de gravação para a tabela de forma que o throughput de gravação real seja de 150 unidades de capacidade. A consumed-to-provisioned proporção agora é (150/200), ou 75 por cento. Essa taxa excede o valor pretendido. Portanto, o ajuste de escala automático aumenta a capacidade de gravação provisionada para 215 de modo que a taxa seja (150/215) ou 69,77%, tão próxima ao seu `target_value` quanto possível, mas sem excedê-lo. Para *mytable*, você define `TargetValue` para a capacidade de leitura e gravação em 50 por cento. O auto scaling do Amazon Keyspaces ajusta a taxa de transferência provisionada da tabela na faixa de 5 a 10 unidades de capacidade para que a proporção permaneça em ou perto de 50%. consumed-to-provisioned Para capacidade de leitura, você define os valores de `ScaleOutCooldown` e `ScaleInCooldown` para 60 segundos. Você pode usar a seguinte declaração para criar uma nova tabela do Amazon Keyspaces com o ajuste de escala automático ativado. ``` CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck)) 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 } } } }; ``` ------ #### [ CLI ] **Crie uma nova tabela com a escalabilidade automática do Amazon Keyspaces usando o AWS CLI** Para definir as configurações de ajuste de escala automático para uma tabela de forma programática, você usa a ação `autoScalingSpecification` que define os parâmetros para o ajuste de escala automático do Amazon Keyspaces. Os parâmetros definem as condições que conduzem o Amazon Keyspaces a ajustar o throughput provisionado da tabela e as ações opcionais adicionais que serão executadas. Neste exemplo, você define as configurações de ajuste de escala automático para *mytable*. A política contém os elementos a seguir: + `autoScalingSpecification`: especifica se o Amazon Keyspaces tem permissão para ajustar a capacidade de throughput em seu nome. Você pode ativar o ajuste de escala automático para capacidade de leitura e gravação separadamente. Então, você deve especificar os parâmetros para `autoScalingSpecification`: + `writeCapacityAutoScaling`: as unidades de capacidade máxima e mínima de gravação. + `readCapacityAutoScaling`: as unidades de capacidade máxima e mínima de leitura. + `scalingPolicy`: o Amazon Keyspaces oferece suporte à política de rastreamento de alvos. Para definir a política de rastreamento de alvos, você configura os seguintes parâmetros. + `targetValue`: o ajuste de escala automático do Amazon Keyspaces garante que o índice de capacidade consumida para capacidade provisionada permaneça nesse valor ou próximo a ele. Você define `targetValue` como uma porcentagem. + `disableScaleIn`: (Opcional) um `boolean` que especifica se `scale-in` está desativado ou ativado para a tabela. Por padrão, esse parâmetro é desabilitado. Para ativar `scale-in`, defina o valor de `boolean` como `FALSE`. Isso significa que a capacidade é reduzida automaticamente para uma tabela em seu nome. + `scaleOutCooldown`: a atividade de expansão aumenta a capacidade de throughput provisionado de sua tabela. Para adicionar um período de espera nas atividades de aumento da escala horizontalmente, especifique um valor, em segundos, para `ScaleOutCooldown`. O valor padrão é 0. Para obter mais informações sobre rastreamento de destino e período de espera, consulte [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) no *Guia do usuário do Application Auto Scaling*. + `scaleInCooldown`: uma atividade de redução da escala diminui o throughput provisionado de sua tabela. Para adicionar um período de espera nas atividades de redução da escala horizontalmente, especifique um valor, em segundos, para `ScaleInCooldown`. O valor padrão é 0. Para obter mais informações sobre rastreamento de destino e período de espera, consulte [Target Tracking Scaling Policies](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) no *Guia do usuário do Application Auto Scaling*. **nota** Para compreender melhor como o `TargetValue` funciona, suponha que você tenha uma tabela com uma configuração de throughput provisionado de 200 unidades de capacidade de gravação. Você decide criar uma política de dimensionamento para essa tabela, com um `TargetValue` de 70%. Agora, suponha que você comece a direcionar tráfego de gravação para a tabela de forma que o throughput de gravação real seja de 150 unidades de capacidade. A consumed-to-provisioned proporção agora é (150/200), ou 75 por cento. Essa taxa excede o valor pretendido. Portanto, o ajuste de escala automático aumenta a capacidade de gravação provisionada para 215 de modo que a taxa seja (150/215) ou 69,77%, tão próxima ao seu `TargetValue` quanto possível, mas sem excedê-lo. Para *mytable*, você define `TargetValue` para a capacidade de leitura e gravação em 50 por cento. O auto scaling do Amazon Keyspaces ajusta a taxa de transferência provisionada da tabela na faixa de 5 a 10 unidades de capacidade para que a proporção permaneça em ou perto de 50%. consumed-to-provisioned Para capacidade de leitura, você define os valores de `ScaleOutCooldown` e `ScaleInCooldown` para 60 segundos. Ao criar tabelas com configurações de ajuste de escala automático complexas, é útil carregar as configurações de ajuste de escala automático a partir de um arquivo JSON. No exemplo a seguir, você pode baixar o arquivo JSON de exemplo do [auto-scaling.zip](samples/auto-scaling.zip) e extrair `auto-scaling.json`, anotando o caminho para o arquivo. Neste exemplo, o arquivo JSON está localizado 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 ``` ------ # Configurar o ajuste de escala automático em uma tabela existente Você pode atualizar uma tabela do Amazon Keyspaces existente para ativar o ajuste de escala automático para a capacidade de gravação ou leitura da tabela. Se você estiver atualizando uma tabela que está atualmente no modo de capacidade sob demanda, primeiro precisará alterar o modo de capacidade da tabela para o modo de capacidade provisionada. Para obter mais informações sobre como atualizar as configurações de ajuste de escala automático para uma tabela multirregional, 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). 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 ] **Configure o ajuste de escala automático do Amazon Keyspaces para uma tabela existente** 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 vá para a guia **Capacidade**. 1. Na seção **Configurações de capacidade**, escolha **Editar**. 1. Em **Modo de capacidade**, verifique se a tabela está usando o modo de capacidade **provisionada**. 1. Selecione **Escalar automaticamente** e veja a etapa 6 em [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md) para editar a capacidade de leitura e gravação. 1. Quando as configurações de escala automática estiverem definidas, escolha **Salvar**. ------ #### [ Cassandra Query Language (CQL) ] **Configure uma tabela existente com o ajuste de escala automático do Amazon Keyspaces usando CQL** Você pode usar o comando `ALTER TABLE` para uma tabela do Amazon Keyspaces existente para configurar o ajuste de escala automático para a capacidade de gravação ou leitura da tabela. Se você estiver atualizando uma tabela que está atualmente no modo de capacidade sob demanda, precisará configurar `capacity_mode` como provisionada. Se sua tabela já estiver no modo de capacidade provisionada, esse campo poderá ser omitido. No exemplo a seguir, a instrução atualiza a tabela *mytable*, que está no modo de capacidade sob demanda. A instrução altera o modo de capacidade da tabela para o modo provisionado com o ajuste de escala automático ativado. A capacidade de gravação é configurada no intervalo de 5 a 10 unidades de capacidade com um valor de destino de 50%. A capacidade de leitura também é configurada no intervalo de 5 a 10 unidades de capacidade com um valor de destino de 50%. Para capacidade de leitura, você define os valores de `scale_out_cooldown` e `scale_in_cooldown` para 60 segundos. ``` 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 } } } }; ``` ------ #### [ CLI ] **Configure uma tabela existente com a escalabilidade automática do Amazon Keyspaces usando o AWS CLI** Para uma tabela do Amazon Keyspaces existente, você pode ativar o ajuste de escala automático para a capacidade de gravação ou leitura da tabela usando a operação `UpdateTable`. Você pode usar o seguinte comando para habilitar o ajuste de escala automático do Amazon Keyspaces para tabelas existentes. As configurações de ajuste de escala automático da tabela são carregadas de um arquivo JSON. No exemplo a seguir, você pode baixar o arquivo JSON de exemplo do [auto-scaling.zip](samples/auto-scaling.zip) e extrair `auto-scaling.json`, anotando o caminho para o arquivo. Neste exemplo, o arquivo JSON está localizado 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). Para obter mais informações sobre as configurações de ajuste de escala automático usadas no exemplo a seguir, consulte [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md). ``` 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 ``` ------ # Veja a configuração de ajuste de escala automático do Amazon Keyspaces da sua tabela Você pode usar o console, o CQL ou o AWS CLI para visualizar e atualizar as configurações de escalabilidade automática de uma tabela do Amazon Keyspaces. ------ #### [ Console ] **** **Visualização das configurações de ajuste de escala automático usando o console** 1. Escolha a tabela que você deseja visualizar e vá para a guia **Capacidade**. 1. Na seção **Configurações de capacidade**, escolha **Editar**. Você pode agora modificar as configurações nas seções **Capacidade de leitura** ou **Capacidade de gravação**. Para ter mais informações sobre essas configurações, consulte [Crie uma nova tabela com dimensionamento automático](autoscaling.createTable.md). ------ #### [ Cassandra Query Language (CQL) ] **Veja a política de ajuste de escala automático do Amazon Keyspaces da sua tabela usando CQL** Para visualizar os detalhes da configuração do ajuste de escala automático de uma tabela, use o comando a seguir. ``` SELECT * FROM system_schema_mcs.autoscaling WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable'; ``` A saída desse comando é semelhante a esta. ``` keyspace_name | table_name | provisioned_read_capacity_autoscaling_update | provisioned_write_capacity_autoscaling_update ---------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- mykeyspace | mytable | {'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 ] **Veja a política de escalabilidade automática do Amazon Keyspaces da sua tabela usando o AWS CLI** Para visualizar a configuração de ajuste de escala automático de uma tabela, 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 ``` A saída desse comando é semelhante a esta. ``` { "keyspaceName": "mykeyspace", "tableName": "mytable", "resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/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": 10, "scalingPolicy": { "targetTrackingScalingPolicyConfiguration": { "disableScaleIn": false, "scaleInCooldown": 60, "scaleOutCooldown": 60, "targetValue": 50.0 } } } } } ``` ------ # Desativar o ajuste de escala automático do Amazon Keyspaces para uma tabela Você pode desativar o ajuste de escala automático do Amazon Keyspaces para sua tabela a qualquer momento. Se você não precisar mais escalar a capacidade de leitura ou gravação da sua tabela, considere desabilitar o ajuste de escala automático para que o Amazon Keyspaces não continue modificando as configurações de capacidade de leitura ou gravação da sua tabela. É possível atualizar a tabela usando o console, o CQL ou a AWS CLI. Desativar o escalonamento automático também exclui os CloudWatch alarmes que foram criados em seu nome. 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). **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 ] **Desative a ajuste de escala automático do Amazon Keyspaces para sua tabela usando o console** **Uso do console do Amazon Keyspaces** 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 que você deseja atualizar e vá para 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. ------ #### [ Cassandra Query Language (CQL) ] **Desative o ajuste de escala automático do Amazon Keyspaces para sua tabela usando o CQL** A instrução a seguir desativa o ajuste de escala automático para a capacidade de gravação da tabela *mytable*. ``` ALTER TABLE mykeyspace.mytable WITH AUTOSCALING_SETTINGS = { 'provisioned_write_capacity_autoscaling_update': { 'autoscaling_disabled': true } }; ``` ------ #### [ CLI ] **Desative a escalabilidade automática do Amazon Keyspaces para sua tabela usando o AWS CLI** O comando a seguir desativa o ajuste de escala automático da capacidade de leitura da tabela. Também exclui os CloudWatch alarmes que foram criados em seu nome. ``` aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \ --auto-scaling-specification readCapacityAutoScaling={autoScalingDisabled=true} ``` ------ # Veja a atividade de auto scaling para uma tabela do Amazon Keyspaces na Amazon CloudWatch Você pode monitorar como a escalabilidade automática do Amazon Keyspaces usa recursos usando a Amazon CloudWatch, que gera métricas sobre seu uso e desempenho. Siga as etapas no [Guia do Application Auto Scaling usuário](https://docs.aws.amazon.com/autoscaling/application/userguide/monitoring-cloudwatch.html) para criar um CloudWatch painel.