Construire un groupe de basculement Azure SQL avec PowerShell et az CLI
Création du groupe, ajout de bases dans des pools élastiques, suivi du seeding, chaînes de connexion sur le listener, logins, SID et authentification Entra côté secondaire.
Créer un groupe de basculement depuis le portail marche pour un essai, pas pour un parc. Je scripte toujours la création : c'est reproductible, relisible et on peut la rejouer à l'identique pour chaque nouveau groupe. Voici ma séquence, avec des noms génériques (rg-dba-prd, sql-contoso-prd-a, sql-contoso-prd-b, pool-elp-01, AppDb).
flowchart TD
A["1. Pool secondaire créé et dimensionné"] --> B["2. Création du groupe"]
B --> C["3. Ajout des bases"]
C --> D["4. Suivi du seeding"]
D --> E["5. Logins et utilisateurs côté secondaire"]
E --> F["6. Chaînes de connexion vers le listener"]
1. Le pool secondaire d'abord
Si les bases sont dans un pool élastique, le secondaire est créé dans un pool de même nom sur le serveur partenaire. Il doit exister et avoir assez de capacité libre avant l'ajout. Je le crée avec la même édition, la même génération et le même nombre de vCores que le primaire.
New-AzSqlElasticPool -ResourceGroupName rg-dba-prd -ServerName sql-contoso-prd-b `
-ElasticPoolName pool-elp-01 -Edition GeneralPurpose -ComputeGeneration Gen5 -VCore 4
2. Créer le groupe
New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg-dba-prd -ServerName sql-contoso-prd-a `
-PartnerResourceGroupName rg-dba-prd -PartnerServerName sql-contoso-prd-b `
-FailoverGroupName fog-contoso-app-01 -FailoverPolicy Manual
Équivalent az CLI (la période de grâce est en heures, utile seulement en politique automatique) :
az sql failover-group create --name fog-contoso-app-01 --resource-group rg-dba-prd \
--server sql-contoso-prd-a --partner-server sql-contoso-prd-b \
--partner-resource-group rg-dba-prd --failover-policy Manual
Un groupe neuf ne contient aucune base. Le nom doit être unique dans database.windows.net.
3. Ajouter les bases
$dbs = Get-AzSqlDatabase -ResourceGroupName rg-dba-prd -ServerName sql-contoso-prd-a |
Where-Object DatabaseName -in 'AppDb'
Add-AzSqlDatabaseToFailoverGroup -ResourceGroupName rg-dba-prd -ServerName sql-contoso-prd-a `
-FailoverGroupName fog-contoso-app-01 -Database $dbs
az sql failover-group update --name fog-contoso-app-01 --resource-group rg-dba-prd \
--server sql-contoso-prd-a --add-db AppDb
Avant d'ajouter, deux vérifications : le serveur secondaire ne doit pas déjà contenir une base du même nom (sauf s'il s'agit déjà de son secondaire, dont le lien est alors hérité), et le pool secondaire doit avoir de la place.
4. Suivre le seeding
Le seeding initial copie toute la base : c'est la phase longue. Je consulte l'état du groupe et, base par base, le DMV côté primaire.
Get-AzSqlDatabaseFailoverGroup -ResourceGroupName rg-dba-prd -ServerName sql-contoso-prd-a `
-FailoverGroupName fog-contoso-app-01 |
Select-Object FailoverGroupName, ReplicationRole, ReplicationState, DatabaseNames
SELECT partner_server, partner_database, replication_state_desc, replication_lag_sec
FROM sys.dm_geo_replication_link_status;
SEEDING puis CATCH_UP : tant que ce n'est pas terminé, le secondaire n'est pas connectable et je ne planifie pas de drill.
5. Logins et utilisateurs côté secondaire
Le groupe réplique les bases, pas le serveur. Trois approches, de la plus simple à la plus lourde :
- Utilisateurs contenus (
CREATE USER ... WITH PASSWORD) : ils voyagent avec la base, rien à faire. - Authentification Entra :
CREATE USER [app-identity] FROM EXTERNAL PROVIDERdans la base, et un administrateur Entra défini sur les deux serveurs. C'est ma cible par défaut : pas de mot de passe, pas de SID à aligner. - Logins SQL : le login doit exister dans
masterdu secondaire avec le même SID que sur le primaire, sinon l'utilisateur de la base devient orphelin après bascule.
-- Sur le primaire
SELECT name, sid FROM sys.sql_logins WHERE name = 'app_user';
-- Sur le secondaire (master)
CREATE LOGIN app_user WITH PASSWORD = '<secret>', SID = 0x0123456789ABCDEF0123456789ABCDEF;
Pense aussi aux règles de pare-feu : celles du niveau base sont répliquées, celles du niveau serveur sont à recréer sur le partenaire.
6. Chaînes de connexion
Écriture : Server=tcp:fog-contoso-app-01.database.windows.net,1433;Database=AppDb;...
Lecture : Server=tcp:fog-contoso-app-01.secondary.database.windows.net,1433;Database=AppDb;ApplicationIntent=ReadOnly;...
Retour d'expérience
- Un script d'ajout doit échouer bruyamment si le pool secondaire est absent ou plein : c'est le piège numéro un.
- Je teste une connexion applicative sur le listener et sur le secondaire avant de déclarer le groupe prêt.
- Les logins SQL restants sont une dette : je les migre vers Entra ou des utilisateurs contenus.