Eseguire un ripristino temporizzato nei dati BLOB in blocchi

Articolo
06/01/2023

È possibile usare il ripristino temporizzato per ripristinare uno o più set di BLOB a blocchi in uno stato precedente. Questo articolo descrive come abilitare il ripristino temporizzato per un account di archiviazione e come eseguire un'operazione di ripristino.

Per altre informazioni sul ripristino temporizzato, vedere Ripristino temporizzato per i BLOB in blocchi.

Nota

Il ripristino temporizzato è supportato solo per gli account di archiviazione per utilizzo generico v2 nel livello di prestazioni standard. È possibile ripristinare solo i dati nei livelli di accesso ad accesso frequente e sporadico con ripristino temporizzato.

Attenzione

Il ripristino temporizzato supporta solo il ripristino di operazioni su BLOB in blocchi. Non è possibile ripristinare le operazioni su contenitori. Se si elimina un contenitore dall'account di archiviazione chiamando l'operazione Elimina contenitore , tale contenitore non può essere ripristinato con un'operazione di ripristino. Anziché eliminare un intero contenitore, eliminare singoli BLOB se è possibile ripristinarli in un secondo momento. Microsoft consiglia inoltre di abilitare l'eliminazione temporanea per contenitori e BLOB da proteggere dall'eliminazione accidentale. Per altre informazioni, vedere Eliminazione temporanea per i contenitori e Eliminazione temporanea per i BLOB.

Abilitare e configurare il ripristino temporizzato

Prima di abilitare e configurare il ripristino temporizzato, abilitare i prerequisiti per l'account di archiviazione: eliminazione temporanea, feed di modifiche e controllo delle versioni BLOB. Per altre informazioni su come abilitare queste funzionalità, vedere gli articoli seguenti:

Importante

L'abilitazione dell'eliminazione temporanea, del feed di modifiche e del controllo delle versioni BLOB può comportare addebiti aggiuntivi. Per altre informazioni, vedere Eliminazione temporanea per i BLOB, supporto del feed di modifiche in Archiviazione BLOB di Azure e controllo delle versioni BLOB.

Per configurare il ripristino temporizzato con la portale di Azure, seguire questa procedura:

Passare all'account di archiviazione nel portale di Azure.
In Impostazioni scegliere Protezione dati.
Selezionare Attiva ripristino temporizzato . Quando si seleziona questa opzione, vengono abilitati anche l'eliminazione temporanea per BLOB, controllo delle versioni e feed di modifiche.
Impostare il punto di ripristino massimo per il ripristino temporizzato, in giorni. Questo numero deve essere almeno un giorno minore del periodo di conservazione specificato per l'eliminazione temporanea del BLOB.
Salvare le modifiche.

L'immagine seguente mostra un account di archiviazione configurato per il ripristino temporizzato con un punto di ripristino di sette giorni fa e un periodo di conservazione per l'eliminazione temporanea del BLOB di 14 giorni.

Screenshot che mostra come configurare il ripristino temporizzato nella portale di Azure

Per configurare il ripristino temporizzato con PowerShell, installare prima il modulo Az.Storage versione 2.6.0 o successiva. Chiamare quindi il comando Enable-AzStorageBlobRestorePolicy per abilitare il ripristino temporizzato per l'account di archiviazione.

L'esempio seguente abilita l'eliminazione temporanea e imposta il periodo di conservazione di eliminazione temporanea, abilita il feed di modifiche e il controllo delle versioni e quindi abilita il ripristino temporizzato. Quando si esegue l'esempio, assicurarsi di sostituire i valori tra parentesi uncinate con i propri valori:

# Set resource group and account variables.
$rgName = "<resource-group>"
$accountName = "<storage-account>"

# Enable blob soft delete with a retention of 14 days.
Enable-AzStorageBlobDeleteRetentionPolicy -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -RetentionDays 14

# Enable change feed and versioning.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -EnableChangeFeed $true `
    -IsVersioningEnabled $true

