Executar uma restauração point-in-time em dados de blob de bloco

Você pode usar a restauração point-in-time para restaurar um ou mais conjuntos de blobs de bloco para um estado anterior. Este artigo descreve como habilitar a restauração point-in-time para uma conta de armazenamento e como executar uma operação de restauração.

Para saber mais sobre a restauração point-in-time, consulte Restauração point-in-time para blobs de bloco.

Nota

A restauração point-in-time é suportada apenas para contas de armazenamento v2 de uso geral na camada de desempenho padrão. Somente os dados nas camadas de acesso quente e frio podem ser restaurados com restauração point-in-time.

Atenção

A restauração point-in-time suporta operações de restauração somente em blobs de bloco. As operações em contêineres não podem ser restauradas. Se você excluir um contêiner da conta de armazenamento chamando a operação Excluir contêiner , esse contêiner não poderá ser restaurado com uma operação de restauração. Em vez de excluir um contêiner inteiro, exclua blobs individuais se quiser restaurá-los mais tarde. Além disso, a Microsoft recomenda habilitar a exclusão suave para contêineres e blobs para proteger contra exclusão acidental. Para obter mais informações, consulte Exclusão flexível para contêineres e Exclusão suave para blobs.

Habilitar e configurar a restauração point-in-time

Antes de habilitar e configurar a restauração point-in-time, habilite seus pré-requisitos para a conta de armazenamento: exclusão suave, feed de alteração e controle de versão de blob. Para obter mais informações sobre como habilitar cada um desses recursos, consulte estes artigos:

• Ativar a eliminação recuperável para blobs
• Ativar e desativar o feed de alterações
• Habilitar e gerenciar o controle de versão de blob

Importante

Habilitar a exclusão suave, o feed de alteração e o controle de versão de blob pode resultar em cobranças adicionais. Para obter mais informações, consulte Exclusão suave para blobs, Suporte a feed de alteração no Armazenamento de Blobs do Azure e Controle de versão de Blob.

Portal do Azure

Para configurar a restauração point-in-time com o portal do Azure, siga estas etapas:

1. Navegue para a sua conta de armazenamento no portal do Azure.
2. Em Gerenciamento de dados, escolha Proteção de dados.
3. Selecione Ativar restauração point-in-time . Quando você seleciona essa opção, a exclusão suave para blobs, controle de versão e feed de alteração também são habilitadas.
4. Defina o ponto de restauração máximo para restauração point-in-time, em dias. Esse número deve ser pelo menos um dia menor do que o período de retenção especificado para a exclusão suave de blob.
5. Guardar as suas alterações.

A imagem a seguir mostra uma conta de armazenamento configurada para restauração point-in-time com um ponto de restauração de sete dias atrás e um período de retenção para exclusão suave de blob de 14 dias.

PowerShell

Para configurar a restauração point-in-time com o PowerShell, primeiro instale o módulo Az.Storage versão 2.6.0 ou posterior. Em seguida, chame o comando Enable-AzStorageBlobRestorePolicy para habilitar a restauração point-in-time para a conta de armazenamento.

O exemplo a seguir habilita a exclusão suave e define o período de retenção de exclusão suave, habilita o feed de alterações e o controle de versão e, em seguida, habilita a restauração point-in-time. Ao executar o exemplo, lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

# 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

CLI do Azure

Para configurar a restauração point-in-time com a CLI do Azure, primeiro instale a CLI do Azure versão 2.2.0 ou posterior. Em seguida, chame o comando az storage account blob-service-properties update para habilitar a restauração point-in-time e as outras configurações de proteção de dados necessárias para a conta de armazenamento.

O exemplo a seguir habilita a exclusão suave e define o período de retenção de exclusão suave para 14 dias, habilita o feed de alterações e o controle de versão e habilita a restauração point-in-time com um período de restauração de 7 dias. Ao executar o exemplo, lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

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

Escolha um ponto de restauração

