Restauración a un punto en el tiempo - Amazon DocumentDB

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Restauración a un punto en el tiempo

Para restaurar un clúster en cualquier momento que se encuentre dentro del período de retención de copias de seguridad del clúster, utilice AWS Management Console o AWS Command Line Interface (AWS CLI).

nota

No puedes realizar una point-in-time restauración de un clúster 3.6 a uno 4.0, pero puedes migrar de una versión de clúster a otra. Para obtener más información, consulte Migración a Amazon DocumentDB.

Tenga en cuenta las siguientes consideraciones al restaurar un clúster de base de datos a un momento dado.

  • El nuevo clúster se crea con la misma configuración que el clúster de origen, con la salvedad de que el nuevo clúster se crea con el grupo de parámetros predeterminado. Para establecer el nuevo grupo de parámetros de clúster en el grupo de parámetros de clúster de origen, modifique el clúster en cuanto esté disponible. Para obtener más información acerca de la modificación de un clúster, consulte Modificación de un clúster de Amazon DocumentDB.

Using the AWS Management Console

Para restaurar un clúster point-in-time dentro de su período de retención de copias de seguridad, complete lo siguiente mediante el AWS Management Console.

  1. Inicie sesión en y abra la AWS Management Console consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.

  2. En el panel de navegación, seleccione Clusters (Clústeres). En la lista de clústeres, elija el botón situado a la izquierda del clúster que desee restaurar.

    sugerencia

    Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (Hamburger menu icon with three horizontal lines.) en la esquina superior izquierda de la página.

  3. En el menú Actions (Acciones), seleccione Restore to point in time (Restaurar a un momento dado).

  4. Rellene la sección Restore time (Hora de restauración), en la que se especifican la fecha y la hora a la que restaurar.

    1. Fecha de restauración: elija o introduzca una fecha que esté entre la hora de restauración más temprana y la hora de restauración más reciente.

    2. Hora de restauración: elija o introduzca la hora, el minuto y los segundos que están entre la hora de restauración más temprana y la hora de restauración más reciente.

  5. Rellene la sección Configuration (Configuración).

    1. Identificador de clúster: acepte el identificador predeterminado o introduzca otro identificador de su elección.

      Restricciones en cuanto a la nomenclatura de los clústeres:

      • Debe tener [1-63] letras, números o guiones.

      • El primer carácter debe ser una letra.

      • No puede terminar por un guion ni contener dos guiones consecutivos.

      • Debe ser único para todos los clústeres de AmazonRDS, Neptune y Amazon DocumentDB Cuenta de AWS por región.

    2. Clase de instancia: en la lista desplegable, elija la clase de instancia que desea utilizar para las instancias del clúster.

    3. Número de instancias: en la lista desplegable, elija el número de instancias que desee crear cuando se restaure el clúster.

  6. Para configurar el almacenamiento en clúster, elija una opción de almacenamiento.

    nota

    La configuración de almacenamiento optimizada para E/S de Amazon DocumentDB solo está disponible en la versión 5.0 del motor Amazon DocumentDB.

  7. Opcional. Para configurar los ajustes de red y las opciones de clúster y para habilitar las exportaciones de registros, elija Show advanced settings (Mostrar configuración avanzada) y complete dichas secciones. De lo contrario, continúe en el siguiente paso.

    • Network settings (Configuración de red)

      1. Nube privada virtual (VPC): en la lista desplegable, elija la VPC que desee usar para este clúster.

      2. Grupo de subredes: en la lista desplegable, elija el grupo de subredes para este clúster.

      3. VPCgrupos de seguridad: en la lista desplegable, elija los grupos VPC de seguridad para este clúster.

       

    • Cluster options (Opciones de clúster)

      1. Puerto: acepte el puerto predeterminado (27017) o utilice las flechas hacia arriba y abajo para establecer el puerto de comunicación con este clúster.

       

    • Log exports (Exportaciones de registros)

      1. Registros de auditoría: seleccione esta opción para habilitar la exportación de registros de auditoría a Amazon CloudWatch Logs. Si selecciona esta opción, debe habilitar audit_logs en el grupo personalizado de parámetros de clúster. Para obtener más información, consulte Auditoría de eventos de Amazon DocumentDB.

      2. Registros del generador de perfiles: seleccione esta opción para habilitar la exportación de los registros del generador de perfiles de operaciones a Amazon CloudWatch Logs. Si selecciona esta opción, también debe modificar los siguientes parámetros del grupo personalizado de parámetros del clúster:

        • profiler: se establece en enabled.

        • profiler_threshold_ms: se establece en un valor [0-INT_MAX] para definir el umbral para las operaciones de creación de perfiles.

        • profiler_sampling_rate: se establece en un valor [0.0-1.0] para definir el porcentaje de operaciones lentas en el perfil.

        Para obtener más información, consulte Elaboración de perfiles de las operaciones de Amazon DocumentDB.

      3. Registros del generador de perfiles: exporta los registros del generador de perfiles a Amazon CloudWatch

      4. IAMrol: en la lista desplegable, selecciona el rol vinculado RDS al servicio.

    • Etiquetas

      1. Agregar etiqueta: en el cuadro Clave, escriba el nombre de la etiqueta del clúster. En el cuadro Value (Valor), si lo desea, escriba el valor de la etiqueta. Las etiquetas se utilizan con las políticas AWS Identity and Access Management (IAM) para administrar el acceso a los recursos de Amazon DocumentDB y para controlar qué acciones se pueden aplicar a los recursos.

    • Protección contra eliminación

      1. Habilitar la protección contra la eliminación: protege el clúster para que no se pueda eliminar accidentalmente. Cuando esta opción está habilitada, no se puede eliminar el clúster.

  8. Para restaurar el clúster, elija Create cluster (Crear clúster). También puede elegir Cancel (Cancelar) para cancelar la operación.

