Restauração para um ponto no tempo - Amazon DocumentDB

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á.

Restauração para um ponto no tempo

É possível restaurar um cluster para qualquer momento determinado que esteja dentro do período de retenção de backup de cluster usando o AWS Management Console ou a AWS Command Line Interface (AWS CLI).

nota

Não é possível restaurar um ponto no tempo de um cluster 3.6 para um 4.0, mas 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 Modificar um cluster do Amazon DocumentDB.

Using the AWS Management Console

É possível restaurar um cluster para um point-in-time que esteja dentro do período de retenção de backup concluindo o seguinte usando o AWS Management Console.

  1. Faça login no AWS Management Console e abra 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 (Hamburger menu icon with three horizontal lines.) 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 no Amazon RDS, Amazon Neptune e Amazon DocumentDB por Conta da AWS, por região.

    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 do cluster, escolha uma opção de armazenamento.

    nota

    A configuração de armazenamento Amazon DocumentDB Otimizado para E/S só está disponível na versão do mecanismo do 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. Nuvem privada virtual (VPC) na lista suspensa, escolha a VPC na qual você deseja usar esse cluster.

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

      3. Grupos de segurança da VPC: na lista suspensa, escolha os grupos de segurança da VPC 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. Logs de auditoria: selecione esta opção para habilitar a exportação de logs 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 ter mais informações, consulte Auditar eventos do Amazon DocumentDB.

      2. Logs do profiler: selecione esta opção para habilitar a operação de exportação de logs do profiler para o Amazon CloudWatch Logs. 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 ter mais informações, consulte Definir o perfil das operações do Amazon DocumentDB.

      3. Logs do profiler: exporte os logs do profiler para o Amazon CloudWatch

      4. Perfil do IAM: na lista suspensa, escolha Perfil vinculado ao serviço RDS.

    • 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 políticas do (IAM) AWS Identity and Access Management para gerenciar 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 no Amazon RDS, Amazon Neptune e Amazon DocumentDB por Conta da AWS, por região.

  • --restore-to-time: a data e a hora, em formato UTC, em que o cluster será restaurado. 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 operação restore-db-cluster-to-point-in-time da AWS CLI só restaura 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 cria o sample-cluster-restored do snapshot sample-cluster-snapshot para 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 a 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
    }
}