View a markdown version of this page

Ripristino a un determinato punto nel tempo - Amazon DocumentDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ripristino a un determinato punto nel tempo

Puoi ripristinare un cluster in qualsiasi momento compreso nel periodo di conservazione del backup del cluster utilizzando Console di gestione AWS or AWS Command Line Interface (AWS CLI).

Nota

Non è possibile eseguire un ripristino point-in-time da un cluster 3.6 a un cluster 4.0, ma è possibile migrare da una versione del cluster a un'altra. Per ulteriori informazioni, consulta Migrazione e aggiornamento di Amazon DocumentDB.

Tieni presente quanto segue quando ripristini un cluster a un punto temporale specifico.

  • Il nuovo cluster viene creato con la stessa configurazione del cluster di origine, ma utilizza il gruppo di parametri predefinito. Per impostare il gruppo di parametri del nuovo cluster su quello del cluster di origine, occorre modificare il cluster appena risulta disponibile. Per ulteriori informazioni sulla modifica di un cluster, consulta Modifica di un cluster Amazon DocumentDB.

Using the Console di gestione AWS

È possibile ripristinare un cluster in un point-in-time entro il periodo di retention dei backup completando quanto segue utilizzando la Console di gestione AWS.

  1. Accedi a e apri la console Amazon Console di gestione AWS DocumentDB all'indirizzo. https://console.aws.amazon.com/docdb

  2. Nel pannello di navigazione scegliere Cluster. Dall'elenco di cluster scegliere il pulsante a sinistra del cluster che si desidera ripristinare.

    Suggerimento

    Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (Menu button.) nell'angolo in alto a sinistra della pagina.

  3. Nel menu Actions (Operazioni) scegliere Restore to point in time (Esegui ripristino point in time).

  4. Completare la sezione Restore time (Ora ripristino), in cui si specificano data e ora per il ripristino.

    1. Data di ripristino: scegli o inserisci una data compresa tra il primo tempo di ripristino e l'ultimo orario di ripristino.

    2. Tempo di ripristino: scegli o inserisci l'ora, i minuti e i secondi compresi tra il primo ripristino e l'ultimo tempo di ripristino.

  5. Completare la sezione Configurazione.

    1. Identificatore del cluster: accetta l'identificatore predefinito o inserisci un identificatore che preferisci.

      Vincoli per la denominazione del cluster:

      • La lunghezza è di [1—63] lettere, numeri o trattini.

      • Il primo carattere deve essere una lettera.

      • Non può terminare con un trattino o contenere due trattini consecutivi.

      • Deve essere univoco per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS

    2. Classe di istanza: dall'elenco a discesa, scegli la classe di istanza desiderata per le istanze del cluster.

    3. Numero di istanze: dall'elenco a discesa, scegli il numero di istanze da creare quando il cluster viene ripristinato.

  6. Per la configurazione dello storage del cluster, scegli un'opzione di archiviazione.

    Nota

    La configurazione I/O-Optimized dello storage di Amazon DocumentDB è disponibile solo nelle versioni del motore Amazon DocumentDB 5.0 e 8.0.

  7. Opzionale. Per configurare le impostazioni di rete, le opzioni del cluster e abilitare le esportazioni dei log, scegliere Show advanced settings (Mostra impostazioni avanzate) e completare le sezioni seguenti. In alternativa, passare alla fase successiva.

    • Impostazioni di rete

      1. Virtual Private Cloud (VPC): dall'elenco a discesa, scegli il VPC che desideri utilizzare per questo cluster.

      2. Gruppo di sottorete: dall'elenco a discesa, scegli il gruppo di sottorete per questo cluster.

      3. Gruppi di sicurezza VPC: dall'elenco a discesa, scegli i gruppi di sicurezza VPC per questo cluster.

       

    • Cluster options (Opzioni cluster)

      1. Porta: accetta la porta predefinita (27017) o utilizza le frecce su e giù per impostare la porta per comunicare con questo cluster.

       

    • Log exports (Esportazioni log)

      1. Log di controllo: seleziona questa opzione per abilitare l'esportazione dei log di controllo in Amazon Logs. CloudWatch Se selezioni questa opzione, devi abilitare audit_logs nel gruppo personalizzato dei parametri del cluster. Per ulteriori informazioni, consulta Verifica degli eventi di Amazon DocumentDB.

      2. Log di profiler: seleziona questa opzione per abilitare l'esportazione dei log delle operazioni di profilazione in Amazon Logs. CloudWatch Se selezioni questa opzione, devi anche modificare i seguenti parametri nel gruppo personalizzato dei parametri del cluster:

        • profiler— Impostato su. enabled

        • profiler_threshold_ms— Impostato su un valore [0-INT_MAX] per impostare la soglia per le operazioni di profilazione.

        • profiler_sampling_rate— Impostare un valore [0.0-1.0] per impostare la percentuale di operazioni lente da profilare.

        Per ulteriori informazioni, consulta Profilazione delle operazioni di Amazon DocumentDB.

      3. Log del profiler: esporta i log del profiler in Amazon CloudWatch

      4. Ruolo IAM: dall'elenco a discesa, scegli RDS Service Linked Role.

    • Tag

      1. Aggiungi tag: nella casella Chiave, inserisci il nome del tag per il tuo cluster. Nella casella Value (Valore) immetti facoltativamente il valore del tag. I tag vengono utilizzati con le policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Amazon DocumentDB e per controllare quali azioni possono essere applicate alle risorse.

    • Deletion protection (Protezione da eliminazione)

      1. Abilita la protezione dalle eliminazioni: protegge il cluster dall'eliminazione accidentale. Quando questa opzione è abilitata, non puoi eliminare il cluster.

  8. Per ripristinare il cluster, scegliere Create cluster (Crea cluster). In alternativa, è possibile scegliere Cancel (Annulla) per annullare l'operazione.

