LLI Wiki — My Digital Knowledge Base

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

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

Mastodon LLIMastodon SocialFosstodon