# Enable point-in-time restore with a retention period of 7 days.
# The retention period for point-in-time restore must be at least
# one day less than that set for soft delete.
Enable-AzStorageBlobRestorePolicy -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -RestoreDays 7

# View the service settings.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $accountName

Per configurare il ripristino temporizzato con l'interfaccia della riga di comando di Azure, installare prima l'interfaccia della riga di comando di Azure versione 2.2.0 o successiva. Chiamare quindi il comando az storage account BLOB-service-properties update per abilitare il ripristino temporizzato e le altre impostazioni di protezione dei dati necessarie per l'account di archiviazione.

L'esempio seguente abilita l'eliminazione temporanea e imposta il periodo di conservazione di eliminazione temporanea su 14 giorni, abilita il feed di modifiche e il controllo delle versioni e abilita il ripristino temporizzato con un periodo di ripristino di 7 giorni. Quando si esegue l'esempio, assicurarsi di sostituire i valori tra parentesi uncinate con i propri valori:

az storage account blob-service-properties update \
    --resource-group <resource_group> \
    --account-name <storage-account> \
    --enable-delete-retention true \
    --delete-retention-days 14 \
    --enable-versioning true \
    --enable-change-feed true \
    --enable-restore-policy true \
    --restore-days 7

Scegliere un punto di ripristino

Il punto di ripristino è la data e l'ora in cui vengono ripristinati i dati. Archiviazione di Azure usa sempre un valore di data/ora UTC come punto di ripristino. Tuttavia, la portale di Azure consente di specificare il punto di ripristino nell'ora locale e quindi converte tale valore di data/ora in un valore di data/ora UTC per eseguire l'operazione di ripristino.

Quando si esegue un'operazione di ripristino con PowerShell o l'interfaccia della riga di comando di Azure, è necessario specificare il punto di ripristino come valore di data/ora UTC. Se il punto di ripristino viene specificato con un valore ora locale anziché un valore di ora UTC, l'operazione di ripristino potrebbe comunque comportarsi come previsto in alcuni casi. Ad esempio, se l'ora locale è UTC meno cinque ore, specificando un valore di ora locale viene restituito un punto di ripristino che corrisponde a cinque ore prima del valore specificato. Se non sono state apportate modifiche ai dati nell'intervallo da ripristinare durante quel periodo di cinque ore, l'operazione di ripristino produrrà gli stessi risultati indipendentemente dal valore di tempo specificato. È consigliabile specificare un'ora UTC per il punto di ripristino per evitare risultati imprevisti.

Eseguire un'operazione di ripristino

È possibile ripristinare tutti i contenitori nell'account di archiviazione oppure è possibile ripristinare un intervallo di BLOB in uno o più contenitori. Un intervallo di BLOB è definito in modo lessicografico, ovvero nell'ordine del dizionario. Fino a dieci intervalli lexicografici sono supportati per ogni operazione di ripristino. L'inizio dell'intervallo è inclusivo e la fine dell'intervallo è esclusiva.

Il modello di contenitore specificato per l'intervallo iniziale e l'intervallo finale deve includere un minimo di tre caratteri. La barra (/) usata per separare il nome di un contenitore dal nome di un BLOB non viene conteggiata ai fini di questo valore minimo. Alcuni esempi per la struttura degli intervalli di ripristino:

Per includere l'intero contenitore denominato myContainer nell'intervallo per un intervallo di avvio usare l'intervallo di inizio myContainer e l'intervallo finale myContainer-0. In questo modo viene illustrato come aggiungere '-0' come suffisso al nome del contenitore per il valore dell'intervallo finale include tutto il contenuto nel contenitore per il ripristino.
Per includere un'intera gerarchia di directory virtuale, ad esempio la directory myFolder all'interno del contenitore myContainer, usare l'intervallo di inizio myContainer/myFolder / e l'intervallo finale myContainer/myFolder0. L'aggiunta di '0' come suffisso ai nomi di directory virtuali per l'intervallo finale include tutti i file con un prefisso 'myContainer/myFolder/' per il ripristino.

