SQL Server : failover manuel d'un groupe de disponibilité avec Set-AGClusterFailover
Fonctionnement et usage de la fonction PowerShell Set-AGClusterFailover (failover synchrone, forcé et DR d'un groupe Always On).
Mémo sur la fonction PowerShell Set-AGClusterFailover, écrite par Martin Pugh (2014), qui déclenche un failover manuel d'un groupe de disponibilité Always On vers un nœud donné. Le code n'est pas reproduit ici ; voici son fonctionnement et son usage. Elle s'appuie sur le module SQL Server (provider SQLSERVER:\), sur le module FailoverClusters et sur une fonction d'aide New-AGSession (non fournie dans la note) qui ouvre une session PowerShell distante vers le nœud.
Syntaxe
Import-Module \\fileserver\scripts\functions\SQL.Automation.psm1 -Force
# failover vers un nœud synchrone (sans effet si ce nœud est déjà primaire)
Set-AGClusterFailover -ComputerName sqlnode01
# failover vers un nœud asynchrone (perte de données possible)
Set-AGClusterFailover -ComputerName sqlnode02 -Force
# DR : quorum perdu, forcer le quorum sur le nœud asynchrone
Set-AGClusterFailover -ComputerName sqlnode02 -Force -ForceDR
| Paramètre | Rôle |
|---|---|
-ComputerName |
Nœud du cluster vers lequel basculer |
-Force |
Obligatoire pour un nœud asynchrone ou un nœud synchrone non synchronisé ; confirme que la perte de données est acceptée |
-ForceDR |
Avec -Force, uniquement en reprise après sinistre avec perte du quorum |
Fonctionnement
- Ouvre une session distante sur le nœud cible et liste ses groupes de disponibilité.
- Si le nœud est déjà primaire pour un groupe, rien n'est fait pour ce groupe.
- Si le nœud est en
SynchronousCommitetSynchronized, appelleSwitch-SqlAvailabilityGroupsans perte de données. - Si le nœud est synchrone mais pas synchronisé, ou asynchrone, la bascule n'a lieu qu'avec
-Forceet après confirmation interactive (Read-Host) ; elle utiliseSwitch-SqlAvailabilityGroup -AllowDataLoss -Force. - Avec
-Force -ForceDR(nœud asynchrone) : après confirmation, arrête le nœud dans le cluster (Stop-ClusterNode), le redémarre avecStart-ClusterNode -FixQuorum, donne un poids de vote de 1 à ce nœud et 0 aux autres, puis bascule avec perte de données autorisée. - Après chaque bascule, reprend la réplication sur les autres réplicas avec
Resume-SqlAvailabilityDatabasepour chaque base du groupe.
Remarques
-Forceet-ForceDRne doivent jamais servir en exploitation normale : risque de perte de données et modification du quorum.- Sans script, l'équivalent natif est la cmdlet
Switch-SqlAvailabilityGroup(avec-AllowDataLosspour un failover forcé). - Le code original est de Martin Pugh : pour l'obtenir, chercher « Set-AGClusterFailover » avec son nom, et respecter sa licence.