O ponto de restauração é a data e a hora para as quais os dados são restaurados. O Armazenamento do Azure sempre usa um valor de data/hora UTC como o ponto de restauração. No entanto, o portal do Azure permite especificar o ponto de restauração na hora local e, em seguida, converte esse valor de data/hora em um valor de data/hora UTC para executar a operação de restauração.

Ao executar uma operação de restauração com o PowerShell ou a CLI do Azure, você deve especificar o ponto de restauração como um valor de data/hora UTC. Se o ponto de restauração for especificado com um valor de hora local em vez de um valor de hora UTC, a operação de restauração ainda poderá se comportar como esperado em alguns casos. Por exemplo, se a hora local for UTC menos cinco horas, especificar um valor de hora local resultará em um ponto de restauração cinco horas antes do valor fornecido. Se nenhuma alteração for feita nos dados no intervalo a ser restaurado durante esse período de cinco horas, a operação de restauração produzirá os mesmos resultados, independentemente do valor de tempo fornecido. Recomenda-se especificar uma hora UTC para o ponto de restauração para evitar resultados inesperados.

Executar uma operação de restauração

Você pode restaurar todos os contêineres na conta de armazenamento ou restaurar uma variedade de blobs em um ou mais contêineres. Uma gama de bolhas é definida lexicograficamente, significando em ordem de dicionário. São suportados até dez intervalos lexicográficos por operação de restauro. O início da gama é inclusivo e o fim da gama é exclusivo.

O padrão de contêiner especificado para o intervalo inicial e o intervalo final deve incluir um mínimo de três caracteres. A barra (/) usada para separar um nome de contêiner de um nome de blob não conta para esse mínimo. Alguns exemplos de como estruturar seus intervalos de restauração:

• Para incluir o contêiner inteiro chamado myContainer no intervalo para uma restauração, use o intervalo inicial myContainer e o intervalo final myContainer-0. Isso mostra como adicionar '-0' como um sufixo ao nome do contêiner para o valor do intervalo final inclui tudo no contêiner para a restauração.
• Para incluir uma hierarquia de diretórios virtuais inteira, como o diretório myFolder dentro do contêiner myContainer, use o intervalo inicial myContainer/myFolder/ e o intervalo final myContainer/myFolder0. Adicionar '0' como um sufixo aos nomes de diretórios virtuais para o intervalo final inclui todos os arquivos com um prefixo 'myContainer/myFolder/' para a restauração.

Não há suporte para caracteres curinga em um intervalo lexicográfico. Todos os caracteres curinga são tratados como caracteres padrão.

Você pode restaurar blobs nos $root contêineres e $web especificando-os explicitamente em um intervalo passado para uma operação de restauração. Os $root contêineres e $web são restaurados somente se forem explicitamente especificados. Outros contêineres do sistema não podem ser restaurados.

Apenas os blobs de bloco são restaurados. Blobs de página e blobs de acréscimo não são incluídos em uma operação de restauração. Para obter mais informações sobre limitações relacionadas a blobs de acréscimo, consulte Restauração point-in-time para blobs de bloco.

Importante

Quando você executa uma operação de restauração, o Armazenamento do Azure bloqueia as operações de dados nos blobs nos intervalos que estão sendo restaurados durante a operação. As operações de leitura, gravação e exclusão são bloqueadas no local principal. Por esse motivo, operações como listar contêineres no portal do Azure podem não ter o desempenho esperado enquanto a operação de restauração está em andamento.

As operações de leitura do local secundário podem prosseguir durante a operação de restauração se a conta de armazenamento for replicada geograficamente.

O tempo necessário para restaurar um conjunto de dados é baseado no número de operações de gravação e exclusão feitas durante o período de restauração após até uma hora para que o trabalho de restauração seja retomado. Por exemplo, uma conta com um milhão de objetos com 3.000 objetos adicionados por dia e 1.000 objetos excluídos por dia exigirá aproximadamente duas a três horas para restaurar para um ponto de 30 dias no passado. Uma restauração com um pequeno número de alterações exigiria até uma hora para ser restaurada. Um período de retenção e restauração superior a 90 dias no passado não seria recomendado para uma conta com esta taxa de alteração.

