Tester l'accès Azure SQL avec une identité managée en PowerShell
Séquence de test Az PowerShell avec une identité managée pour diagnostiquer un job Azure Batch, et vérification de syntaxe d'un script.
Lorsqu'un script d'automatisation Azure (par exemple un export ou une copie de base exécuté sur Azure Batch) fonctionne depuis une machine et échoue depuis une autre, il est utile de tester pas à pas les mêmes appels Az PowerShell avec l'identité managée utilisée par le job. Cet article présente une séquence de test minimale et une vérification rapide de la syntaxe du script.
Vérifier la syntaxe du script sans l'exécuter
Parser.ParseFile signale les erreurs de syntaxe avec la ligne et la colonne, sans rien exécuter :
$errs = $null
[void][System.Management.Automation.Language.Parser]::ParseFile(
"C:\scripts\New-BatchJobs.ps1",
[ref]$null,
[ref]$errs
)
if ($errs) {
$errs | ForEach-Object {
"{0}:{1} {2}" -f $_.Extent.StartLineNumber, $_.Extent.StartColumnNumber, $_.Message
}
} else {
"OK"
}
Tester avec l'identité managée affectée à l'utilisateur
À exécuter sur la machine qui lancera le job (nœud Azure Batch, hôte Azure Virtual Desktop, VM). Connect-AzAccount -Identity ne fonctionne que si l'identité est réellement affectée à la ressource de calcul ; il échoue sur un poste hors d'Azure, où l'on s'authentifie plutôt de façon interactive avec Connect-AzAccount.
# Connexion avec l'identité managée affectée à l'utilisateur (client ID de l'identité)
Connect-AzAccount -Identity -AccountId "00000000-0000-0000-0000-000000000000"
# Sélectionner l'abonnement qui contient le serveur SQL
Set-AzContext -SubscriptionName "Production Subscription"
Get-AzContext
# Lister les serveurs SQL du groupe de ressources
Get-AzSqlServer -ResourceGroupName "rg-example" | Format-Table ServerName
Vérifier ensuite que l'identité peut lire le serveur et ses pools élastiques :
$server = Get-AzSqlServer -ResourceGroupName "rg-example" -ServerName "sqlsrv-example-01"
Get-AzSqlElasticPool -ServerName $server.ServerName -ResourceGroupName $server.ResourceGroupName |
Format-Table ServerName, ElasticPoolName
Répétez la séquence pour chaque abonnement que le job doit atteindre (production, préproduction, ...) et depuis chaque endroit où le job peut s'exécuter. Comparez les combinaisons qui réussissent et celles qui échouent : un échec sur un hôte ou dans un abonnement alors que les autres fonctionnent indique une différence d'affectation de l'identité sur cet hôte ou d'attributions de rôles sur l'abonnement ou le groupe de ressources. Vérifiez d'abord ces deux points.
Copier une base dans un pool élastique
La copie d'une base Azure SQL vers un pool élastique du même serveur se fait avec New-AzSqlDatabaseCopy. Le journal d'un tel job passe en général par ces étapes : résolution du serveur source, recherche de la base source, vérification du serveur et du pool élastique de destination, puis démarrage de la copie. La copie est asynchrone : un message « copie initiée » ne signifie pas qu'elle est terminée.
New-AzSqlDatabaseCopy -ResourceGroupName "rg-example" -ServerName "sqlsrv-example-01" `
-DatabaseName "AppDb" `
-CopyDatabaseName "AppDb-copy" `
-ElasticPoolName "elasticpool-example-01"
Voir la référence de New-AzSqlDatabaseCopy pour tous les paramètres.
Remarques
- Les noms d'abonnements, groupes de ressources, serveurs, pools et identifiants d'identité sont des exemples génériques ; le GUID composé de zéros représente le client ID de l'identité.
- Les scripts de job des notes d'origine sont propres à un environnement et ne sont pas reproduits.