Restaurando em um ponto no tempo

Você pode restaurar um cluster em qualquer momento que esteja dentro do período de retenção de backup do cluster usando o AWS Management Console ou AWS Command Line Interface (AWS CLI).

nota

Você não pode realizar uma point-in-time restauração de um cluster 3.6 para um 4.0, mas você pode migrar de uma versão de cluster para outra. Para obter mais informações, acesse Migrar para o Amazon DocumentDB.

Lembre-se do seguinte ao restaurar um cluster para um momento determinado.

• O novo cluster é criado com a mesma configuração do cluster de origem, exceto pelo fato de que o novo cluster é criado com o grupo de parâmetros padrão. Para definir o grupo de parâmetros do novo cluster como o grupo de parâmetros do cluster de origem, modifique o cluster depois que ele estiver disponível. Para obter mais informações sobre como modificar um cluster, consulte Modificação de um cluster do Amazon DocumentDB.

Using the AWS Management Console

Você pode restaurar um cluster point-in-time dentro do período de retenção de backup preenchendo o seguinte usando AWS Management Console o.

1. Faça login no e abra AWS Management Console o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.

2. No painel de navegação, escolha Clusters. Na lista de clusters, escolha o botão à esquerda do cluster que você deseja restaurar.

   dica

   Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu () no canto superior esquerdo da página.

3. No menu Ações, escolha Restaurar para um determinado momento.

4. Preencha a seção Hora de restauração, que especifica a data e a hora da restauração.

   1. Data de restauração: escolha ou insira uma data entre a Hora de restauração mais antiga e a Hora de restauração mais recente.

   2. Hora de restauração: escolha ou insira uma hora, minuto e segundos entre a Hora de restauração mais antiga e a Hora de restauração mais recente.

5. Preencha a seção Configuração.

   1. Identificador de cluster: aceite o identificador padrão ou insira um identificador que você preferir.

      Restrições de nomeação de cluster:

      • O comprimento é de [1 a 63] letras, números ou hífens.

      • O primeiro caractere deve ser uma letra.

      • Não podem terminar com um hífen ou conter dois hífens consecutivos.

      • Deve ser exclusivo para todos os clusters da AmazonRDS, Neptune e Amazon DocumentDB por região. Conta da AWS

   2. Classe da instância: na lista suspensa, escolha a classe de instância que você deseja usar para as instâncias do cluster.

   3. Número de instâncias: na lista suspensa, escolha o número de instâncias que você deseja criar quando o cluster é restaurado.

6. Para configuração de armazenamento em cluster, escolha uma opção de armazenamento.

   nota

   A configuração de armazenamento otimizada para E/S do Amazon DocumentDB só está disponível na versão do mecanismo Amazon DocumentDB 5.0.

7. Opcional. Para definir as configurações de rede e as opções do cluster e ativar exportações de log, escolha Show advanced settings (Mostrar configurações avançadas) e preencha as seções a seguir. Caso contrário, siga para a próxima etapa.

   • Configurações de rede

     1. Virtual Private Cloud (VPC) — Na lista suspensa, escolha o VPC que você deseja usar para esse cluster.

     2. Grupo de sub-redes: na lista suspensa, escolha o grupo de sub-redes para esse cluster.

     3. VPCgrupos de segurança — Na lista suspensa, escolha os grupos de VPC segurança para esse cluster.

      

   • Opções do cluster

     1. Porta: aceite a porta padrão (27017) ou use as setas para cima e para baixo para definir a porta de comunicação com esse cluster.

      

   • Exportações de log

     1. Registros de auditoria — Selecione essa opção para permitir a exportação de registros de auditoria para o Amazon CloudWatch Logs. Se você selecionar essa opção, será necessário habilitar audit_logs no grupo de parâmetros personalizado do cluster. Para obter mais informações, consulte Auditoria de eventos do Amazon DocumentDB.

     2. Registros do profiler — Selecione essa opção para permitir a exportação dos logs do profiler da operação para o Amazon Logs. CloudWatch Se você selecionar essa opção, também será necessário modificar os seguintes parâmetros no grupo de parâmetros personalizado do cluster:

        • profiler: defina como enabled.

        • profiler_threshold_ms defina como um valor [0-INT_MAX] para configurar o limite para operações de criação de perfil.

        • profiler_sampling_rate defina como um valor [0.0-1.0] para configurar a porcentagem de operações lentas para perfilar.

        Para obter mais informações, consulte Definindo o perfil das operações do Amazon DocumentDB.

     3. Registros do Profiler — Exporte os registros do Profiler para a Amazon CloudWatch

     4. IAMfunção — Na lista suspensa, escolha Função vinculada ao RDS serviço.

   • Tags

     1. Adicionar tag: na caixa Chave, insira o nome da tag do cluster. Na caixa Valor, opcionalmente insira o valor da tag. As tags são usadas com AWS Identity and Access Management (IAM) políticas para gerenciar o acesso aos recursos do Amazon DocumentDB e controlar quais ações podem ser aplicadas aos recursos.

   • Deletion protection (Proteção contra exclusão)

     1. Habilitar proteção contra exclusão: protege o cluster contra exclusão acidental. Quando essa opção estiver habilitada, não será possível excluir o cluster.