Restaurar todos os contêineres na conta

Você pode restaurar todos os contêineres na conta de armazenamento para devolvê-los ao estado anterior em um determinado momento.

Portal do Azure

Para restaurar todos os contêineres e blobs na conta de armazenamento com o portal do Azure, siga estas etapas:

1. Navegue até a lista de contêineres da sua conta de armazenamento.

2. Na barra de ferramentas, escolha Restaurar contêineres e, em seguida , Restaurar tudo.

3. No painel Restaurar todos os contêineres , especifique o ponto de restauração fornecendo uma data e hora.

4. Confirme que deseja continuar marcando a caixa.

5. Selecione Restaurar para iniciar a operação de restauração.

   

PowerShell

Para restaurar todos os contêineres e blobs na conta de armazenamento com o PowerShell, chame o comando Restore-AzStorageBlobRange e forneça o ponto de restauração como um valor de data/hora UTC. Por padrão, o comando Restore-AzStorageBlobRange é executado de forma assíncrona e retorna um objeto do tipo PSBlobRestoreStatus que você pode usar para verificar o status da operação de restauração.

O exemplo a seguir restaura de forma assíncrona os contêineres na conta de armazenamento para seu estado 12 horas antes do momento presente e verifica algumas das propriedades da operação de restauração:

# 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

Para executar a operação de restauração de forma síncrona, inclua o parâmetro -WaitForComplete no comando. Quando o parâmetro -WaitForComplete está presente, o PowerShell exibe uma mensagem que inclui a ID de restauração da operação e, em seguida, bloqueia a execução até que a operação de restauração seja concluída. Lembre-se de que o período de tempo exigido por uma operação de restauração depende da quantidade de dados a serem restaurados, e uma grande operação de restauração pode levar até uma hora para ser concluída.

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

CLI do Azure

Para restaurar todos os contêineres e blobs na conta de armazenamento com a CLI do Azure, chame o comando az storage blob restore e forneça o ponto de restauração como um valor de data/hora UTC.

O exemplo a seguir restaura de forma assíncrona todos os contêineres na conta de armazenamento para seu estado 12 horas antes de uma data e hora especificadas. Para verificar o status da operação de restauração, chame 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

Para verificar as propriedades de uma operação de restauração, chame az storage account show e expanda a propriedade blobRestoreStatus . O exemplo a seguir mostra como verificar a propriedade status .

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

Para executar o comando az storage blob restore de forma síncrona e bloquear a execução até que a operação de restauração seja concluída, omita o --no-wait parâmetro.

Restaurar intervalos de blobs de bloco

Você pode restaurar um ou mais intervalos lexicográficos de blobs em um único contêiner ou em vários contêineres para retornar esses blobs ao seu estado anterior em um determinado momento.

Portal do Azure

Para restaurar um intervalo de blobs em um ou mais contêineres com o portal do Azure, siga estas etapas:

1. Navegue até a lista de contêineres da sua conta de armazenamento.

2. Selecione o contêiner ou contêineres a serem restaurados.

3. Na barra de ferramentas, escolha Restaurar contêineres e, em seguida , Restaurar selecionado.

4. No painel Restaurar contêineres selecionados, especifique o ponto de restauração fornecendo uma data e hora.

5. Especifique os intervalos a serem restaurados. Use uma barra (/) para delinear o nome do contêiner a partir do prefixo blob.

6. Por padrão, o painel Restaurar contêineres selecionados especifica um intervalo que inclui todos os blobs no contêiner. Exclua esse intervalo se não quiser restaurar o contêiner inteiro. O intervalo padrão é mostrado na imagem a seguir.

   

