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á.
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.
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.
- Console
-
Como criar uma nova tabela com ajuste de escala automático habilitado no console
-
No painel de navegação, selecione Tables (Tabelas) e Create table (Criar tabela).
-
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.
-
Na seção Colunas, crie o esquema para sua tabela.
-
Na seção Chave primária, defina a chave primária da tabela e selecione colunas de clustering opcionais.
Na seção Configurações da tabela, selecione Personalizar configurações.
-
Continue com as configurações de capacidade de leitura/gravação.
-
Para o Modo de capacidade, escolha Provisionado.
-
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).
-
-
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.
-
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ê definetarget_value
como uma porcentagem. -
disableScaleIn
: (Opcional) umboolean
que especifica sescale-in
está desativado ou ativado para a tabela. Por padrão, esse parâmetro é desabilitado. Para ativarscale-in
, defina o valor deboolean
comoFALSE
. 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, parascale_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 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, parascale_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 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 umtarget_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 deScaleOutCooldown
eScaleInCooldown
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 paraautoScalingSpecification
:-
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ê definetargetValue
como uma porcentagem. -
disableScaleIn
: (Opcional) umboolean
que especifica sescale-in
está desativado ou ativado para a tabela. Por padrão, esse parâmetro é desabilitado. Para ativarscale-in
, defina o valor deboolean
comoFALSE
. 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, paraScaleOutCooldown
. O valor padrão é 0. Para obter mais informações sobre rastreamento de destino e período de espera, consulte Target Tracking Scaling Policies 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, paraScaleInCooldown
. O valor padrão é 0. Para obter mais informações sobre rastreamento de destino e período de espera, consulte Target Tracking Scaling Policies 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 umTargetValue
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 deScaleOutCooldown
eScaleInCooldown
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 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.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
-