I caratteri jolly non sono supportati in un intervallo lexicografico. Tutti i caratteri jolly vengono trattati come caratteri standard.

È possibile ripristinare i BLOB nei contenitori $root e $web specificandoli esplicitamente in un intervallo passato a un'operazione di ripristino. I contenitori $root e $web vengono ripristinati solo se vengono specificati esplicitamente. Gli altri contenitori di sistema non possono essere ripristinati.

Vengono ripristinati solo i BLOB a blocchi. I BLOB di pagine e i BLOB di accodamento non sono inclusi in un'operazione di ripristino. Per altre informazioni sulle limitazioni correlate ai BLOB di accodamento, vedere Ripristino temporizzato per i BLOB a blocchi.

Importante

Quando si esegue un'operazione di ripristino, Archiviazione di Azure blocca le operazioni sui BLOB negli intervalli ripristinati per la durata dell'operazione. Le operazioni di lettura, scrittura ed eliminazione vengono bloccate nella posizione primaria. Per questo motivo, le operazioni come l'elenco dei contenitori nella portale di Azure potrebbero non essere eseguite come previsto mentre l'operazione di ripristino è in corso.

Le operazioni di lettura dal percorso secondario possono procedere durante l'operazione di ripristino se l'account di archiviazione viene replicato geograficamente.

Il tempo necessario per ripristinare un set di dati è basato sul numero di operazioni di scrittura ed eliminazione eseguite durante il periodo di ripristino dopo un'ora per la raccolta del processo di ripristino. Ad esempio, un account con un milione di oggetti con 3.000 oggetti aggiunti al giorno e 1.000 oggetti eliminati al giorno richiederanno circa due-tre ore per ripristinare un punto 30 giorni in passato. Un ripristino con un numero ridotto di modifiche richiede un massimo di un'ora per il ripristino. Un periodo di conservazione e ripristino di oltre 90 giorni in passato non sarebbe consigliato per un account con questa frequenza di modifica.

Ripristinare tutti i contenitori nell'account

È possibile ripristinare tutti i contenitori nell'account di archiviazione per restituirli allo stato precedente in un determinato momento.

Per ripristinare tutti i contenitori e i BLOB nell'account di archiviazione con il portale di Azure, seguire questa procedura:

Passare all'elenco dei contenitori per l'account di archiviazione.
Sulla barra degli strumenti scegliere Ripristina contenitori, quindi Ripristina tutto.
Nel riquadro Ripristina tutti i contenitori specificare il punto di ripristino specificando una data e un'ora.
Verificare di voler procedere selezionando la casella.
Selezionare Ripristina per avviare l'operazione di ripristino.

Per ripristinare tutti i contenitori e i BLOB nell'account di archiviazione con PowerShell, chiamare il comando Restore-AzStorageBlobRange e fornire il punto di ripristino come valore di data/ora UTC. Per impostazione predefinita, il comando Restore-AzStorageBlobRange viene eseguito in modo asincrono e restituisce un oggetto di tipo PSBlobRestoreStatus che è possibile usare per controllare lo stato dell'operazione di ripristino.

L'esempio seguente ripristina in modo asincrono i contenitori nell'account di archiviazione allo stato 12 ore prima del momento attuale e controlla alcune delle proprietà dell'operazione di ripristino:

# Specify -TimeToRestore as a UTC value
$restoreOperation = Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -TimeToRestore (Get-Date).ToUniversalTime().AddHours(-12)

# Get the status of the restore operation.
$restoreOperation.Status
# Get the ID for the restore operation.
$restoreOperation.RestoreId
# Get the restore point in UTC time.
$restoreOperation.Parameters.TimeToRestore

Per eseguire l'operazione di ripristino in modo sincrono, includere il parametro -WaitForComplete nel comando. Quando il parametro -WaitForComplete è presente, PowerShell visualizza un messaggio che include l'ID di ripristino per l'operazione e quindi blocca l'esecuzione fino al completamento dell'operazione di ripristino. Tenere presente che l'intervallo di tempo richiesto da un'operazione di ripristino dipende dalla quantità di dati da ripristinare e un'operazione di ripristino di grandi dimensioni può richiedere fino a un'ora per completare.

Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -TimeToRestore (Get-Date).AddHours(-12) -WaitForComplete

