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á.
Gerenciamento do Amazon DocumentDB Sem Servidor
Visualização e modificação da configuração do intervalo de capacidade de escalabilidade de um cluster
O argumento ServerlessV2ScalingConfiguration especifica a faixa de capacidade de escalabilidade de suas instâncias do DocumentDB Sem Servidor. Ele consiste nos valores mínimo e máximo de unidade de capacidade do DocumentDB (DCU) que se aplicam a todas as instâncias do DocumentDB Sem Servidor no cluster.
MinCapacity: a capacidade mínima de escalabilidade de qualquer instância com tecnologia sem servidor do DocumentDB no cluster.
MaxCapacity: a capacidade máxima de escalabilidade de qualquer instância com tecnologia sem servidor do DocumentDB no cluster.
As modificações na configuração de escalabilidade a seguir exigem a reinicialização da instância para refletir os novos valores MinCapacity e MaxCapacity:
Quaisquer alterações no valor MaxCapacity
Alteração do valor de MinCapacity para 1,0 ou inferior a partir de um valor maior
Alteração do valor de MinCapacity para um maior que 1,0 a partir de um valor menor
Para obter mais informações sobre a configuração de escalabilidade e como selecionar os limites adequados de capacidade de escalabilidade, consulte Configuração de escalabilidade do Amazon DocumentDB Sem Servidor.
- Using the Console de gerenciamento da AWS
-
O exemplo de Console de gerenciamento da AWS configuração a seguir mostra como visualizar e editar as configurações de escalabilidade de um cluster sem servidor DocumentDB.
-
Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB.
-
No painel de navegação, escolha Clusters.
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (
) no canto superior esquerdo da página.
A tabela Clusters será exibida.
-
Na tabela Clusters, marque a caixa de seleção do cluster para o qual você deseja modificar a capacidade de escalabilidade.
-
Escolha Ações e, em seguida, Modificar.
A caixa de diálogo Modificar cluster será exibida.
-
Localize a seção Configuração de capacidade de tecnologia sem servidor e defina a configuração de escalabilidade (Intervalo de capacidade) com base na descrição da capacidade na caixa de diálogo.
Para obter mais informações sobre escalabilidade e intervalos de capacidade, consulte Configuração de escalabilidade do Amazon DocumentDB Sem Servidor.
-
Escolha Continue.
-
Em Scheduling of modifications (Programação de modificações), selecione Apply immediately (Aplicar imediatamente).
-
Escolha Modificar Cluster.
-
Depois que a modificação for concluída, cada instância com tecnologia sem servidor deverá ser reinicializada. Para minimizar a indisponibilidade do gravador, execute a sequência de operações a seguir:
Reinicialize cada instância de leitor com tecnologia sem servidor.
Selecione a instância do leitor, escolha Ações e, em seguida, Reinicializar.
Aguarde até que o status da instância retorne para Disponível.
Execute uma operação de failover em uma instância com tecnologia sem servidor reinicializada.
Selecione o cluster, escolha Ações e, em seguida, Failover.
Aguarde a conclusão da operação de failover.
Reinicialize a instância com tecnologia sem servidor restante.
Selecione a instância restante, escolha Ações e, em seguida, Reinicializar.
Aguarde até que o status da instância retorne para Disponível.
- Using the AWS CLI
-
O exemplo AWS CLI de configuração a seguir mostra a configuração de escalabilidade atual.
No exemplo a seguir, substitua cada um user input placeholder por suas próprias informações ou parâmetros de configuração.
A configuração de escalabilidade atual do cluster pode ser visualizada usando o describe-db-clusters AWS CLI comando:
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[0].ServerlessV2ScalingConfiguration'
Veja a seguir a saída desse comando:
{
"MinCapacity": 0.5,
"MaxCapacity": 16.0
}
A configuração de escalabilidade do cluster pode ser modificada usando o comando modify-db-cluster:
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=32
Após a conclusão, cada instância com tecnologia sem servidor deverá ser reinicializada. Para minimizar a indisponibilidade do gravador, podemos executar a sequência de operações a seguir:
aws docdb reboot-db-instance \
--db-instance-identifier sample-serverless-instance-reader
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-reader
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-reader
aws docdb reboot-db-instance \
--db-instance-identifier sample-serverless-instance-writer
aws docdb wait db-instance-available \
--db-instance-identifier sample-serverless-instance-writer
aws docdb failover-db-cluster \
--db-cluster-identifier sample-cluster \
--target-db-instance-identifier sample-serverless-instance-writer
No caso de clusters que contenham várias instâncias do DocumentDB Sem Servidor ou uma mistura de instâncias com tecnologia sem servidor e provisionadas, preste atenção à configuração do nível de promoção de cada instância com tecnologia sem servidor. Essa configuração controla mais aspectos do comportamento das instâncias com tecnologia sem servidor do que das instâncias provisionadas.
No caso de instâncias provisionadas, a escolha do nível de 0 a 15 determina apenas a ordem na qual o Amazon DocumentDB escolhe qual instância de leitor promover a gravador durante uma operação de failover. Contudo, para instâncias com tecnologia sem servidor, o número do nível também determina se a escala da instância será aumentada verticalmente para corresponder à capacidade da instância do gravador ou se será escalada independentemente, com base somente na própria workload. As instâncias de leitor com tecnologia sem servidor no nível 0 ou 1 são mantidas em uma capacidade mínima pelo menos tão alta quanto a instância do gravador. Dessa forma, elas estarão prontas para assumir o controle da instância do gravador em caso de failover. Se a instância do gravador for uma instância provisionada, o Amazon DocumentDB estimará a capacidade do DocumentDB Sem Servidor equivalente. Ele usa essa estimativa como a capacidade mínima para a instância do leitor com tecnologia sem servidor.
As instâncias de leitor do DocumentDB Sem Servidor nos níveis 2 a 15 não têm a mesma restrição em sua capacidade mínima. Quando estiverem ociosas, elas poderão ter a escala reduzida na vertical para o valor mínimo da unidade de capacidade do DocumentDB (DCU) especificado no intervalo de capacidade do cluster.
- Using the Console de gerenciamento da AWS
-
O exemplo de Console de gerenciamento da AWS configuração a seguir mostra como visualizar e modificar as configurações de nível promocional do leitor de instâncias sem servidor do DocumentDB.
-
Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB.
Os níveis de promoção de cada instância são exibidos na coluna Nível de promoção, no Console de gerenciamento da AWS.
-
No painel de navegação, escolha Clusters.
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu () no canto superior esquerdo da página.
A tabela Clusters será exibida.
-
Na tabela Clusters, marque a caixa de seleção da instância para a qual você deseja modificar o nível de promoção.
-
Escolha Ações e, em seguida, Modificar.
A caixa de diálogo Modificar instância será exibida.
-
Localize a seção Failover e defina Nível de promoção para o nível desejado.
-
Escolha Continue.
-
Em Scheduling of modifications (Programação de modificações), selecione Apply immediately (Aplicar imediatamente).
-
Escolha Modify instance (Modificar instância).
- Using the AWS CLI
-
O exemplo AWS CLI de configuração a seguir mostra a configuração de escalabilidade atual.
No exemplo a seguir, substitua cada um user input placeholder por suas próprias informações ou parâmetros de configuração.
Os níveis de promoção de todas as instâncias em um cluster podem ser visualizados usando o describe-db-clusters AWS CLI comando:
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[0].DBClusterMembers' \
--output table
Veja a seguir a saída desse comando:
--------------------------------------------------------------------------------------------------------
| DescribeDBClusters |
+--------------------------------+---------------------------------+------------------+----------------+
| DBClusterParameterGroupStatus | DBInstanceIdentifier | IsClusterWriter | PromotionTier |
+--------------------------------+---------------------------------+------------------+----------------+
| in-sync | sample-serverless-instance-2 | False | 1 |
| in-sync | sample-serverless-instance-1 | True | 1 |
+--------------------------------+---------------------------------+------------------+----------------+
O nível de promoção de uma instância específica pode ser modificado usando o comando modify-db-instance:
aws docdb modify-db-instance \
--db-instance-identifier sample-serverless-instance-2 \
--promotion-tier 3
