使用PowerShell导出Azure SQL数据库至本地bacpac文件时遇空值错误

尝试运行以下PowerShell脚本将Azure SQL数据库导出为bacpac文件到本地文件夹：

# Load SMO Assembly
[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.SMO") | Out-Null

# Define the source database
$sourceServer = "myserver-sql-server"
$sourceDB = "mydb-sql-db"

# Define the target file
$targetFile = "c:\temp\mydb.bacpac"

# Connect to the source database
$sourceServer = New-Object Microsoft.SqlServer.Management.Smo.Server $sourceServer
$sourceDB = $sourceServer.Databases[$sourceDB]

# Export the database to the target file
$sourceDB.ExportBacpac($targetFile)

执行最后一行时出现如下错误：

无法对空值表达式调用方法。At line:2 char:1

• $sourceDB.ExportBacpac($targetFile)

+ CategoryInfo          : InvalidOperation: (:) [], RuntimeException
  + FullyQualifiedErrorId : InvokeMethodOnNull

确认变量均有值，疑问是否调用ExportBacPac时遗漏参数？

核心原因 #

$sourceDB为空的本质是SMO未能成功连接到Azure SQL Server并获取数据库对象，而非ExportBacpac方法参数遗漏。原脚本存在两个关键问题：

1. Azure SQL Server需要使用完整的FQDN（格式为<server-name>.database.windows.net），原脚本中的myserver-sql-server是不完整的服务器地址，导致连接失败。
2. 连接Azure SQL必须显式提供身份验证凭据，原脚本未传入任何认证信息，SMO无法完成身份校验，因此无法获取数据库列表，最终$sourceServer.Databases[$sourceDB]返回null。

修正后的脚本 #

推荐使用官方维护的SqlServer模块（替代过时的LoadWithPartialName方式），并补充完整的服务器地址与认证信息：

# 安装SqlServer模块（首次运行需执行，若已安装可跳过）
# Install-Module -Name SqlServer -Force -AllowClobber

# 导入SqlServer模块
Import-Module SqlServer

# 定义Azure SQL连接信息
$serverFqdn = "myserver-sql-server.database.windows.net" # 完整的服务器FQDN
$databaseName = "mydb-sql-db"
$adminUsername = "your-sql-admin-username"
$adminPassword = ConvertTo-SecureString "your-sql-admin-password" -AsPlainText -Force
$sqlCredential = New-Object System.Data.SqlClient.SqlCredential($adminUsername, $adminPassword)

# 定义本地目标文件路径
$targetBacpacPath = "c:\temp\mydb.bacpac"

# 确保目标文件夹存在
if (-not (Test-Path (Split-Path $targetBacpacPath))) {
    New-Item -ItemType Directory -Path (Split-Path $targetBacpacPath) | Out-Null
}

# 连接到Azure SQL Server
$smoServer = New-Object Microsoft.SqlServer.Management.Smo.Server($serverFqdn)
$smoServer.ConnectionContext.Credential = $sqlCredential

# 获取数据库对象并校验
$targetDatabase = $smoServer.Databases[$databaseName]
if ($null -eq $targetDatabase) {
    throw "无法定位目标数据库，请检查服务器地址、数据库名称是否正确，或凭据是否有访问权限"
}

# 执行导出
$targetDatabase.ExportBacpac($targetBacpacPath)
Write-Host "Bacpac导出完成，路径：$targetBacpacPath"

关键注意事项 #

• 若使用Azure AD认证，可将SqlCredential替换为Azure AD身份验证方式，例如设置$smoServer.ConnectionContext.Authentication = "ActiveDirectoryPassword"并传入对应凭据。
• 确保执行脚本的账号有Azure SQL数据库的导出权限（至少需要db_backupoperator角色权限）。
• 本地目标文件夹需有写入权限，脚本中已添加自动创建文件夹的逻辑。

内容的提问来源于stack exchange，提问作者Fandango68