Using the AWS CLI

Per ripristinare un cluster a un punto temporale specifico con il periodo di retention dei backup della snapshot, utilizza l'operazione restore-db-cluster-to-point-in-time con i parametri seguenti.

  • --db-cluster-identifier— Obbligatorio. Il nome del nuovo cluster da creare. Questo cluster non può esistere prima di questa operazione. Il valore del parametro deve soddisfare i seguenti vincoli.

    Vincoli per la denominazione del cluster:

    • La lunghezza è di [1—63] lettere, numeri o trattini.

    • Il primo carattere deve essere una lettera.

    • Non può terminare con un trattino o contenere due trattini consecutivi.

    • Deve essere univoco per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS

  • --restore-to-time— La data e l'ora UTC in cui ripristinare il cluster. Ad esempio, 2018-06-07T23:45:00Z.

    Vincoli temporali:

    • Deve essere prima dell'ultimo orario di ripristino per il cluster.

    • Deve essere specificato se il parametro --use-latest-restorable-time non viene fornito.

    • Non può essere specificato se il parametro --use-latest-restorable-time è true.

    • Non può essere specificato se il valore del parametro --restore-type è copy-on-write.

  • --source-db-cluster-identifier— Il nome del cluster di origine da cui eseguire il ripristino. Questo cluster deve esistere ed essere disponibile.

  • --use-latest-restorable-timeoppure--no-use-latest-restorable-time: se eseguire il ripristino all'orario di backup ripristinabile più recente. Non può essere specificato se il parametro --restore-to-time viene fornito.

  • --storage-type standard | iopt1— Opzionale. Default: standard.

L' AWS CLI operazione ripristina restore-db-cluster-to-point-in-time solo il cluster, non le istanze di quel cluster. È necessario utilizzare l'operazione create-db-instance per creare le istanze per il cluster ripristinato, specificandone l'identificatore in --db-cluster-identifier. Puoi creare le istanze solo dopo che l'operazione restore-db-cluster-to-point-in-time è terminata e il cluster ripristinato è disponibile.

Esempio

L'esempio seguente crea sample-cluster-restored dallo snapshot sample-cluster-snapshot all'ultimo orario di ripristino.

Per 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

Per 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
Esempio

Nell'esempio seguente viene creato sample-cluster-restored dallo snapshot sample-cluster-snapshot delle 3:15 dell'11 dicembre 2018 (UTC), ovvero un orario incluso nel periodo di retention dei backup di sample-cluster.

Per 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

Per 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

L'aspetto dell'output di questa operazione è simile al seguente. 

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