8. Para restaurar o cluster, escolha Criar cluster. Como alternativa, escolha Cancelar para cancelar a operação.

Using the AWS CLI

Para restaurar um cluster para um momento determinado usando o período de retenção de backup do snapshot, use a operação restore-db-cluster-to-point-in-time com os parâmetros a seguir.

• --db-cluster-identifier: obrigatório. O nome do novo cluster a ser criado. Esse cluster não pode existir antes da operação. O valor do parâmetro deve atender às seguintes restrições.

  Restrições de nomeação de cluster:

  • O comprimento é de [1 a 63] letras, números ou hífens.

  • O primeiro caractere deve ser uma letra.

  • Não podem terminar com um hífen ou conter dois hífens consecutivos.

  • Deve ser exclusivo para todos os clusters da AmazonRDS, Neptune e Amazon DocumentDB por região. Conta da AWS

• --restore-to-time— A UTC data e a hora para restaurar o cluster. Por exemplo, 2018-06-07T23:45:00Z.

  Restrições de tempo:

  • Devem ser anteriores ao último momento restaurável do cluster.

  • Devem ser especificadas se o parâmetro --use-latest-restorable-time não for especificado.

  • Não podem ser especificadas se o parâmetro --use-latest-restorable-time for true.

  • Não podem ser especificadas se o valor do parâmetro --restore-type for copy-on-write.

• --source-db-cluster-identifier: o nome do cluster de origem a partir do qual restaurar. Esse cluster deve existir e estar disponível.

• --use-latest-restorable-time ou --no-use-latest-restorable-time: se deseja restaurar para a última hora de backup restaurável. Não pode ser especificado se o parâmetro --restore-to-time não for especificado.

• --storage-type standard | iopt1— Opcional. Padrão: standard.

A AWS CLI operação restaura restore-db-cluster-to-point-in-time apenas o cluster, não as instâncias desse cluster. É necessário invocar a operação create-db-instance para criar instâncias para o cluster restaurado, especificando o identificador do cluster restaurado em --db-cluster-identifier. Você só pode criar instâncias após a conclusão da operação restore-db-cluster-to-point-in-time e com o cluster restaurado em estado disponível.

O exemplo a seguir cria o sample-cluster-restored do snapshot sample-cluster-snapshot para o último momento restaurável.

Para Linux, macOS ou Unix:

aws docdb restore-db-cluster-to-point-in-time \
    --db-cluster-identifier sample-cluster-restored \
    --source-db-cluster-identifier sample-cluster-snapshot \
    --use-latest-restorable-time

Para Windows:

aws docdb restore-db-cluster-to-point-in-time ^
    --db-cluster-identifier sample-cluster-restored ^
    --source-db-cluster-identifier sample-cluster-snapshot ^
    --use-latest-restorable-time

O exemplo a seguir é criado a sample-cluster-restored partir do snapshot sample-cluster-snapshot até às 03:15 de 11 de dezembro de 2018 (UTC), que está dentro do período de retenção de backup de. sample-cluster

Para Linux, macOS ou Unix:

aws docdb restore-db-cluster-to-point-in-time \
    --db-cluster-identifier sample-cluster-restore \
    --source-db-cluster-identifier sample-cluster \
    --restore-to-time 2020-05-12T03:15:00Z

Para Windows:

aws docdb restore-db-cluster-to-point-in-time ^
    --db-cluster-identifier sample-cluster-restore ^
    --source-db-cluster-identifier sample-cluster ^
    --restore-to-time 2020-05-12T03:15:00Z

A saída dessa operação é semelhante à seguinte.

{
    "DBCluster": {
        "AvailabilityZones": [
            "us-east-1c",
            "us-west-2b",
            "us-west-2a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "sample-cluster-restored",
        "DBClusterParameterGroup": "sample-parameter-group",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
        "ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
        "MultiAZ": false,
        "Engine": "docdb",
        "EngineVersion": "4.0.0",
        "Port": 27017,
        "MasterUsername": "master-user",
        "PreferredBackupWindow": "02:00-02:30",
        "PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abc0123",
                "Status": "active"
            }
        ],
        "HostedZoneId": "ABCDEFGHIJKLM",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID^>:key/sample-key",
        "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "DBClusterArn": "arn:aws:rds:us-east-1:<accountID>:cluster:sample-cluster-restored",
        "AssociatedRoles": [],
        "ClusterCreateTime": "2020-04-24T20:14:36.713Z",
        "DeletionProtection": false
    }
}