Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article explique comment restaurer des sauvegardes de bases de données en streaming et des sauvegardes instantanées d’instances SQL avec Azure PowerShell. Vous pouvez restaurer un point de récupération ou utiliser des journaux de transactions pour la récupération à un moment donné (PITR).
Prerequisites
- Installez le dernier module Azure PowerShell, y compris Az.RecoveryServices. La restauration SQL en streaming nécessite Az 6.0.0 ou une version ultérieure. Les exemples d’instantanés nécessitent une version de module qui expose les paramètres d’instantané présentés ici.
- Ayez une base de données SQL existante ou une sauvegarde d’instance. Examinez les prérequis de restauration et la matrice de support des instantanés.
- Pour les restaurations d’instantanés, préparez un groupe de ressources cible et une identité managée attribuée par l’utilisateur avec les autorisations requises. Examinez les exigences de restauration d’instantané.
- Enregistrez la VM de destination auprès du coffre approprié avant la restauration par emplacement alternatif.
- Remplacez les valeurs entre crochets d’angle. Exécutez la configuration commune pour le scénario sélectionné, puis choisissez un exemple de configuration de restauration. Les exemples de configuration ne commencent pas une restauration tant que vous n’avez pas soumis la configuration.
Connectez-vous, sélectionnez l’abonnement de coffre et récupérer le coffre :
Connect-AzAccount
Select-AzSubscription -SubscriptionId "<vault-subscription-id>"
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "<vault-rg>" -Name "<vault-name>"
Restaurez une sauvegarde de base de données en streaming
Sélectionnez la base de données et l’heure de récupération
Limitez la recherche de base de données au conteneur de la VM source :
$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
Pour PITR, interrogez les plages continues du journal avec Get-AzRecoveryServicesBackupRecoveryLogChain, puis sélectionnez une heure UTC dans l’une de ces plages :
$logRanges = Get-AzRecoveryServicesBackupRecoveryLogChain -Item $databaseItem -VaultId $vault.ID
$logRanges | Select-Object ItemName, StartTime, EndTime
$pointInTime = (Get-Date "<yyyy-MM-ddTHH:mm:ssZ>").ToUniversalTime()
Pour le PITR de diffusion, le service détermine la sauvegarde complète et la chaîne de journaux nécessaires pour la date et l’heure sélectionnées.
Restaurer à l’emplacement d’origine
Choisissez un point de récupération complet ou différentiel :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $fullRecoveryPoint -OriginalWorkloadRestore -VaultId $vault.ID
Autrement, utilisez l’instant sélectionné :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -OriginalWorkloadRestore -VaultId $vault.ID
Warning
Restaurer la base de données à son emplacement d’origine écrase la base de données originale. Vérifiez la configuration de récupération avant de la soumettre.
Restaurer à un autre emplacement
Sélectionnez le conteneur de VM de destination et l’instance 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
Pour un point de récupération complet ou différentiel :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $fullRecoveryPoint -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer -VaultId $vault.ID
Pour le PITR :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer -VaultId $vault.ID
Inspectez le nom de base de données généré et les chemins des fichiers. Changez-les selon les besoins de la destination cible :
$recoveryConfig | Format-List
$recoveryConfig.targetPhysicalPath | Format-Table
$recoveryConfig.RestoredDBName = "<restored-database-name>"
Restaurer les sauvegardes en streaming sous forme de fichiers
Pour restaurer une sauvegarde complète ou différentielle en fichiers sur la VM cible enregistrée :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $fullRecoveryPoint -TargetContainer $targetContainer `
-RestoreAsFiles -FilePath "<target-folder>" -VaultId $vault.ID
Pour le PITR de journal, demandez les fichiers de la dernière sauvegarde complète applicable :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-PointInTime $pointInTime -Item $databaseItem -TargetContainer $targetContainer `
-RestoreAsFiles -FilePath "<target-folder>" -VaultId $vault.ID
Pour utiliser une sauvegarde complète particulière pour la restauration de fichiers, ajoutez -FromFull $fullRecoveryPoint à la commande de configuration PITR.
Points de récupération d'instantanée de requête
Sélectionnez l’instance protégée
La configuration suivante sélectionne un élément d’instance et liste ses points de récupération. Utilisez cette configuration pour les scénarios de restauration d’instances plus loin dans cet article :
$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
Choisissez un ID dans la liste renvoyée. Récupérez ce point de récupération par ID pour récupérer tous les détails, plutôt que de supposer que la première entrée de la liste est l’instantané souhaité :
$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
Les plages du journal de requête supérieures à l’instantané de l’instance
Les requêtes en chaîne de journal ciblent chaque élément base de données inclus dans l’instantané. L’identifiant de la source de données de base est celui de l’instanceProtectedItemDataSourceId, et non celui de la DatasourceIdbase de données :
$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
Utilisez Get-AzRecoveryServicesBackupRecoveryLogChain pour les plages de temps.
Get-AzRecoveryServicesBackupRecoveryPoint renvoie des points de récupération individuels, et non des plages de journaux continues.
Restaurer un instantané d’instance
Utilisez l’instance et les détails $snapshotPoint depuis les points de récupération des instantanés de requête. Les configurations d’instantanés d’origine et d’emplacement alternatif nécessitent un groupe de ressources cibles et une identité gérée attribuée par l’utilisateur :
$identityId = "/subscriptions/<subscription-id>/resourceGroups/<identity-rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"
$targetResourceGroup = "<target-rg>"
Restauration de l’emplacement d’origine
Créez une configuration de restauration de la charge de travail d’origine :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $snapshotPoint -OriginalWorkloadRestore `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-VaultId $vault.ID
Restauration vers un autre emplacement
Sélectionnez le conteneur de destination et l’instance. Utilisez cette configuration de destination pour restaurer vers un emplacement alternatif, la restauration PITR de l’instance et restaurer sous forme de disques :
$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
Restauration à un moment précis
Commencez par lancer la requête de plage de journaux par base de données. Choisissez une heure de restauration UTC disponible pour chaque base de données en cours de restauration. La vérification suivante rejette un temps en dehors des plages de toute base de données :
$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
Le point de récupération de l’instantané identifie l’instantané de base ; -PointInTime spécifie la cible de relecture du journal. Cet exemple demande à -NoRecoveryMode de laisser les bases de données dans un état non récupéré pour les étapes de récupération suivantes. Examinez cette option pour votre plan de rétablissement.
Restaurer en tant que disques
Utilisez SnapshotAttach pour attacher les disques d’instantané au lieu d’effectuer l’attachement de l’instantané et la récupération de base de données :
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $snapshotPoint -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttach -VaultId $vault.ID
Configurez les chemins cibles et les collisions de disque
Inspectez targetPhysicalPath avant de soumettre toute configuration d’instantané d’instance. Les volumes sources sont listés avec des chemins cibles vides. Définir un chemin cible uniquement pour les volumes nécessitant une réassignation, par exemple lors de la résolution d’un conflit de système de fichiers :
$recoveryConfig.targetPhysicalPath | Format-Table SourcePath, TargetPath
($recoveryConfig.targetPhysicalPath | Where-Object { $_.SourcePath -eq "E:\" }).TargetPath = "X:\"
Remplacez les chemins source et cible par des chemins appropriés à votre point de récupération et à votre destination. Si un détachement de disque est nécessaire pour résoudre un conflit, identifiez explicitement les disques affectés :
$recoveryConfig.DisksToDetachOnClash = @(
"/subscriptions/<subscription-id>/resourceGroups/<disk-rg>/providers/Microsoft.Compute/disks/<disk-name>"
)
Warning
Détacher un disque existant peut perturber les charges de travail qui l’utilisent. Confirmez les identifiants de disque et la configuration du système de fichiers de destination avant de soumettre la restauration.
Restaurer une base de données protégée dans une instance
Configuration courante
Sélectionnez l’élément de sauvegarde de la base de données, le conteneur et l’instance de destination, le groupe de ressources cible et l’identité :
$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>"
Pour une restauration à un point de récupération d’instantané, listez les instantanés de la base de données et récupérez le point choisi par ID :
Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
-RestorePointQueryType Snapshot -VaultId $vault.ID
$databaseSnapshot = Get-AzRecoveryServicesBackupRecoveryPoint -Item $databaseItem `
-RecoveryPointId "<database-snapshot-recovery-point-id>" -VaultId $vault.ID
Restauration à un autre emplacement
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $databaseSnapshot -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttachAndRecover -NoRecoveryMode -VaultId $vault.ID
Restauration à un moment précis
Listez les plages de journaux disponibles de la base de données et sélectionnez une heure UTC dans une plage retournée :
$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
Les deux exemples de récupération de base de données spécifient -NoRecoveryMode. Vérifiez si votre plan de rétablissement exige que la base de données reste non récupérée.
Restaurer en tant que disques
$recoveryConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig `
-RecoveryPoint $databaseSnapshot -AlternateWorkloadRestore `
-TargetItem $targetInstance -TargetContainer $targetContainer `
-TargetResourceGroupName $targetResourceGroup -UserAssignedIdentityId $identityId `
-RecoveryMode SnapshotAttach -VaultId $vault.ID
Restaurer sous forme de disques avec les journaux sous forme de fichiers
Choisissez une date et heure parmi les plages de journaux disponibles de la base de données, comme dans l’exemple PITR de la base de données, puis configurez la destination du fichier journal :
$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
Pour n’importe laquelle de ces configurations d’instantanés de base de données, inspectez les chemins sources et définissez les mappages de volume cible requis avant de soumettre :
$recoveryConfig.targetPhysicalPath | Format-Table SourcePath, TargetPath
($recoveryConfig.targetPhysicalPath | Where-Object { $_.SourcePath -eq "E:\" }).TargetPath = "M:\"
Soumettez la récupération et suivez la tâche
Examinez la configuration sélectionnée, puis soumettez-la en utilisant Restore-AzRecoveryServicesBackupItem :
$recoveryConfig | Format-List
$restoreJob = Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $recoveryConfig -VaultId $vault.ID
$restoreJob
Utilisez l’ID de travail retourné avec les commandes de surveillance de travail.
Restauration interrégionale pour les sauvegardes de bases de données en streaming
Lorsque vous activez la restauration inter-région, utilisez -UseSecondaryRegion pour interroger les éléments répliqués, les points de récupération et les chaînes de logs. La VM cible doit être enregistrée auprès d’un coffre dans la région appariée :
$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
Sélectionnez un élément source unique et une instance cible parmi les objets retournés. Pour le log PITR, construisez la configuration avec -PointInTime et -Item $secondaryItem au lieu de -RecoveryPoint. Vérifiez les exigences de restauration interrégionale avant de procéder. Cet exemple concerne les sauvegardes de bases de données en streaming, pas la configuration interrégionale des instantanés.