Eseguire il ripristino temporizzato sui dati BLOB in blocchi

Articolo
07/23/2024

È possibile usare il ripristino temporizzato per ripristinare uno o più serie di BLOB in blocchi a 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 BLOB in blocchi.

Nota

Il ripristino temporizzato è supportato solo per gli account di archiviazione v2 per uso generico nel livello di prestazioni standard. Solo i dati nei livelli ad accesso frequente e sporadico possono essere ripristinati con il 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, il contenitore non può essere ripristinato con un'operazione di ripristino. Invece di eliminare un intero contenitore, eliminare singoli BLOB se si prevede di ripristinarli in un secondo momento. Microsoft consiglia anche di abilitare l'eliminazione temporanea per contenitori e BLOB, per proteggerli dall'eliminazione accidentale. Per altre informazioni, vedere Eliminazione temporanea per contenitori ed Eliminazione temporanea per BLOB.

Abilitare e configurare il ripristino temporizzato

Prima di abilitare e configurare il ripristino temporizzato, abilitare i relativi prerequisiti per l'account di archiviazione: eliminazione temporanea, feed di modifiche e controllo delle versioni dei 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 costi aggiuntivi. Per altre informazioni, vedere Eliminazione temporanea per BLOB, Supporto del feed di modifiche in Archiviazione BLOB di Azure e Controllo delle versioni dei BLOB.

Per configurare il ripristino temporizzato con il portale di Azure, seguire questi passaggi:

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

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

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

Per configurare il ripristino temporizzato con PowerShell, installare prima la versione del modulo Az.Storage 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 relativo periodo di conservazione, 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 la versione dell'interfaccia della riga di comando di Azure 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 relativo periodo di conservazione dell'eliminazione temporanea a 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, il 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, specificare il punto di ripristino come valore di data/ora UTC. Se il punto di ripristino viene specificato con un valore di ora locale anziché un valore di ora UTC, l'operazione di ripristino può comunque comportarsi come previsto in alcuni casi. Ad esempio, se l'ora locale è UTC meno cinque ore, specificando un valore di ora locale viene, si ottiene un punto di ripristino di cinque ore prima del valore specificato. Se non sono state apportate modifiche ai dati nell'intervallo da ripristinare durante tale periodo di cinque ore, l'operazione di ripristino produrrà gli stessi risultati indipendentemente dal valore di ora 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 ripristinare un intervallo di BLOB in uno o più contenitori. Un intervallo di BLOB è definito lessicograficamente, ovvero in ordine di dizionario. Sono supportati fino a dieci intervalli lessicografici per ogni operazione di ripristino. L'inizio dell'intervallo è incluso, mentre la fine è esclusa.

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 di come strutturare gli intervalli di ripristino:

Per includere l'intero contenitore denominato myContainer nell'intervallo per un ripristino, usare l'intervallo iniziale myContainer e l'intervallo finale myContainer-0. Ciò mostra che l'aggiunta di "-0" come suffisso al nome del contenitore per il valore dell'intervallo finale include tutti gli elementi nel contenitore per il ripristino.
Per includere un'intera gerarchia di directory virtuali, ad esempio la directory myFolder all'interno del contenitore myContainer, usare l'intervallo iniziale myContainer/myFolder/ e l'intervallo finale myContainer/myFolder0. L'aggiunta di "0" come suffisso ai nomi delle 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 lessicografico. I caratteri jolly Vengono gestiti 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 in 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 BLOB in blocchi.

Importante

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

Le operazioni di lettura dalla posizione secondaria possono continuare durante l'operazione di ripristino se l'account di archiviazione è con replica geografica.

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 periodo fino a un'ora per la selezione del processo di ripristino. Ad esempio, un account con un milione di oggetti con 3.000 oggetti aggiunti e 1.000 oggetti eliminati al giorno richiederà circa 2-3 ore per il ripristino in un punto corrispondente a 30 giorni nel passato. Un ripristino con un numero ridotto di modifiche richiederebbe fino a un'ora. Un periodo di conservazione e un ripristino superiore a 90 giorni nel passato è sconsigliabile 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 punto nel tempo.

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

Passare all'elenco dei contenitori per l'account di archiviazione.
Nella barra degli strumenti, scegliere Ripristina contenitori, quindi Ripristina tutti.
Nel riquadro Ripristina tutti i contenitori, specificare il punto di ripristino specificando una data e un'ora.
Confermare che si desidera continuare 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 specificare 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 al loro stato 12 ore prima del momento presente e controlla alcune 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 è presente il parametro -WaitForComplete, 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 il tempo richiesto da un'operazione di ripristino dipende dalla quantità di dati da ripristinare e il completamento di un'operazione di ripristino di grandi dimensioni può richiedere fino a un'ora.

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 specificare il punto di ripristino come valore di data/ora UTC.

L'esempio seguente ripristina tutti i contenitori nell'account di archiviazione al loro stato di 12 ore prima di una data e ora specificate. 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 ed espandere la proprietà blobRestoreStatus. Nell'esempio seguente viene illustrato come controllare la proprietà stato.

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 parametro --no-wait.

Ripristinare più intervalli di blob in blocchi

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

Per ripristinare un intervallo di BLOB in uno o più contenitori con il portale di Azure, seguire questi passaggi:

Passare all'elenco dei contenitori per l'account di archiviazione.
Selezionare il contenitore o i contenitori da ripristinare.
Nella barra degli strumenti, scegliere Ripristina contenitori, quindi Ripristina selezionati.
Nel riquadro Ripristina i contenitori selezionati, specificare il punto di ripristino specificando una data e un'ora.
Specificare gli intervalli da ripristinare. Usare una barra (/) per delineare il nome del contenitore dal prefisso del 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 desidera ripristinare l'intero contenitore. L'intervallo predefinito è illustrato nell'immagine seguente.
Confermare che si desidera continuare selezionando la casella.
Selezionare Ripristina per avviare l'operazione di ripristino.

L'immagine seguente illustra un'operazione di ripristino in una serie di intervalli.

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

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

Ripristina il contenuto completo di container1.
Ripristina i BLOB nell'intervallo lessicografico blob1 tramite blob5 in container2. 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 in container3 e container4. Poiché la fine dell'intervallo è esclusiva, questo intervallo non ripristina container5.

Per ripristinare un singolo intervallo di BLOB, chiamare il comando Restore-AzStorageBlobRange e specificare un intervallo lessicografico di nomi di contenitori e BLOB per il parametro -BlobRestoreRange. Ad esempio, per ripristinare i BLOB in un singolo contenitore denominato container1, è possibile specificare un intervallo che inizia con container1 e termina con container2. 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 sottoinsieme di BLOB in un contenitore da ripristinare, usare una barra (/) per separare il nome del contenitore dal modello del 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 nel 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. L'esempio seguente specifica due intervalli per ripristinare il contenuto completo di container1 e container4 allo stato di 24 ore prima 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 nomi di contenitori e BLOB per il parametro --blob-range. Per specificare più intervalli, specificare il parametro --blob-range 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 container2. 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 sottoinsieme di BLOB in un contenitore da ripristinare, usare una barra (/) per separare il nome del contenitore dal modello del prefisso BLOB. L'esempio seguente 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

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

Condividi tramite