7. Confirme que deseja continuar marcando a caixa.

8. Selecione Restaurar para iniciar a operação de restauração.

A imagem a seguir mostra uma operação de restauração em um conjunto de intervalos.

A operação de restauração mostrada na imagem executa as seguintes ações:

• Restaura o conteúdo completo do recipiente1.
• Restaura blobs no intervalo lexicográfico blob1 a blob5 no container2. Esse intervalo restaura blobs com nomes como blob1, blob11, blob100, blob2 e assim por diante. Como o fim do intervalo é exclusivo, ele restaura blobs cujos nomes começam com blob4, mas não restaura blobs cujos nomes começam com blob5.
• Restaura todos os blobs no container3 e container4. Como o fim do intervalo é exclusivo, esse intervalo não restaura o contêiner5.

PowerShell

Para restaurar um único intervalo de blobs, chame o comando Restore-AzStorageBlobRange e especifique um intervalo lexicográfico de nomes de contêiner e blob para o -BlobRestoreRange parâmetro. Por exemplo, para restaurar os blobs em um único contêiner chamado container1, você pode especificar um intervalo que começa com container1 e termina com container2. Não há nenhum requisito para que os contêineres nomeados nos intervalos inicial e final existam. Como o fim do intervalo é exclusivo, mesmo que a conta de armazenamento inclua um contêiner chamado container2, somente o contêiner chamado container1 será restaurado:

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

Para especificar um subconjunto de blobs em um contêiner a ser restaurado, use uma barra (/) para separar o nome do contêiner do padrão de prefixo de blob. Por exemplo, o intervalo a seguir seleciona blobs em um único contêiner cujos nomes começam com as letras d a f:

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

Em seguida, forneça o intervalo para o comando Restore-AzStorageBlobRange . Especifique o ponto de restauração fornecendo um valor UTC DateTime para o -TimeToRestore parâmetro. O exemplo a seguir restaura blobs no intervalo especificado para seu estado 3 dias antes do momento presente:

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

Por padrão, o comando Restore-AzStorageBlobRange é executado de forma assíncrona. Quando você inicia uma operação de restauração de forma assíncrona, o PowerShell exibe imediatamente uma tabela de propriedades para a operação:

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

Para restaurar vários intervalos de blobs de bloco, especifique uma matriz de intervalos para o -BlobRestoreRange parâmetro. O exemplo a seguir especifica dois intervalos para restaurar o conteúdo completo de container1 e container4 para seu estado há 24 horas e salva o resultado em uma variável:

# 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

Para executar a operação de restauração de forma síncrona e bloquear a execução até que ela seja concluída, inclua o parâmetro -WaitForComplete no comando.

CLI do Azure

Para restaurar um intervalo de blobs, chame o comando az storage blob restore e especifique um intervalo lexicográfico de nomes de contêiner e blob para o --blob-range parâmetro. Para especificar vários intervalos, forneça o --blob-range parâmetro para cada intervalo distinto.

Por exemplo, para restaurar os blobs em um único contêiner chamado container1, você pode especificar um intervalo que começa com container1 e termina com container2. Não há nenhum requisito para que os contêineres nomeados nos intervalos inicial e final existam. Como o fim do intervalo é exclusivo, mesmo que a conta de armazenamento inclua um contêiner chamado container2, somente o contêiner chamado container1 será restaurado.

Para especificar um subconjunto de blobs em um contêiner a ser restaurado, use uma barra (/) para separar o nome do contêiner do padrão de prefixo de blob. O exemplo mostrado abaixo restaura de forma assíncrona um intervalo de blobs em um contêiner cujos nomes começam com as letras d até 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

Para executar o comando az storage blob restore de forma síncrona e bloquear a execução até que a operação de restauração seja concluída, omita o --no-wait parâmetro.

Próximos passos

• Restauração point-in-time para blobs de bloco
• Exclusão suave
• Alterar feed
• Controle de versão de Blob