Per ripristinare tutti i contenitori e i BLOB nell'account di archiviazione con l'interfaccia della riga di comando di Azure, chiamare il comando az storage BLOB restore e fornire il punto di ripristino come valore di data/ora UTC.

Nell'esempio seguente vengono ripristinati in modo asincrono tutti i contenitori nell'account di archiviazione allo stato 12 ore prima di una data e un'ora specificati. Per controllare lo stato dell'operazione di ripristino, chiamare az storage account show:

az storage blob restore \
    --resource-group <resource_group> \
    --account-name <storage-account> \
    --time-to-restore 2021-01-14T06:31:22Z \
    --no-wait

Per controllare le proprietà di un'operazione di ripristino, chiamare az storage account show e espandere la proprietà BLOBRestoreStatus . Nell'esempio seguente viene illustrato come controllare la proprietà status .

az storage account show \
    --name <storage-account> \
    --resource-group <resource_group> \
    --expand blobRestoreStatus \
    --query blobRestoreStatus.status \
    --output tsv

Per eseguire il comando az storage BLOB restore in modo sincrono e bloccare l'esecuzione fino al completamento dell'operazione di ripristino, omettere il --no-wait parametro.

Intervalli di ripristino di BLOB a blocchi

È possibile ripristinare uno o più intervalli lessicografici di BLOB all'interno di un singolo contenitore o in più contenitori per restituire tali BLOB allo stato precedente in un determinato momento.

Per ripristinare un intervallo di BLOB in uno o più contenitori con la portale di Azure, seguire questa procedura:

Passare all'elenco dei contenitori per l'account di archiviazione.
Selezionare il contenitore o i contenitori da ripristinare.
Sulla barra degli strumenti scegliere Ripristina contenitori e quindi Ripristina selezionato.
Nel riquadro Ripristina contenitori selezionati specificare il punto di ripristino specificando una data e un'ora.
Specificare gli intervalli da ripristinare. Usare una barra in avanti (/) per delineare il nome del contenitore dal prefisso BLOB.
Per impostazione predefinita, il riquadro Ripristina contenitori selezionati specifica un intervallo che include tutti i BLOB nel contenitore. Eliminare questo intervallo se non si vuole ripristinare l'intero contenitore. L'intervallo predefinito viene visualizzato nell'immagine seguente.
Verificare di voler procedere selezionando la casella.
Selezionare Ripristina per avviare l'operazione di ripristino.

L'immagine seguente mostra un'operazione di ripristino in un set di intervalli.

Screenshot che mostra come ripristinare intervalli di BLOB in uno o più contenitori

L'operazione di ripristino illustrata nell'immagine esegue le azioni seguenti:

Ripristina il contenuto completo del contenitore1.
Ripristina i BLOB nel BLOB dell'intervallo lessicografico1 tramite BLOB5 nel contenitore2. Questo intervallo ripristina i BLOB con nomi come BLOB1, BLOB11, BLOB100, BLOB2 e così via. Poiché la fine dell'intervallo è esclusiva, ripristina i BLOB i cui nomi iniziano con BLOB4, ma non ripristina i BLOB i cui nomi iniziano con BLOB5.
Ripristina tutti i BLOB nel contenitore3 e nel contenitore4. Poiché la fine dell'intervallo è esclusiva, questo intervallo non ripristina il contenitore5.

Per ripristinare un singolo intervallo di BLOB, chiamare il comando Restore-AzStorageBlobRange e specificare un intervallo lexicografico di contenitori e nomi BLOB per il -BlobRestoreRange parametro. Ad esempio, per ripristinare i BLOB in un singolo contenitore denominato container1, è possibile specificare un intervallo che inizia con container1 e termina con il contenitore2. Non è necessario che i contenitori denominati nell'intervallo iniziale e finale esistano. Poiché la fine dell'intervallo è esclusiva, anche se l'account di archiviazione include un contenitore denominato container2, verrà ripristinato solo il contenitore denominato container1 :