Using the AWS CLI

Para restaurar un clúster a un momento dado mediante el periodo de retención de copia de seguridad de la instantánea, utilice la operación restore-db-cluster-to-point-in-time con los siguientes parámetros.

  • --db-cluster-identifier: obligatorio. El nombre del nuevo clúster que se va a crear. Este clúster no puede existir antes de la operación. El valor del parámetro debe cumplir las siguientes restricciones.

    Restricciones en cuanto a la nomenclatura de los clústeres:

    • Debe tener [1-63] letras, números o guiones.

    • El primer carácter debe ser una letra.

    • No puede terminar por un guion ni contener dos guiones consecutivos.

    • Debe ser único para todos los clústeres de AmazonRDS, Neptune y Amazon DocumentDB Cuenta de AWS por región.

  • --restore-to-time— La UTC fecha y la hora a las que se va a restaurar el clúster. Por ejemplo, 2018-06-07T23:45:00Z.

    Restricciones de tiempo:

    • Debe ser anterior a la última hora restaurable del clúster.

    • Debe especificarse si no se proporciona el parámetro --use-latest-restorable-time.

    • No se puede especificar si el parámetro --use-latest-restorable-time es true.

    • No se puede especificar si el valor del parámetro --restore-type es copy-on-write.

  • --source-db-cluster-identifier: el nombre del clúster de origen desde el que se va a restaurar. Este clúster debe existir y estar disponible.

  • --use-latest-restorable-time o --no-use-latest-restorable-time: si se va a restaurar a la hora más reciente de la copia de seguridad restaurable. No se puede especificar si se proporciona el parámetro --restore-to-time.

  • --storage-type standard | iopt1— Opcional. Predeterminado: standard.

La AWS CLI operación restore-db-cluster-to-point-in-time solo restaura el clúster, no las instancias de ese clúster. Debe invocar la operación create-db-instance para crear instancias para el clúster restaurado, especificando el identificador de dicho clúster restaurado en --db-cluster-identifier. Solo puede crear instancias después de que se haya completado la operación restore-db-cluster-to-point-in-time y de que el clúster restaurado esté disponible.

En el siguiente ejemplo, sample-cluster-restored se crea a partir de la instantánea sample-cluster-snapshot tomando el último momento que se puede restaurar.

Para Linux, macOS o 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

En el siguiente ejemplo, se crea sample-cluster-restored desde la instantánea sample-cluster-snapshot hasta las 03:15 del 11 de diciembre de 2018 (UTC), es decir, dentro del período de retención de la copia de seguridad desample-cluster.

Para Linux, macOS o 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

La salida de esta operación será similar a lo que se indica a continuación. 

{
    "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
    }
}