Importer et exporter un BACPAC Azure SQL avec SqlPackage (méthodes d'authentification)
Commandes SqlPackage pour exporter et importer un BACPAC Azure SQL ou Managed Instance : connexion interactive, jeton d'accès, identité managée.
SqlPackage exporte une base Azure SQL ou Azure SQL Managed Instance vers un fichier .bacpac et importe un .bacpac sur un serveur cible. Cet article liste les méthodes d'authentification utilisables en ligne de commande, de la plus simple à la plus adaptée aux exécutions non interactives.
Prérequis
- SqlPackage, soit l'installation DacFx (
C:\Program Files\Microsoft SQL Server\160\DAC\bin\SqlPackage.exe), soit l'outil .NET (dotnet tool install -g microsoft.sqlpackage, installé sous%USERPROFILE%\.dotnet\tools\sqlpackage.exe). L'outil .NET est la version recommandée par Microsoft. - Vérifier la version installée avec
SqlPackage /Version. - Une identité Microsoft Entra (utilisateur ou identité managée) pouvant se connecter à la cible et disposant des droits requis sur la base.
Importer un BACPAC
Connexion interactive (universal authentication)
sqlpackage /Action:Import `
/SourceFile:"C:\backup\AppDb.bacpac" `
/TargetServerName:"sqlserver01.database.windows.net" `
/TargetDatabaseName:"AppDb_check" `
/UniversalAuthentication:True `
/DiagnosticsFile:"C:\backup\import-check.log" `
/DiagnosticsLevel:Verbose
Avec une chaîne de connexion, et éventuellement un tenant explicite :
sqlpackage /Action:Import /SourceFile:"C:\backup\AppDb.bacpac" /UniversalAuthentication:True /TenantId:"<TENANT-ID>" /TargetConnectionString:"Server=tcp:sqlserver01.database.windows.net,1433;Initial Catalog=AppDb_test;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30"
Sans /TenantId, la commande est identique, il suffit de retirer le paramètre.
Jeton d'accès via Az PowerShell
$tok = (Get-AzAccessToken -ResourceUrl 'https://database.windows.net/').Token
$token = if ($tok -is [securestring]) { ConvertFrom-SecureString $tok -AsPlainText } else { $tok }
& "$env:USERPROFILE\.dotnet\tools\sqlpackage.exe" `
/Action:Import `
/SourceFile:'C:\backup\AppDb.bacpac' `
/AccessToken:$token `
/TargetConnectionString:'Server=tcp:sqlserver01.database.windows.net,1433;Initial Catalog=AppDb_test;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30'
Selon la version du module Az, .Token est une chaîne ou un SecureString, d'où le test. Le même appel fonctionne avec l'exécutable DacFx, avec les formes courtes /a:, /sf: et /tcs:.
Jeton d'accès via Azure CLI
az account get-access-token --resource https://database.windows.net/ --query accessToken -o tsv
Passer le résultat à /AccessToken:. Pour un export :
sqlpackage /Action:Export /SourceServerName:"sqlserver01.database.windows.net" /SourceDatabaseName:"AppDb" /AccessToken:"<TOKEN>" /TargetFile:"C:\temp\AppDb.bacpac"
Mots-clés d'authentification dans la chaîne de connexion
Après az login, la chaîne d'identifiants par défaut est utilisée :
& 'C:\Program Files\Microsoft SQL Server\160\DAC\bin\SqlPackage.exe' `
/Action:Import `
/SourceFile:'C:\backup\AppDb.bacpac' `
/TargetConnectionString:'Server=tcp:sqlserver01.database.windows.net,1433;Initial Catalog=AppDb_test;Authentication=Active Directory Default;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30'
Connexion interactive avec un utilisateur donné :
Authentication=Active Directory Interactive;User Id=user@example.com;
Identité managée affectée à l'utilisateur (idéal en non interactif)
Sur une VM Azure ou un hôte Azure Virtual Desktop disposant d'une identité managée affectée à l'utilisateur :
$uami = '00000000-0000-0000-0000-000000000000' # client ID de l'identité managée
& 'C:\Program Files\Microsoft SQL Server\160\DAC\bin\SqlPackage.exe' `
/Action:Import `
/SourceFile:'C:\backup\AppDb.bacpac' `
/TargetConnectionString:"Server=tcp:sqlserver01.database.windows.net,1433;Initial Catalog=AppDb_test;Authentication=Active Directory Managed Identity;User ID=$uami;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30"
On peut aussi demander soi-même le jeton à l'Instance Metadata Service et le passer avec /at: :
$AppID = "https://database.windows.net"
$UamiID = "00000000-0000-0000-0000-000000000000"
$metadataUri = "http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=$AppID&object_id=$UamiID"
$request = Invoke-RestMethod -Uri $metadataUri -Headers @{Metadata = "true"}
$AccessToken = $request.access_token
& "C:\Program Files\Microsoft SQL Server\160\DAC\bin\sqlpackage.exe" /at:"$AccessToken" /Action:Import /sf:"C:\backup\AppDb.bacpac" /TargetConnectionString:"Server=sqlserver01.database.windows.net;Initial Catalog=AppDb_test;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
Ne jamais afficher ni journaliser le jeton.
Exporter un BACPAC
sqlpackage /Action:Export `
/SourceConnectionString:"Server=tcp:sqlserver01.database.windows.net,1433;Initial Catalog=AppDb;Authentication=Active Directory Interactive;Encrypt=True;" `
/TargetFile:"C:\temp\AppDb.bacpac"
Avec un jeton obtenu auprès de l'Instance Metadata Service (voir plus haut) :
& "C:\Program Files\Microsoft SQL Server\160\DAC\bin\sqlpackage.exe" /at:"$AccessToken" /Action:Export /SourceConnectionString:"Server=sqlserver01.database.windows.net;Initial Catalog=AppDb;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;" /tf:"C:\temp\AppDb.bacpac"
Azure SQL Managed Instance
La syntaxe est la même, avec le nom de l'instance managée comme serveur :
"C:\Program Files\Microsoft SQL Server\160\DAC\bin\sqlpackage.exe" /Action:Export /TargetFile:"C:\temp\AppDb.bacpac" /SourceConnectionString:"Server=tcp:mymanagedinstance.database.windows.net,1433;Initial Catalog=AppDb;Authentication=Active Directory Managed Identity;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
"C:\Program Files\Microsoft SQL Server\160\DAC\bin\sqlpackage.exe" /Action:Export /TargetFile:"C:\temp\AppDb.bacpac" /UniversalAuthentication:True /SourceConnectionString:"Server=mymanagedinstance.database.windows.net;Initial Catalog=AppDb;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
Déboguer un import avec un model.xml externe
Pour diagnostiquer un échec d'import, extraire model.xml du BACPAC (un BACPAC est une archive ZIP) et le fournir à SqlPackage, avec un fichier de diagnostic :
& 'C:\Program Files\Microsoft SQL Server\160\DAC\bin\SqlPackage.exe' `
/Action:Import `
/SourceFile:'C:\backup\AppDb.bacpac' `
/TargetConnectionString:"Server=tcp:sqlserver01.database.windows.net,1433;Initial Catalog=AppDb_test;Authentication=Active Directory Managed Identity;User ID=$uami;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30" `
/DiagnosticsFile:'C:\backup\log\sqlpackagediag.log' `
/ModelFilePath:'C:\backup\AppDb\model.xml'
Remarques
- Préférer une identité managée ou un jeton à un mot de passe stocké ; ne jamais coder un jeton en dur dans un script.
Encrypt=True;TrustServerCertificate=Falseest le réglage attendu pour les points de terminaison Azure SQL.- Référence : documentation SqlPackage.