$range = New-AzStorageBlobRangeToRestore -StartRange container1 `
    -EndRange container2

Per specificare un subset di BLOB in un contenitore da ripristinare, usare una barra in avanti (/) per separare il nome del contenitore dal modello di prefisso BLOB. L'intervallo seguente, ad esempio, seleziona i BLOB in un singolo contenitore i cui nomi iniziano con le lettere da d fino a f:

$range = New-AzStorageBlobRangeToRestore -StartRange container1/d `
    -EndRange container1/g

Specificare quindi l'intervallo al comando Restore-AzStorageBlobRange . Specificare il punto di ripristino fornendo un valore DateTime UTC per il parametro -TimeToRestore. L'esempio seguente ripristina i BLOB inclusi nell'intervallo specificato allo stato di 3 giorni precedenti al momento attuale:

# Specify -TimeToRestore as a UTC value
Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -BlobRestoreRange $range `
    -TimeToRestore (Get-Date).AddDays(-3)

Per impostazione predefinita, il comando Restore-AzStorageBlobRange viene eseguito in modo asincrono. Quando si avvia un'operazione di ripristino in modo asincrono, PowerShell visualizza immediatamente una tabella di proprietà per l'operazione:

Status     RestoreId                            FailureReason Parameters.TimeToRestore     Parameters.BlobRanges
------     ---------                            ------------- ------------------------     ---------------------
InProgress 459c2305-d14a-4394-b02c-48300b368c63               2020-09-15T23:23:07.1490859Z ["container1/d" -> "container1/g"]

Per ripristinare più intervalli di BLOB in blocchi, specificare una matrice di intervalli per il parametro -BlobRestoreRange. Nell'esempio seguente vengono specificati due intervalli per ripristinare il contenuto completo del contenitore1 e del contenitore4 allo stato 24 ore fa e salva il risultato in una variabile:

# Specify a range that includes the complete contents of container1.
$range1 = New-AzStorageBlobRangeToRestore -StartRange container1 `
    -EndRange container2
# Specify a range that includes the complete contents of container4.
$range2 = New-AzStorageBlobRangeToRestore -StartRange container4 `
    -EndRange container5

$restoreOperation = Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -TimeToRestore (Get-Date).AddHours(-24) `
    -BlobRestoreRange @($range1, $range2)

# Get the status of the restore operation.
$restoreOperation.Status
# Get the ID for the restore operation.
$restoreOperation.RestoreId
# Get the blob ranges specified for the operation.
$restoreOperation.Parameters.BlobRanges

Per eseguire l'operazione di ripristino in modo sincrono e bloccare l'esecuzione fino al completamento, includere il parametro -WaitForComplete nel comando.

Per ripristinare un intervallo di BLOB, chiamare il comando az storage BLOB restore e specificare un intervallo lessicografico di contenitori e nomi BLOB per il --blob-range parametro. Per specificare più intervalli, specificare il --blob-range parametro per ogni intervallo distinto.

Ad esempio, per ripristinare i BLOB in un singolo contenitore denominato container1, è possibile specificare un intervallo che inizia con container1 e termina con il contenitore2. Non è necessario che i contenitori denominati nell'intervallo iniziale e finale esistano. Poiché la fine dell'intervallo è esclusiva, anche se l'account di archiviazione include un contenitore denominato container2, verrà ripristinato solo il contenitore denominato container1 .

Per specificare un subset di BLOB in un contenitore da ripristinare, usare una barra in avanti (/) per separare il nome del contenitore dal modello di prefisso BLOB. L'esempio illustrato di seguito ripristina in modo asincrono un intervallo di BLOB in un contenitore i cui nomi iniziano con le lettere d tramite f.

az storage blob restore \
    --account-name <storage-account> \
    --time-to-restore 2021-01-14T06:31:22Z \
    --blob-range container1 container2
    --blob-range container3/d container3/g
    --no-wait