Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo descreve como restaurar backups de bases de dados em streaming e backups snapshot de instâncias SQL com Azure PowerShell. Pode restaurar um ponto de recuperação ou usar registos de transações para recuperação pontual no tempo (PITR).
Prerequisites
- Instale o módulo mais recente do Azure PowerShell, incluindo o Az.RecoveryServices. A restauração SQL em streaming requer o Az 6.0.0 ou posterior. Exemplos de snapshot requerem uma versão de módulo que exponha os parâmetros de snapshot apresentados aqui.
- Tem uma base de dados SQL ou uma cópia de segurança de instância existente. Revise os pré-requisitos de restauro e a matriz de suporte a snapshots.
- Para restaurações de snapshots, prepare um grupo de recursos alvo e uma identidade gerida atribuída pelo utilizador com as permissões necessárias. Veja os requisitos de restauro do snapshot.
- Registar a VM de destino no cofre apropriado antes do restauro para localização alternativa.
- Substitua os valores entre sinais de maior e menor. Execute a configuração comum para o cenário selecionado e depois escolha um exemplo de configuração de restauro. A configuração por exemplo não inicia uma restauração até submeter a configuração.
Inicie sessão, selecione a subscrição do vault e recupere o cofre:
Connect-AzAccount
Select-AzSubscription -SubscriptionId "<vault-subscription-id>"
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "<vault-rg>" -Name "<vault-name>"
Restaurar uma cópia de segurança de uma base de dados em streaming
Selecione a base de dados e o tempo de recuperação
Limitar a consulta da base de dados ao contentor da VM de origem:
$sourceContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-BackupManagementType AzureWorkload -FriendlyName "<source-vm>" -VaultId $vault.ID
$databaseItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
-WorkloadType MSSQL -Name "SQLDataBase;<instance-name>;<database-name>" `
-VaultId $vault.ID
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
-StartDate $startDate -EndDate $endDate -VaultId $vault.ID
$fullRecoveryPoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
-RecoveryPointId "<recovery-point-id>" -VaultId $vault.ID
Para PITR, consulte os intervalos de logs contínuos com Get-AzRecoveryServicesBackupRecoveryLogChain e selecione um tempo UTC dentro de um desses intervalos:
$logRanges = Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem -VaultId $vault.ID
$logRanges | Select-Object ItemName, StartTime, EndTime
$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()
Para streaming PITR, o serviço determina a cadeia completa de backup e registos necessária para o momento selecionado.
Restaurar para a localização original
Escolha um ponto de recuperação total ou diferencial:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $fullRecoveryPoint -OriginalWorkloadRestore -VaultId $vault.ID
Em alternativa, use o ponto temporal selecionado:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -OriginalWorkloadRestore -VaultId $vault.ID
Warning
Restaurar a base de dados para a localização original sobreescreve a base de dados original. Revise a configuração da recuperação antes de a submeter.
Restaurar para uma localização alternativa
Selecione o contentor de VM de destino e a instância SQL:
$targetContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-BackupManagementType AzureWorkload -FriendlyName "<target-vm>" -VaultId $vault.ID
$targetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
-ItemType SQLInstance -Name "<target-instance>" -ServerName "<target-vm>" `
-VaultId $vault.ID
Para um ponto de recuperação total ou diferencial:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $fullRecoveryPoint -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer -VaultId $vault.ID
Para PITR:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer -VaultId $vault.ID
Inspecione o nome da base de dados gerado e os caminhos dos ficheiros. Mude-os conforme necessário para o destino:
$recoveryConfig | Format-List
$recoveryConfig.targetPhysicalPath | Format-Table
$recoveryConfig.RestoredDBName = "<restored-database-name>"
Restaurar backups em streaming como ficheiros
Para restaurar uma cópia de segurança completa ou diferencial como ficheiros na VM alvo registada:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $fullRecoveryPoint -TargetContainer $targetContainer `
-RestoreAsFiles -FilePath "<target-folder>" -VaultId $vault.ID
Para o registo PITR, peça ficheiros ao backup completo mais recente aplicável:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -TargetContainer $targetContainer `
-RestoreAsFiles -FilePath "<target-folder>" -VaultId $vault.ID
Para usar uma cópia de segurança completa específica para a restauração de ficheiros, adicione -FromFull $fullRecoveryPoint ao comando PITR configuration.
Consultar pontos de recuperação de capturas instantâneas
Selecione a instância protegida
A configuração seguinte seleciona um item de instância e lista os seus pontos de recuperação. Use esta configuração para os cenários de restauro da instância mais adiante neste artigo:
$sourceContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-BackupManagementType AzureWorkload -FriendlyName "<source-vm>" -VaultId $vault.ID
$instanceItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
-WorkloadType MSSQLInstance -Name "sqlinstance;<instance-name>" -VaultId $vault.ID
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$recoveryPoints = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
-StartDate $startDate -EndDate $endDate `
-RestorePointQueryType FullDifferentialAndSnapshot -VaultId $vault.ID
$snapshotPoints = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
-RestorePointQueryType Snapshot -VaultId $vault.ID
$latestSnapshot = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
-GetLatestRecoveryPointOnly -RestorePointQueryType Snapshot -VaultId $vault.ID
$snapshotPoints | Format-Table RecoveryPointId, RecoveryPointTime, RecoveryPointType
Escolha um ID da lista devolvida. Obtém este ponto de recuperação por ID para recuperar todos os detalhes, em vez de assumir que a primeira entrada da lista é o instantâneo desejado:
$snapshotPoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $instanceItem `
-RecoveryPointId "<snapshot-recovery-point-id>" -VaultId $vault.ID
$snapshotPoint.IncludedDatabases | Select-Object DatasourceName, DatasourceId
$snapshotPoint.SnapshotRecoveryPointInfo.SnapshotResourceGroup
$snapshotPoint.SnapshotRecoveryPointInfo.SourceFilesystemInfo | Select-Object `
Label, FileSystemType, @{Name = 'AccessPaths'; Expression = { $_.AccessPaths -join ',' }}, IsOnStorageSpace
Intervalos do registo de consulta superiores ao instantâneo da instância
As consultas em cadeia de logs direcionam cada item da base de dados incluído no snapshot. O ID base da fonte de dados é o da ProtectedItemDataSourceId, não o da base de dados DatasourceId:
$logRangesPerDatabase = @{}
foreach ($database in $snapshotPoint.IncludedDatabases) {
$databaseItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
-WorkloadType MSSQL -Name "SQLDataBase;$($database.DatasourceName)" -VaultId $vault.ID
$logRangesPerDatabase[$database.DatasourceName] = @(
Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem `
-RecoveryMode SnapshotAttachAndRecover `
-BaseSnapshotRecoveryPointId $snapshotPoint.RecoveryPointId `
-BaseRecoveryPointDatasourceId $instanceItem.ProtectedItemDataSourceId `
-VaultId $vault.ID
)
}
$logRangesPerDatabase["<instance-name>;<database-name>"] | Format-Table ItemName, StartTime, EndTime
Utilize Get-AzRecoveryServicesBackupRecoveryLogChain para intervalos de tempo.
Get-AzRecoveryServicesBackupRecoveryPoint devolve pontos individuais de recuperação, não intervalos contínuos de registos.
Restaurar um snapshot de instância
Utilize a instância e os detalhes $snapshotPoint dos pontos de recuperação de instantâneos de consulta. Tanto as configurações de snapshots originais como as de localização alternativa requerem um grupo de recursos alvo e uma identidade gerida atribuída pelo utilizador:
$identityId = "/subscriptions/<subscription-id>/resourceGroups/<identity-rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"
$targetResourceGroup = "<target-rg>"
Restaurar na localização original
Construa uma configuração de restauro com carga de trabalho original:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $snapshotPoint -OriginalWorkloadRestore `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-VaultId $vault.ID
Restauro para localização alternativa
Selecione o contentor de destino e a instância. Utilize esta configuração de destino para restauração em locais alternativos, instância PITR e restauração como discos:
$targetContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-BackupManagementType AzureWorkload -FriendlyName "<target-vm>" -VaultId $vault.ID
$targetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
-ItemType SQLInstance -Name "<target-instance>" -ServerName "<target-vm>" -VaultId $vault.ID
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $snapshotPoint -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-VaultId $vault.ID
Restauração de um ponto específico no tempo
Primeiro, execute a consulta log-range por base de dados. Escolha um tempo de restauração UTC disponível para todas as bases de dados que estão a ser restauradas. A verificação seguinte rejeita uma hora fora de todos os intervalos de qualquer base de dados:
$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()
if ($logRangesPerDatabase.Count -eq 0) {
throw "No database log ranges were retrieved for the selected snapshot."
}
foreach ($databaseName in $logRangesPerDatabase.Keys) {
$matchingRanges = @($logRangesPerDatabase[$databaseName] | Where-Object {
$_.StartTime.ToUniversalTime() -le $pointInTime -and
$_.EndTime.ToUniversalTime() -ge $pointInTime
})
if ($matchingRanges.Count -eq 0) {
throw "The selected restore time is unavailable for $databaseName."
}
}
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $snapshotPoint -PointInTime $pointInTime `
-AlternateWorkloadRestore -TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID
O ponto de recuperação do snapshot identifica o snapshot base; -PointInTime especifica o alvo de replay do log. Este exemplo solicita que -NoRecoveryMode deixe as bases de dados num estado não recuperado para passos subsequentes de recuperação. Reveja essa opção para o seu plano de recuperação.
Restaurar para discos
Utilize SnapshotAttach para anexar os discos snapshot em vez de realizar a anexação de snapshot e a recuperação da base de dados:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $snapshotPoint -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttach -VaultId $vault.ID
Configurar caminhos de destino e conflitos de disco
Inspecione targetPhysicalPath antes de submeter qualquer configuração de snapshot de instância. Os volumes de origem estão listados com caminhos alvo em branco. Defina um caminho alvo apenas para volumes que necessitem de remapeamento, como ao resolver um conflito no sistema de ficheiros:
$recoveryConfig.targetPhysicalPath | Format-Table SourcePath, TargetPath
($recoveryConfig.targetPhysicalPath | Where-Object { $_.SourcePath -eq "E:\" }).TargetPath = "X:\"
Substitua os caminhos de origem e destino de exemplo por caminhos apropriados para o seu ponto de recuperação e destino. Se for necessária a desanexação do disco para resolver um conflito, identifique explicitamente os discos afetados:
$recoveryConfig.DisksToDetachOnClash = @(
"/subscriptions/<subscription-id>/resourceGroups/<disk-rg>/providers/Microsoft.Compute/disks/<disk-name>"
)
Warning
Desanexar um disco existente pode perturbar as cargas de trabalho que o utilizam. Confirme os IDs dos discos e a configuração do sistema de ficheiros de destino antes de submeter a restauração.
Restaurar uma base de dados protegida por uma instância
Configuração geral
Selecione o item de backup da base de dados, o contentor de destino e a instância, o grupo de recursos alvo e a identidade:
$sourceContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-BackupManagementType AzureWorkload -FriendlyName "<source-vm>" -VaultId $vault.ID
$databaseItem = Get-AzRecoveryServicesBackupItem -Container $sourceContainer `
-WorkloadType MSSQL -Name "SQLDataBase;<instance-name>;<database-name>" -VaultId $vault.ID
$targetContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-BackupManagementType AzureWorkload -FriendlyName "<target-vm>" -VaultId $vault.ID
$targetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
-ItemType SQLInstance -Name "<target-instance>" -ServerName "<target-vm>" -VaultId $vault.ID
$targetResourceGroup = "<target-rg>"
$identityId = "/subscriptions/<subscription-id>/resourceGroups/<identity-rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"
Para uma restauração do ponto de recuperação de snapshots, liste os snapshots da base de dados e obtenha o ponto escolhido por ID:
Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
-RestorePointQueryType Snapshot -VaultId $vault.ID
$databaseSnapshot = Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
-RecoveryPointId "<database-snapshot-recovery-point-id>" -VaultId $vault.ID
Restauro em localização alternativa
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $databaseSnapshot -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID
Restauração de um ponto específico no tempo
Liste os intervalos de registos disponíveis da base de dados e selecione uma hora UTC dentro de um intervalo retornado:
$logRanges = Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem -VaultId $vault.ID
$logRanges | Select-Object ItemName, StartTime, EndTime
$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID
Ambos os exemplos de recuperação de bases de dados especificam -NoRecoveryMode. Verifique se o seu plano de recuperação exige que a base de dados permaneça não recuperada.
Restaurar para discos
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $databaseSnapshot -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttach -VaultId $vault.ID
Restaurar como discos e os registos como ficheiros
Escolha uma hora dos intervalos de registos disponíveis da base de dados, como no exemplo do PITR da base de dados, depois configure o destino do ficheiro de log:
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttach -TargetDirectoryMapping @{ all = "C:/temp" } `
-VaultId $vault.ID
Para qualquer uma destas configurações de snapshots de base de dados, inspecione os caminhos de origem e defina os mapeamentos de volume alvo necessários antes de submeter:
$recoveryConfig.targetPhysicalPath | Format-Table SourcePath, TargetPath
($recoveryConfig.targetPhysicalPath | Where-Object { $_.SourcePath -eq "E:\" }).TargetPath = "M:\"
Submeta a restauração e acompanhe a tarefa
Revise a configuração selecionada e depois submeta usando Restore-AzRecoveryServicesBackupItem:
$recoveryConfig | Format-List
$restoreJob = Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $recoveryConfig -VaultId $vault.ID
$restoreJob
Usa o ID de trabalho devolvido com os comandos de monitorização de trabalho.
Restauro entre regiões para backups de bases de dados em streaming
Ao ativar a restauração entre regiões, utilize -UseSecondaryRegion para consultar itens replicados, pontos de recuperação e cadeias de registos. A VM alvo deve ser registada num cofre na região emparelhada:
$secondaryItems = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureWorkload `
-WorkloadType MSSQL -VaultId $vault.ID -UseSecondaryRegion
$secondaryItems | Format-Table Name, FriendlyName
$secondaryItem = $secondaryItems | Where-Object { $_.Name -eq "<backup-item-name>" }
$secondaryPoint = Get-AzRecoveryServicesBackupRecoveryPoint -Item $secondaryItem `
-RecoveryPointId "<recovery-point-id>" -UseSecondaryRegion -VaultId $vault.ID
Get-AzRecoveryServicesBackupRecoveryLogChain -Item $secondaryItem `
-UseSecondaryRegion -VaultId $vault.ID
$pairedVault = Get-AzRecoveryServicesVault -ResourceGroupName "<paired-vault-rg>" -Name "<paired-vault-name>"
$secondaryContainer = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer `
-FriendlyName "<secondary-vm>" -Status Registered -VaultId $pairedVault.ID
$secondaryInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL `
-ItemType SQLInstance -Container $secondaryContainer -VaultId $pairedVault.ID
$secondaryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $secondaryPoint -AlternateWorkloadRestore `
-TargetItem $secondaryInstance -TargetContainer $secondaryContainer -UseSecondaryRegion -VaultId $vault.ID
Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $secondaryConfig `
-RestoreToSecondaryRegion -VaultId $vault.ID
Selecione um item de origem único e uma instância de destino a partir dos objetos devolvidos. Para PITR de logs, construa a configuração com -PointInTime e -Item $secondaryItem em vez de -RecoveryPoint. Consulte os requisitos de restauro entre regiões antes de prosseguir. Este exemplo abrange backups de bases de dados em streaming, não a configuração de snapshots entre regiões.