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á.
# Visão geral dos clusters globais do Amazon DocumentDB
## O que é um cluster global?
Um cluster global consiste em uma região primária e até 10 regiões secundárias somente de leitura. Você emite operações de gravação diretamente no cluster primário na região primária e o Amazon DocumentDB automaticamente replica os dados para as regiões secundárias usando a infraestrutura dedicada. Geralmente, a latência é inferior a um segundo.
## Por que os clusters globais são úteis?
+ **Recuperação de paralisações em toda a região**: no caso de uma paralisação em toda a região, você pode promover um dos clusters secundários a um cluster primário em minutos, com um objetivo de tempo de recuperação (RTO) típico de menos de um minuto. Normalmente, o objetivo de ponto de recuperação (RPO) é medido em segundos, mas isso depende do atraso em toda a rede no momento da falha.
+ **Leitura global com latência local**: se você tem escritórios em todo o mundo, é possível usar um cluster global para manter suas principais fontes de informações atualizadas na Região principal. Escritórios em outras Regiões podem acessar as informações em sua própria Região com latência local.
+ **Clusters secundários escaláveis**: você pode dimensionar seus clusters secundários adicionando mais instâncias somente para leitura a uma região secundária. O cluster secundário é somente leitura, portanto pode oferecer suporte a até 16 instâncias de réplica somente leitura, em vez do limite normal de 15 para um único cluster.
+ **Replicação rápida de clusters de primários para secundários**: replicação realizada por um cluster global tem pouco impacto no desempenho do cluster de banco de dados primário. Os recursos das instâncias de banco de dados são totalmente dedicados para atender as workloads de leitura e gravação.
## Quais são as limitações atuais dos clusters globais?
+ Os clusters globais não são compatíveis com a versão 3.6 do Amazon DocumentDB.
+ Os clusters globais são compatíveis com todos os tipos de instância, exceto db.t3, db.t4g e db.r4.
+ Os clusters globais não estão disponíveis nas regiões a seguir: América do Sul (São Paulo), Europa (Milão), China (Pequim) e China (Ningxia).
+ Não há suporte para transição e failover global quando as regiões estão em versões de mecanismo diferentes. Há suporte para failover manual quando existe uma incompatibilidade entre as versões do mecanismo.
+ Somente o cluster primário realiza operações de gravação. Os clientes que realizam operações de gravação se conectam ao endpoint do cluster primário.
+ É possível ter no máximo 10 regiões secundárias e uma região primária no seu cluster.
+ Um cluster secundário não pode ser interrompido. Um cluster primário não pode ser interrompido se tiver clusters secundários associados a ele. Somente um cluster regional que não tenha clusters secundários pode ser interrompido.
+ Réplicas anexadas ao cluster secundário podem ser reiniciadas em determinadas circunstâncias. Se a instância da região primária for reiniciada ou sofrer failover, as réplicas da região secundária também serão reiniciadas. O cluster fica indisponível até que todas as réplicas estejam novamente sincronizadas com a instância do gravador do cluster de banco de dados primário. Esse comportamento é esperado. Certifique-se de que você entendeu o impacto no seu cluster global antes de fazer alterações no cluster primário.
+ Você não pode usar fluxos de alteração em clusters secundários.
**Topics**
+ [O que é um cluster global?](#w2aac33b9b3)
+ [Por que os clusters globais são úteis?](#w2aac33b9b5)
+ [Quais são as limitações atuais dos clusters globais?](#w2aac33b9b7)
+ [Guia de início rápido](global-clusters.get-started.md)
+ [Gerenciar clusters globais](global-clusters.manage.md)
+ [Conectar clusters globais](global-clusters-connect.md)
+ [Monitorar clusters globais](global-clusters-monitor.md)
+ [Recuperação de desastres](global-clusters-disaster-recovery.md)
# Guia de início rápido: clusters globais
**Topics**
+ [Configuração](#global-clusters.config)
+ [Criar um cluster global](#global-clusters-create)
+ [Adição de uma região a um cluster global](#global-clusters.add-region)
+ [Compartilhar um snapshot](#global-clusters.snapshot)
## Configuração
O cluster global do Amazon DocumentDB abrange pelo menos dois. Regiões da AWS A região primária oferece suporte a um cluster que tem uma instância primária (gravadora) e até 15 instâncias de réplica, enquanto uma região secundária executa um cluster somente de leitura composto inteiramente por até 16 instâncias de réplica. Um cluster global pode ter até cinco regiões secundárias. A tabela lista o máximo de clusters, instâncias e réplicas permitidos em um cluster global.
| Description | Primária Região da AWS | Secundário Região da AWS |
| --- | --- | --- |
| Clusters | 1 | 5 (máximo) |
| Instâncias do gravador | 1 | 0 |
| Instâncias somente leitura (réplicas do Amazon DocumentDB), por cluster | 15 (máximo) | 16 (total) |
| Instâncias somente leitura (máximo permitido, considerando o número real de regiões secundárias) | 15 - s | s = número total de secundários Regiões da AWS |
Os clusters têm os seguintes requisitos específicos:
+ **Requisitos de classe de instância de banco de dados** — Você só pode usar as classes de instância `db.r5` e `db.r6g`.
+ **Região da AWS requisitos** — O cluster primário deve estar em uma região e pelo menos um cluster secundário deve estar em uma região diferente da mesma conta. É possível criar até cinco clusters secundários (somente de leitura), e cada um deve estar em uma região diferente. Em outras palavras, não pode haver dois clusters na mesma região.
+ **Requisitos de nome**: os nomes escolhidos para cada um de seus clusters devem ser exclusivos em todas as regiões. Não é possível usar o mesmo nome para clusters diferentes, mesmo que eles estejam em regiões diferentes.
## Criação de um cluster global do Amazon DocumentDB
Você está pronto para criar seu primeiro cluster global? Nesta seção, explicaremos como criar um novo cluster global com novos clusters e instâncias de banco de dados, usando Console de gerenciamento da AWS ou AWS CLI com as instruções a seguir.
### Usando o Console de gerenciamento da AWS
1. No Console de gerenciamento da AWS, navegue até **Amazon DocumentDB**.
1. Ao acessar o console do Amazon DocumentDB, escolha **Clusters.**
![\[A página Clusters no console do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Escolha **Criar**.
![\[O botão Criar, exibido no canto superior direito da tabela Clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Preencha a seção **Configuração** do formulário **Criar cluster do Amazon DocumentDB**:
+ **Identificador de cluster**: você pode inserir um identificador exclusivo para essa instância ou permitir que o Amazon DocumentDB forneça o identificador da instância com base no identificador do cluster.
+ Versão do mecanismo: escolha **4.0.0**
+ Classe de instância: escolha **db.r5.large**
+ Número de instâncias: escolha **3**.
![\[Formulário Opções de configuração para criação de um cluster do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. Na seção **Autenticação**, preencha um nome de usuário principal e uma senha mestra.
![\[Formulário de autenticação para especificação de um nome de usuário principal e senha para um novo cluster do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Escolha **Exibir configurações avançadas**.
![\[Botão de alternância Exibir configurações avançadas ao lado dos botões Cancelar e Criar cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. Na seção **Configurações de rede**:
+ Mantenha as opções padrão para **nuvem privada virtual (VPC)** e **Grupo de sub-redes**.
![\[Formulário Configurações de rede mostrando as opções de VPC, grupo de sub-redes e grupos de segurança de VPC. Os campos VPC e Grupo de sub-redes têm as opções padrão selecionadas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Em **Grupos de segurança de VPC**, um **padrão (VPC)** já deve ter sido adicionado.
![\[Formulário Configurações de rede mostrando a VPC padrão já adicionada.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Insira `DocDB` no campo **Grupos de segurança de VPC** e selecione **DocDB-Inbound (VFC)**.
![\[VFC DocDB-Inbound selecionada no menu suspenso Grupos de segurança de VPC.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. Para **Opções de cluster** e **E ncryption-at-rest**, deixe nas seleções padrão.
![\[Opções de cluster e Encryption-at-rest formulários com as opções padrão selecionadas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Em **Backup** e **Exportações de logs**, mantenha as seleções padrão.
![\[Formulários Backup e Exportação de logs com as opções padrão selecionadas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Em **Manutenção**, **Tags** e **Proteção contra exclusão**, mantenha as seleções padrão.
![\[Formulários Manutenção, Tags e Proteção contra exclusão com as opções padrão selecionadas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Agora clique no botão que diz **Criar cluster**.
![\[O botão Criar cluster é exibido no final do processo de criação do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Usando o AWS CLI
Para criar um cluster regional do Amazon DocumentDB, chame o. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) O AWS CLI comando a seguir cria um cluster Amazon DocumentDB chamado. `global-cluster-id` Para obter mais informações sobre a proteção contra exclusão, consulte [Excluir um cluster do Amazon DocumentDB](db-cluster-delete.md).
Além disso, `--engine-version` é um parâmetro opcional padrão para a versão mais recente do mecanismo principal. A versão padrão atual do mecanismo é `5.0.0` (nota: o Amazon DocumentDB 8.0 está disponível, mas deve ser explicitamente especificado como). `8.0.0` Quando novas versões principais do mecanismo forem lançadas, a versão padrão `--engine-version` será atualizada para refletir a última versão principal do mecanismo. Como resultado, para cargas de trabalho de produção, especialmente aquelas que dependem de scripts, automação ou CloudFormation modelos, recomendamos que você especifique explicitamente a `--engine-version` para a versão principal pretendida.
Se um `db-subnet-group-name` ou `vpc-security-group-id` não for especificado, o Amazon DocumentDB usará o grupo de sub-redes padrão e o grupo de segurança da Amazon VPC para a região em questão.
No exemplo a seguir, substitua cada *user input placeholder* por suas próprias informações.
Para Linux, macOS ou Unix:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Para Windows:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
Leva alguns minutos para criar o cluster. Você pode usar o Console de gerenciamento da AWS ou AWS CLI para monitorar o status do seu cluster. Para obter mais informações, consulte [Monitoramento do status de um cluster do Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**Importante**
Quando você usa o AWS CLI para criar um cluster regional do Amazon DocumentDB, nenhuma instância é criada. Consequentemente, é necessário criar explicitamente uma instância principal e qualquer instância de réplica de que precise. Você pode usar o console ou AWS CLI criar as instâncias. Para obter mais informações, consulte [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md) e [CreateDBCluster](API_CreateDBCluster.md) na Referência da API do Amazon DocumentDB.
Quando seu cluster regional estiver disponível, será possível adicionar um cluster secundário em outra região com as instruções a seguir: [Adicionar um Região da AWS a um cluster global do Amazon DocumentDB](#global-clusters.add-region). Quando você adicionar uma região, seu cluster regional se tornará seu cluster primário, e você terá um novo cluster secundário na região escolhida.
## Adicionar um Região da AWS a um cluster global do Amazon DocumentDB
Um cluster global precisa de pelo menos um cluster secundário em uma região diferente do cluster primário, e é possível adicionar até cinco clusters secundários. Observe que, para cada cluster secundário que você adicionar, deverá reduzir em um o número de réplicas permitidas no cluster primário. Por exemplo, se o seu cluster global tiver cinco regiões secundárias, o cluster primário poderá ter apenas 10 (em vez de 15) réplicas. Para obter mais informações, consulte [Requisitos de configuração de um cluster global Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Usando o Console de gerenciamento da AWS
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB.
1. No painel de navegação, escolha **Clusters**.
![\[A página Clusters no console do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Escolha o cluster ao qual você deseja adicionar ao cluster secundário. Certifique-se de que o cluster seja `Available`.
![\[Lista de clusters regionais e globais mostrando o status disponível, com mydocdbglobalcluster destacado.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. Selecione a lista suspensa de **Ações** e escolha **Adicionar região**.
![\[A lista suspensa Ações na interface Clusters mostra a opção Adicionar região.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. Na página **Adicionar uma Região da AWS**, escolha a região secundária. Observe que você não pode escolher uma região que já tenha um cluster secundário para o mesmo cluster global. Além disso, não ela pode ser a mesma região que o cluster primário. Se essa for a primeira região que estiver adicionando, também será necessário especificar um identificador de cluster global de sua escolha.
![\[Escolha uma região secundária usando o menu suspenso em Adicionar um Região da AWS formulário.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Preencha os campos restantes para o cluster secundário na nova região e selecione **Criar cluster**. Depois de terminar de adicionar a região, será possível vê-la na lista de **Clusters** no Console de gerenciamento da AWS.
![\[Etapas finais da adição de uma região a um cluster, mostrando o formulário de configuração, a estimativa de custo por hora e o botão Criar cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Usando o AWS CLI
+ Use o comando da CLI `create-db-cluster` com o nome `(--global-cluster-identifier)` de seu cluster global. Para outros parâmetros, faça o seguinte:
+ Para`--region`, escolha uma Região da AWS diferente da sua região principal.
+ Escolha valores específicos para os parâmetros `--engine` e `--engine-version`.
+ Para um cluster criptografado, especifique seu primário Região da AWS como o `--source-region` de criptografia.
O exemplo a seguir cria um novo cluster do Amazon DocumentDB e o anexa ao cluster global como um cluster secundário somente leitura. Na última etapa, a instância é adicionada ao novo cluster.
No exemplo a seguir, substitua cada *user input placeholder* por suas próprias informações.
Para Linux, macOS ou Unix:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Para Windows:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Usando um snapshot para seu cluster Amazon DocumentDB global
É possível restaurar um snapshot de um cluster do Amazon DocumentDB para usar como ponto de partida para seu cluster global. Para fazer isso, você deve restaurar o snapshot e criar um novo cluster. Isso servirá como o cluster principal do seu cluster global. Em seguida, adicione uma outra região ao cluster restaurado, transformando-o em um cluster global.
# Gerenciar um cluster global do Amazon DocumentDB
Realize a maVocê realiza a maioria das operações de gerenciamento nos clusters individuais que compõem um cluster global.ioria das operações de gerenciamento nos clusters individuais que constituem um banco de dados global do . Ao selecionar **Recursos relacionados ao grupo** na página **Clusters** do console, você verá o cluster primário e os clusters secundários agrupados sob o cluster global associado.
A guia **Configuração** de um cluster global mostra Regiões da AWS onde os clusters estão sendo executados, a versão e o identificador global do cluster.
**Topics**
+ [Modificar clusters globais](#global-clusters.modify)
+ [Modificar parâmetros](#global-clusters.modify-parameters)
+ [Remover clusters globais](#global-clusters.remove)
+ [Excluir clusters globais](#global-clusters.delete)
+ [Clusters sem cabeça](#global-clusters.headless)
## Modificar um cluster global do Amazon DocumentDB
A página **Clusters** na Console de gerenciamento da AWS lista todos os seus clusters globais, mostrando o cluster primário e os clusters secundários de cada um. O cluster global tem suas próprias definições de configuração. Especificamente, ele tem regiões associadas a seus clusters primário e secundário.
Quando você faz alterações no cluster global, você tem a chance de cancelar as alterações.
Quando você escolhe Continue, você confirma as alterações.
## Modificando parâmetros de um cluster global do Amazon DocumentDB
É possível configurar os grupos de parâmetros do cluster independentemente para cada cluster dentro do cluster global. A maioria dos parâmetros funciona da mesma forma que para outros tipos de clusters do Amazon DocumentDB. Recomendamos que você mantenha as configurações consistentes entre todos os clusters em um banco de dados global. Isso ajuda a evitar mudanças inesperadas de comportamento se você promover um cluster secundário para ser o primário.
Por exemplo, use as mesmas configurações para os fusos horários e os conjuntos de caracteres a fim de evitar um comportamento inconsistente caso um cluster diferente assuma como o cluster primário.
## Remover um cluster de um cluster global do Amazon DocumentDB
Há várias situações em que você pode querer remover clusters do seu cluster global. Por exemplo, você pode querer remover um cluster de um clster global se o cluster primário se tornar degradado ou isolado. Em seguida, ele se torna um cluster provisionado autônomo que pode ser usado para criar um novo cluster global. Para saber mais, consulte [Realizar um failover manual para um cluster global do Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover).
Você também pode querer remover clusters porque deseja excluir um cluster global que não é mais necessário. Não é possível excluir o cluster global até que você desanexe todos os clusters associados, deixando o primário por último. Para obter mais informações, consulte [Exclusão de um cluster global do Amazon DocumentDB](#global-clusters.delete).
**nota**
Quando um cluster é separado do cluster global, ele não é mais sincronizado com o primário. Ele se torna um cluster provisionado autônomo com recursos completos. read/write Além disso, ele não está mais visível no console do Amazon DocumentDB. Ela só é visível quando você seleciona a região no console em que o cluster estava localizado.
Você pode remover clusters do seu cluster global usando a Console de gerenciamento da AWS AWS CLI, a ou a API do RDS.
------
#### [ Using the Console de gerenciamento da AWS ]
1. Faça login no Console de gerenciamento da AWS e navegue até o console do Amazon DocumentDB.
1. No painel de navegação esquerdo, escolha **Clusters**.
![\[Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Expanda o cluster global para que você possa ver todos os clusters secundários. Selecione os clusters secundários que você deseja remover. Escolha **Ações** e, no menu suspenso, escolha **Remover do global**.
![\[Imagem: a caixa de navegação Clusters mostrando a seleção de um cluster secundário existente e destacando a ação “Remover do global”.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. Será exibido um prompt solicitando a confirmação de que você deseja desconectar o secundário do cluster global. Escolha **Remover e promover** para remover o cluster do cluster global.
![\[Imagem: o prompt Remover e promover.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
Agora esse cluster não está mais servindo como secundário e não está mais sincronizado com o cluster primário. É um cluster autônomo com read/write capacidade total.
Depois de remover ou excluir todos os clusters secundários, remova o cluster primário da mesma maneira. Não é possível desanexar ou remover o cluster primário do cluster global até que você tenha removido todos os clusters secundários. O cluster global pode permanecer na lista de clusters, com zero regiões AZs e. É possível excluir se não quiser mais usar esse cluster global.
------
#### [ Using the AWS CLI ]
Para remover um cluster de um cluster global, execute o comando CLI `remove-from-global-cluster` com os seguintes parâmetros:
+ `--global-cluster-identifier`: o nome (identificador) do seu cluster global.
+ `--db-cluster-identifier` — O nome de cada cluster a ser removido do cluster global.
Os exemplos a seguir removem primeiro um cluster secundário e depois o cluster primário de um cluster global.
Para Linux, macOS ou Unix:
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
Repita o comando `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` para cada região secundária em seu cluster global.
Para Windows:
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
Repita o comando `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` para cada região secundária em seu cluster global.
------
## Exclusão de um cluster global do Amazon DocumentDB
Para excluir um cluster global, faça o seguinte:
+ Remova todos os clusters secundários do cluster global. Cada cluster se torna um cluster autônomo. Veja a seção anterior,[Remover um cluster de um cluster global do Amazon DocumentDB](#global-clusters.remove).
+ Em cada cluster autônomo, exclua todas as réplicas.
+ Remova o cluster primário do cluster global. Isso se torna um cluster autônomo.
+ No cluster primário, primeiro exclua todas as réplicas e, em seguida, exclua a instância primária. A exclusão da instância primária do cluster recém-autônomo também remove, normalmente, o cluster e o cluster global.
------
#### [ Using the Console de gerenciamento da AWS ]
1. Faça login no Console de gerenciamento da AWS e navegue até o console do Amazon DocumentDB.
1. Escolha **Clusters** e encontre o cluster global que você deseja excluir.
![\[Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. Com seu cluster global selecionado, escolha **Excluir** no menu **Ações**.
![\[Imagem: a caixa de navegação Clusters mostrando a seleção de um cluster global e destacando a ação “Excluir”.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
Confirme se todos os clusters foram removidos do cluster global. O cluster global deve mostrar zero regiões AZs e um tamanho de zero clusters. Se o cluster global contiver clusters, você ainda não poderá excluí-lo. Primeiro, você terá que seguir as instruções da etapa anterior, **[Remover um cluster de um cluster global do Amazon DocumentDB](#global-clusters.remove)**.
------
#### [ Using the AWS CLI ]
Para excluir um cluster global, execute o comando `delete-global-cluster` CLI com o nome do Região da AWS e o identificador global do cluster, conforme mostrado no exemplo a seguir.
Para Linux, macOS ou Unix:
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Para Windows:
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## Criação de um cluster sem cabeça do Amazon DocumentDB em uma região secundária
Embora um cluster global do Amazon DocumentDB exija pelo menos um cluster secundário em um cluster Região da AWS diferente do primário, você pode usar uma configuração sem cabeçalho para o cluster secundário. Um cluster secundário sem cabeça do Amazon DocumentDB é aquele sem uma instância. Esse tipo de configuração pode reduzir as despesas de um cluster global. Em um cluster do Amazon DocumentDB, a computação e o armazenamento são desacoplados. Sem a instância, você não é cobrado pela computação, apenas pelo armazenamento. Se for configurado corretamente, o volume de armazenamento de um secundário sem cabeça é mantido em sincronia com o cluster primário.
Você adiciona o cluster secundário como normalmente faz ao criar um cluster global do Amazon DocumentDB. No entanto, depois que o cluster primário iniciar a replicação para o secundário, você excluirá a instância somente leitura do cluster secundário. Esse cluster secundário agora é considerado "sem cabeça" porque não tem mais uma instância. No entanto, o volume de armazenamento é mantido em sincronia com o cluster principal do Amazon DocumentDB.
**Importante**
Recomendamos clusters sem cabeça apenas para clientes que possam tolerar falhas em toda a região por mais de 15 minutos. Isso ocorre porque a recuperação de uma falha em toda a região com um cluster secundário sem cabeça exigirá que o usuário crie uma nova instância após a falha. Uma nova instância pode levar de 10 a 15 minutos para ficar disponível.
### Como Adicionar um Cluster Secundário sem Cabeça ao seu Cluster Global
1. Faça login no Console de gerenciamento da AWS e abra o console do [Amazon DocumentDB](https://console.aws.amazon.com/rds/).
1. No painel de navegação esquerdo, escolha **Clusters**.
1. Escolha o cluster global que precisa de um cluster secundário. Certifique-se de que o cluster primário seja `Available`.
1. Para **Ações**, selecione **Adicionar região**.
1. Na página **Adicionar uma região**, escolha a região secundária.
**nota**
Não é possível escolher uma região que já tenha um cluster secundário para o mesmo cluster global. Além disso, não pode ser a mesma região que o cluster primário.
1. Preencha os campos restantes para o cluster secundário na nova região. Essas são as mesmas opções de configuração de qualquer instância de cluster.
1. Adicionar região. Depois de terminar de adicionar a região ao seu cluster global, você a verá na lista de `Clusters` no Console de gerenciamento da AWS.
1. Verifique o status do cluster secundário e de sua instância de leitura antes de continuar, usando o Console de gerenciamento da AWS ou AWS CLI o. Aqui está um exemplo de comando se você usar o AWS CLI:
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
Pode levar vários minutos para que o status de um cluster secundário recém-adicionado mude de criado para disponível. Quando o cluster estiver disponível, será possível excluir a instância do leitor.
1. Selecione a instância do leitor no cluster secundário e, em seguida, selecione **Excluir**.
1. Depois de excluir a instância do leitor, o cluster secundário continua fazendo parte do cluster global. Ele não deve ter nenhuma instância associada a ele.
**nota**
É possível usar esse cluster secundário sem cabeça do Amazon DocumentDB para recuperar manualmente o cluster global do Amazon DocumentDB de uma interrupção não planejada na região primária, se essa interrupção ocorrer.
# Conexão com um cluster global do Amazon DocumentDB
A forma como você se conecta a um cluster global depende de se você precisa gravar no cluster ou ler a partir do cluster.
+ Para solicitações ou consultas somente para leitura, conecte-se ao endpoint do leitor para o cluster em sua Região da AWS.
+ Para executar instruções Data Manipulation Language (DML) ou Data Definition Language (DDL), conecte-se ao endpoint cluster do cluster primário. Esse endpoint pode estar em um local Região da AWS diferente do seu aplicativo.
Ao exibir um cluster global no console, é possível ver todos os endpoints de finalidade geral associados a todos os clusters.
A forma como você se conecta a um cluster global depende de se você precisa gravar no banco de dados ou ler a partir do banco de dados. Para operações de DDL, DML e leitura às quais você gostaria de atender na região primária, você deve se conectar ao seu cluster primário. Recomendamos a conexão com o cluster primário usando o endpoint do cluster no modo conjunto de réplicas, com uma preferência de leitura de `secondaryPreferred=true`. Isso roteará o tráfego de gravação para a instância de gravação do seu cluster primário e o tráfego de leitura para a instância de réplica do seu cluster primário.
Para tráfego somente de leitura entre regiões, você deve se conectar a um de seus clusters secundários. Recomendamos a conexão com o cluster secundário usando o endpoint do cluster e o modo de conjunto de réplicas. Como todas as instâncias são instâncias de réplica somente para leitura, você não precisa especificar uma preferência de leitura. Para minimizar latência, escolha o endpoint de leitor que está na sua Região ou na Região mais próxima de você.
# Monitorar clusters globais do Amazon DocumentDB
O Amazon DocumentDB (com compatibilidade com o MongoDB) se integra CloudWatch para que você possa coletar e analisar métricas operacionais para seus clusters. Você pode monitorar essas métricas usando o CloudWatch console, o console do Amazon DocumentDB, o AWS Command Line Interface (AWS CLI) ou a CloudWatch API.
Para monitorar um cluster global, use as CloudWatch métricas a seguir.
| Métrica | Description |
| --- | --- |
| GlobalClusterReplicatedWriteIO | O número médio de I/O operações de gravação cobradas replicadas do volume do cluster no volume primário Região da AWS para o volume do cluster no secundário Região da AWS, relatado em intervalos de 5 minutos. O número de ReplicatedWriteIOs replicados para cada região secundária é o mesmo que o número de VolumeWriteIOPs na região realizados pela região primária. |
| GlobalClusterDataTransferBytes | A quantidade de dados transferidos do cluster primário Região da AWS para o secundário Região da AWS, medida em bytes. |
| GlobalClusterReplicationLag | A quantidade de atraso, em milissegundos, ao replicar eventos de alteração do cluster primário Região da AWS para o secundário Região da AWS |
Para obter mais informações sobre como visualizar essas métricas, consulte [Visualização de CloudWatch dados](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data).
# Recuperação de desastres e clusters globais do Amazon DocumentDB
**Topics**
+ [Realizar um failover gerenciado para um cluster global do Amazon DocumentDB](#managed-failover)
+ [Realizar um failover manual para um cluster global do Amazon DocumentDB](#manual-failover)
+ [Como realizar uma transição para um cluster global do Amazon DocumentDB](#global-cluster-switchover)
+ [Desbloqueio da transição ou do failover de um cluster global](#unblocking-gc-so-fo)
Ao usar um cluster global, você pode se recuperar rapidamente de desastres, como falhas na região. A recuperação de desastres é normalmente medida usando valores de RTO e RPO.
+ **Objetivo de tempo de recuperação (RTO)**: tempo que um sistema leva para retornar a um estado de trabalho após um desastre. Em outras palavras, o RTO mede o tempo de inatividade. Para um cluster global, RTO em minutos.
+ **Objetivo de ponto de recuperação (RPO)**: quantidade de dados que podem ser perdidos (medidos no tempo). Para um cluster global, o RPO é normalmente medido em segundos.
+ Para recuperar de uma paralisação não planejada, você pode executar um failover entre regiões para um dos secundários em seu cluster global. Quando o cluster global tem várias regiões secundárias, lembre-se de desanexar todas as regiões secundárias que quiser promover a primárias. Em seguida, promova uma dessas regiões secundárias para ser a nova Região da AWS primária. Por fim, crie novos clusters em cada uma das outras regiões secundárias e anexe esses clusters ao seu cluster global.
## Realizar um failover gerenciado para um cluster global do Amazon DocumentDB
Essa abordagem destina-se à continuidade dos negócios no caso de um desastre regional real ou de uma interrupção completa do nível de serviço.
Durante um failover gerenciado, o cluster primário sofre failover para que você escolha a região secundária, enquanto a topologia de replicação existente do cluster global do Amazon DocumentDB é mantida. O cluster secundário escolhido promove um dos nós somente leitura ao status de gravador completo. Essa etapa permite que o cluster assuma a função de cluster primário. O banco de dados ficará indisponível por um curto período enquanto o cluster estiver assumindo a nova função. Os dados que não foram replicados do cluster primário antigo para o cluster secundário escolhido são perdidos quando esse secundário se torna o novo primário. O volume primário antigo faz o possível para tirar um snapshot antes de sincronizar com o novo primário, para que os dados não replicados sejam preservados no instantâneo.
**nota**
Você só poderá realizar um failover de cluster gerenciado entre regiões em um cluster global do Amazon DocumentDB se os clusters primário e todos os secundários tiverem as mesmas versões de mecanismo. Se as versões do mecanismo forem incompatíveis, será possível executar o failover manualmente seguindo as etapas em [Realizar um failover manual para um cluster global do Amazon DocumentDB](#manual-failover).
Se as versões de mecanismo da região não corresponderem, o failover será bloqueado. Verifique se há atualizações pendentes e aplique-as para garantir que todas as versões de mecanismo da região correspondam e que o failover global do cluster seja desbloqueado. Para obter mais informações, consulte [Desbloqueio da transição ou do failover de um cluster global](#unblocking-gc-so-fo).
Para minimizar a perda de dados, recomendamos que você faça o seguinte antes de usar esse recurso:
+ Deixe as aplicações off-line para evitar que as gravações sejam enviadas para o cluster primário do cluster global do Amazon DocumentDB.
+ Verifique os tempos de atraso de todos os clusters secundários do Amazon DocumentDB. Escolher a região secundária com o menor atraso de replicação pode minimizar a perda de dados na atual região primária com falha. Verifique os tempos de atraso de todos os clusters secundários do Amazon DocumentDB no cluster global visualizando a métrica `GlobalClusterReplicationLag` na Amazon. CloudWatch Essa métrica informa a que distância (em milissegundos) está a replicação de um cluster secundário em relação ao cluster primário.
Para obter mais informações sobre CloudWatch métricas do Amazon DocumentDB, consulte. [Métricas do Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Durante um failover gerenciado, o cluster secundário escolhido é promovido à sua nova função como primário. No entanto, ele não herda as várias opções de configuração do cluster primário. Uma incompatibilidade na configuração pode levar a problemas de performance, incompatibilidades de workload e outros comportamentos anômalos. Para evitar esses problemas, recomendamos que você resolva as diferenças entre os clusters globais do Amazon DocumentDB para o seguinte:
+ **Configurar um grupo de parâmetros do cluster do Amazon DocumentDB para o novo primário, se necessário**: você pode configurar seus grupos de parâmetros de cluster do Amazon DocumentDB independentemente para cada cluster no cluster global do Amazon DocumentDB. Por isso, quando você promove um cluster secundário para assumir a função primária, o grupo de parâmetros do secundário pode ser configurado diferentemente do primário. Em caso afirmativo, modifique o grupo de parâmetros do cluster secundário promovido para estar em conformidade com as configurações do cluster principal. Para saber como, consulte [Modificando grupos de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ **Configure ferramentas e opções de monitoramento, como CloudWatch eventos e alarmes da Amazon** — Configure o cluster promovido com a mesma capacidade de registro, alarmes e assim por diante, conforme necessário para o cluster global. Tal como acontece com os parameter groups, a configuração desses recursos não é herdada do primário no processo de failover. Algumas CloudWatch métricas, como atraso na replicação, só estão disponíveis para regiões secundárias. Assim, um failover altera a forma de visualizar essas métricas e definir alarmes para elas, e pode exigir alterações em qualquer painel predefinido. Para obter mais informações sobre clusters e monitoramento do Amazon DocumentDB, consulte [Monitoramento do Amazon DocumentDB](monitoring_docdb.md).
Normalmente, o cluster secundário escolhido assume o perfil principal dentro de um minuto. Assim que o nó de gravação da nova região principal estiver disponível, será possível conectar suas aplicações a ele e retomar suas workloads. Depois que o Amazon DocumentDB promove o novo cluster primário, ele reconstrói automaticamente todos os clusters adicionais da região secundária.
Como os clusters globais do Amazon DocumentDB usam replicação assíncrona, o atraso na replicação em cada região secundária pode variar. O Amazon DocumentDB reconstrói essas regiões secundárias para ter exatamente os mesmos point-in-time dados do novo cluster da região primária. A duração da tarefa de reconstrução completa pode levar de alguns minutos a várias horas, dependendo do tamanho do volume de armazenamento e da distância entre as regiões. Quando os clusters da região secundária terminam de ser reconstruídos com base na nova região primária, eles ficam disponíveis para acesso de leitura. Assim que o novo gravador principal for promovido e disponibilizado, o cluster da nova região primária poderá lidar com operações de leitura e gravação no cluster global do Amazon DocumentDB.
Para restaurar a topologia original do cluster global, o Amazon DocumentDB monitora a disponibilidade da antiga região primária. Assim que essa região estiver íntegra e disponível novamente, o Amazon DocumentDB a adicionará automaticamente ao cluster global como uma região secundária. Antes de criar o novo volume de armazenamento na antiga região primária, o Amazon DocumentDB tenta capturar um snapshot do volume de armazenamento antigo no ponto da falha. Ele faz isso para que você possa usá-lo para recuperar os dados perdidos. Se essa operação for bem-sucedida, o Amazon DocumentDB colocará esse snapshot chamado “rds: docdb-unplanned-global-failover - name-of-old-primary -db-cluster-timestamp” na seção de snapshot do. Console de gerenciamento da AWS Você também pode ver esse snapshot listado nas informações retornadas pela operação de API `DescribeDBClusterSnapshots`.
**nota**
O snapshot do volume de armazenamento antigo é um snapshot do sistema sujeito ao período de retenção de backup configurado no antigo cluster primário. Para preservar esse instantâneo fora do período de retenção, você pode copiá-lo para salvá-lo como um snapshot manual. Para saber mais sobre como copiar snapshots, incluindo os preços, consulte [Cópia de um snapshot de cluster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot).
Depois que a topologia original for restaurada, será possível fazer failback do clustert global para a região primária original executando uma operação de transição quando fizer mais sentido para seus negócios e sua workload. Para isso, siga as etapas em [Como realizar uma transição para um cluster global do Amazon DocumentDB](#global-cluster-switchover).
Você pode fazer o failover do seu cluster global do Amazon DocumentDB usando a Console de gerenciamento da AWS, a ou a AWS CLI API do Amazon DocumentDB.
------
#### [ Using the Console de gerenciamento da AWS ]
**Realize um failover gerenciado no seu cluster global do Amazon DocumentDB**
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
1. Localize e escolha o cluster global do Amazon DocumentDB do qual você deseja fazer failover.
![\[Imagem: tabela de cluster com cluster global selecionado.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. Escolha **Transição ou failover** no menu **Ações**.
1. Na caixa de diálogo exibida, escolha **Failover** e, em seguida, escolha o cluster secundário na lista suspensa do campo **Novo cluster primário**.
![\[Imagem: caixa de diálogo global de alternância ou failover de cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. Digite “confirmar” no último campo. Depois, selecione **Confirmar**.
O status do cluster primário muda para "**Em failover**". Essa condição deve levar aproximadamente um minuto. Durante esse período, o status do novo cluster primário mostra "**Modificando…**". Depois que o novo primário for promovido, ele mostrará "**Disponível**" e poderá veicular transações de leitura e gravação. As regiões secundárias, incluindo a antiga primária, mostrarão "**Ressincronização…**" enquanto é ressincronizada com a nova primária." Semelhante ao novo primário, ele só poderá servir a transação quando o status mudar para "**Disponível**".
1. Quando concluído, o cluster primário original se torna o cluster secundário. O cluster secundário selecionado se torna o cluster primário.
![\[Imagem: tabela de cluster mostrando o novo cluster primário.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Realize um failover gerenciado no seu cluster global do Amazon DocumentDB**
Execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html) da CLI para fazer failover sobre seu cluster global do Amazon DocumentDB. Com o comando, passe valores para as opções a seguir:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
Nos exemplos a seguir, substitua cada um *user input placeholder* pelas informações do seu cluster.
Para Linux, macOS ou Unix:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Para Windows:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Realizar um failover manual para um cluster global do Amazon DocumentDB
Se um cluster inteiro em um Região da AWS ficar indisponível, você poderá promover outro cluster no cluster global para ter read/write capacidade.
É possível ativar manualmente o mecanismo de failover do cluster global se um cluster em uma Região da AWS diferente seja uma opção melhor para ser o cluster primário. Por exemplo, você pode aumentar a capacidade de um dos clusters secundários e promovê-lo para ser o cluster primário. Ou o equilíbrio da atividade entre eles Regiões da AWS pode mudar, de modo que mudar o cluster primário para um diferente Região da AWS pode resultar em menor latência para as operações de gravação.
O procedimento a seguir descreve o que fazer para promover um dos clusters secundários em um cluster global do Amazon DocumentDB.
Como promover um cluster secundário:
1. Pare de emitir instruções DML e outras operações de gravação no cluster primário durante Região da AWS a interrupção.
1. Identifique um cluster de um secundário Região da AWS para usar como um novo cluster primário. Se você tiver dois (ou mais) secundários Regiões da AWS em seu cluster global, escolha o cluster secundário que tenha o menor tempo de espera.
1. Desanexe o cluster secundário escolhido do banco de dados global.
A remoção de um cluster secundário de um cluster global interrompe imediatamente a replicação do primário para esse secundário e o transforma em um cluster provisionado autônomo com recursos completos. read/write Qualquer outro cluster secundário associado ao cluster primário na região com a interrupção ainda estará disponível e poderá aceitar chamadas do seu aplicativo. Eles também consomem recursos. Como você está recriando o cluster global para evitar problemas de cérebro dividido, entre outros, remova os outros clusters secundários antes de criar o cluster global nas etapas a seguir.
Para obter as etapas detalhadas para desanexar, consulte [Remover um cluster de um cluster global do Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove).
1. Esse cluster se torna o cluster principal de um novo cluster global quando você começa a adicionar Regiões a ele, na próxima etapa.
1. Adicione um Região da AWS ao cluster. Quando você faz isso, o processo de replicação de primário para secundário começa.
1. Adicione mais Regiões da AWS conforme necessário para recriar a topologia necessária para dar suporte ao seu aplicativo. Certifique-se de que as gravações de aplicações sejam enviadas para o cluster correto antes, durante e depois de fazer alterações como essas, para evitar inconsistências de dados entre os clusters do cluster global (problemas de cérebro dividido).
1. Quando a interrupção for resolvida e você estiver pronto para reatribuir a Região da AWS original como o cluster primário, siga as mesmas etapas em sentido inverso:
1. Remova um dos clusters secundários do cluster global. Isso permitirá que ele atenda ao read/write tráfego.
1. Redirecione todo o tráfego de leitura para o cluster primário na Região da AWS original.
1. Adicione um Região da AWS para configurar um ou mais clusters secundários da Região da AWS mesma forma que antes.
Os clusters globais do Amazon DocumentDB podem ser gerenciados usando AWS SDKs, permitindo que você crie soluções para automatizar o processo global de failover de clusters para casos de uso de recuperação de desastres e planejamento de continuidade de negócios. Uma dessas soluções é disponibilizada para nossos clientes sob o licenciamento do Apache 2.0 e pode ser acessada em nosso repositório de ferramentas [aqui](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation). Essa solução utiliza o Amazon Route 53 para gerenciamento de endpoints e fornece AWS Lambda funções que podem ser acionadas com base em eventos apropriados.
## Como realizar uma transição para um cluster global do Amazon DocumentDB
Ao usar transições, é possível alterar a região do cluster primário rotineiramente. Essa abordagem destina-se a ambientes controlados, como manutenção operacional e outros procedimentos operacionais planejados.
Há três casos de uso comuns para o uso de transições.
+ Para requisitos de “alternância regional” impostos a setores específicos. Por exemplo, os regulamentos de serviços financeiros podem querer que os sistemas de nível 0 mudem para uma região diferente por vários meses a fim de garantir que os procedimentos de recuperação de desastres sejam executados regularmente.
+ Para aplicativos follow-the-sun "” multirregionais. Por exemplo, uma empresa pode querer fornecer gravações de menor latência em diferentes regiões com base no horário comercial em diferentes fusos horários.
+ Como um zero-data-loss método para retornar à região primária original após um failover.
**nota**
As transições foram projetadas para serem usadas em um cluster global íntegro do Amazon DocumentDB. Para se recuperar de uma interrupção não planejada, siga o procedimento apropriado em [Realizar um failover manual para um cluster global do Amazon DocumentDB](#manual-failover).
Para realizar uma transição, todas as regiões secundárias devem estar executando exatamente a mesma versão de mecanismo primário. Se as versões de mecanismo da região não corresponderem, a transição será bloqueada. Verifique se há atualizações pendentes e aplique-as para garantir que todas as versões de mecanismo da região correspondam e que a transição global do cluster seja desbloqueada. Para obter mais informações, consulte [Desbloqueio da transição ou do failover de um cluster global](#unblocking-gc-so-fo).
Durante uma transição, o Amazon DocumentDB muda o cluster primário para a região secundária escolhida e mantém a topologia de replicação existente do cluster global. Antes de iniciar o processo de transição, o Amazon DocumentDB espera que todos os clusters da região secundária estejam totalmente sincronizados com o cluster da região primária. Em seguida, o cluster de banco de dados na região primária torna-se somente leitura e o cluster secundário escolhido promove um dos respectivos nós somente leitura ao status de gravador completo. A promoção desse nó a um gravador permite que esse cluster secundário assuma a função de cluster primário. Como todos os clusters secundários foram sincronizados com o primário no início do processo, o novo primário continua as operações para o cluster global do Amazon DocumentDB sem perder dados. Seu banco de dados fica indisponível por um curto período enquanto os clusters primários e secundários selecionados estão assumindo suas novas funções.
Para otimizar a disponibilidade da aplicação, recomendamos que você faça o seguinte antes de usar esse recurso:
+ Execute essa operação em períodos de pouca demanda ou em outro momento quando as gravações no cluster primário forem mínimas.
+ Deixe as aplicações off-line para evitar que as gravações sejam enviadas para o cluster primário do cluster global do Amazon DocumentDB.
+ Verifique os tempos de atraso de todos os clusters secundários do Amazon DocumentDB no cluster global visualizando a métrica `GlobalClusterReplicationLag` na Amazon. CloudWatch Essa métrica informa a que distância (em milissegundos) está a replicação de um cluster secundário em relação ao cluster primário. Esse valor é diretamente proporcional ao tempo que o Amazon DocumentDB levará para concluir a transição. Portanto, quanto maior o valor do atraso, mais tempo a transição levará.
Para obter mais informações sobre CloudWatch métricas do Amazon DocumentDB, consulte. [Métricas do Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list)
Durante uma transição, o cluster de banco de dados secundário escolhido é promovido à nova função como primário. No entanto, ele não herda as várias opções de configuração do cluster de banco de dados primário. Uma incompatibilidade na configuração pode levar a problemas de performance, incompatibilidades de workload e outros comportamentos anômalos. Para evitar esses problemas, recomendamos que você resolva as diferenças entre os clusters globais do Amazon DocumentDB para o seguinte:
+ **Configurar um grupo de parâmetros do cluster do Amazon DocumentDB para o novo primário, se necessário**: você pode configurar seus grupos de parâmetros de cluster do Amazon DocumentDB independentemente para cada cluster no cluster global do Amazon DocumentDB. Isso significa que quando você promove um cluster de banco de dados secundário para assumir a função primária, o parameter group do secundário pode ser configurado de forma diferente do que para o primário. Em caso afirmativo, modifique o parameter group do cluster de banco de dados secundário promovido para estar em conformidade com as configurações do cluster principal. Para saber como, consulte [Gerenciando grupos de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups.md).
+ **Configure ferramentas e opções de monitoramento, como Amazon CloudWatch Events e alarmes** — Configure o cluster promovido com a mesma capacidade de registro, alarmes e assim por diante, conforme necessário para o cluster global. Tal como ocorre com os grupos de parâmetros, a configuração desses recursos não é herdada do primário no processo de transição. Algumas CloudWatch métricas, como atraso na replicação, só estão disponíveis para regiões primárias. Assim, uma transição altera a forma de visualizar essas métricas e definir alarmes para elas, e pode exigir alterações em qualquer painel predefinido. Para obter mais informações, consulte [Monitoramento do Amazon DocumentDB](monitoring_docdb.md).
**nota**
Normalmente, a transição de função pode levar alguns minutos.
Quando o processo de transição for concluído, o cluster de do Amazon DocumentDB promovido poderá lidar com operações de gravação para o cluster global.
Você pode alternar seu cluster global do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o: AWS CLI
------
#### [ Using the Console de gerenciamento da AWS ]
**Realize uma transição no seu cluster global do Amazon DocumentDB**
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
1. Localize e selecione o cluster global do Amazon DocumentDB do qual você deseja realizar a transição.
![\[Imagem: tabela de cluster com cluster global selecionado.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. Escolha **Transição ou failover** no menu **Ações**.
1. Na caixa de diálogo exibida, escolha **Transição** e, em seguida, escolha o cluster secundário na lista suspensa do campo **Novo cluster primário**.
![\[Imagem: caixa de diálogo de transição de cluster com o cluster secundário selecionado.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. Escolha **Confirmar**.
O status do cluster primário muda para "**Trocar**". Essa condição deve levar aproximadamente três minutos. Durante esse período, o status de todos os clusters regionais é "**Modificando...**". Depois que as regiões forem sincronizadas e o novo primário for promovido, ele mostrará "**Disponível**" em todos os campos de status e poderá atender às transações.
1. Quando concluído, o cluster primário original se torna o cluster secundário. O cluster secundário selecionado se torna o cluster primário.
![\[Imagem: tabela de cluster mostrando o novo cluster primário.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Realize uma transição no seu cluster global do Amazon DocumentDB**
Execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html) da CLI para fazer a transição do seu cluster global do Amazon DocumentDB. Com o comando, passe valores para as opções a seguir:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
Nos exemplos a seguir, substitua cada um *user input placeholder* pelas informações do seu cluster.
Para Linux, macOS ou Unix:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Para Windows:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## Desbloqueio da transição ou do failover de um cluster global
As transições e os failovers globais do cluster são bloqueados quando nem todos os clusters regionais no cluster global estão na mesma versão de mecanismo. Se as versões não corresponderem, será possível ver esse erro em resposta ao chamar uma transição ou um failover: O cluster de banco de dados de destino especificado está executando uma versão de mecanismo com um nível de patch diferente do cluster de banco de dados de origem. Recomendamos aplicar rotineiramente as versões mais recentes de mecanismo para garantir que você esteja executando as atualizações mais recentes para manter seus clusters globais em bom estado.
Para resolver esse erro, atualize primeiro todas as regiões secundárias e depois a região primária para a mesma versão de mecanismo aplicando todos os itens de ação de manutenção pendentes. Para visualizar os itens de ação de manutenção pendentes e aplicar as alterações necessárias para corrigir o problema, execute as instruções em uma das guias a seguir:
------
#### [ Using the Console de gerenciamento da AWS ]
Para desbloquear uma transição ou um failover global de clusters, você deve determinar se há alguma ação de manutenção pendente para seus clusters e aplicá-la. Siga estas etapas para visualizar e aplicar as ações de manutenção:
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Clusters**.
1. Na tabela **Clusters**, localize seu cluster global na coluna **Identificador do cluster**. Em seu cluster global, anote cada cluster secundário e o cluster primário e execute as etapas a seguir para cada um.
1. Em cada cluster secundário:
1. Se uma atualização estiver disponível para seu cluster, ela será indicada como **Disponível**, **Obrigatória** ou **Próxima janela** na coluna **Manutenção**.
1. Para executar uma ação, escolha o cluster para mostrar seus detalhes e, em seguida, escolha **Manutenção e backups**. Os itens de **manutenção pendentes** são exibidos.
1. Em **Descrição**, se houver indicação de que “Uma nova atualização de manutenção está disponível”, selecione-a e escolha **Aplicar agora**.
1. Em seu cluster primário:
1. Se uma atualização estiver disponível para seu cluster, ela será indicada como **Disponível**, **Obrigatória** ou **Próxima janela** na coluna **Manutenção**.
1. Para executar uma ação, escolha o cluster para mostrar seus detalhes e, em seguida, escolha **Manutenção e backups**. Os itens de **manutenção pendentes** são exibidos.
1. Em **Descrição**, se houver indicação de que “Uma nova atualização de manutenção está disponível”, selecione-a e escolha **Aplicar agora**.
------
#### [ Using the AWS CLI ]
Para desbloquear uma transição ou um failover de cluster global, você deve determinar se há alguma ação de manutenção pendente para o cluster e aplicá-la. Siga estas etapas para visualizar e aplicar ações de manutenção primeiro nos clusters secundários e depois no cluster primário do seu cluster global:
1. Execute o seguinte, primeiro no cluster regional de cada região secundária e depois no cluster regional da região primária.
1. Execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) da CLI com a opção `--resource-identifier` para determinar se alguma ação de manutenção está disponível para seu cluster regional do Amazon DocumentDB.
Nos exemplos a seguir, substitua cada um *user input placeholder* pelas informações do seu cluster.
Para Linux, macOS ou Unix:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Para Windows:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
O resultado deve ser semelhante a este:
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. Se for necessária uma ação de manutenção, execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html) da CLI com as opções a seguir:
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
Nos exemplos a seguir, substitua cada um *user input placeholder* pelas informações do seu cluster.
Para Linux, macOS ou Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Para Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. Depois que a ação de manutenção for concluída, execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) novamente para garantir que não haja outras ações pendentes para seu cluster.
O resultado que você deseja é:
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
Para desbloquear uma transição ou um failover de cluster global, você deve determinar se há alguma ação de manutenção pendente para o cluster e aplicá-la. Use o seguinte APIs para visualizar e aplicar ações de manutenção:
1. Execute o seguinte, primeiro no cluster regional de cada região secundária e depois no cluster regional da região primária.
1. Chame a API [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html) para determinar se alguma ação de manutenção está disponível para seu cluster global do Amazon DocumentDB.
1. Aplique todas as alterações chamando a API [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html).
------