使用 Azure PowerShell 将 SQL Server 数据库迁移到 Azure SQL 数据库

项目
11/13/2023

在本文中，我们使用 Azure PowerShell 将还原为 SQL Server 2016 或更高版本的本地实例的 Adventureworks2012 数据库迁移到 Azure SQL 数据库。可以使用 Azure PowerShell 中的 Az.DataMigration 模块，将数据库从 SQL Server 实例迁移到 Azure SQL 数据库。

在本文中，学习如何：

创建资源组。
创建 Azure 数据库迁移服务的实例。
在 Azure 数据库迁移服务实例中创建迁移项目。
运行迁移。

先决条件

若要完成这些步骤，需满足以下条件：

SQL Server 2016 或更高版本（任意版本）
启用 TCP / IP 协议，使用 SQL Server Express 安装的情况下会默认禁用该协议。遵循启用或禁用服务器网络协议一文启用 TCP/IP 协议。
配置针对数据库引擎访问的 Windows 防火墙。
Azure SQL 数据库实例。可以按照在 Azure 门户中创建 Azure SQL 数据库中的数据库一文中的详细说明来创建 Azure SQL 数据库实例。
数据迁移助手 v3.3 或更高版本。
使用 Azure 资源管理器部署模型创建一个 Azure 虚拟网络，该虚拟网络使用 ExpressRoute 或 VPN 使 Azure 数据库迁移服务与本地源服务器建立站点到站点连接。
已使用执行 SQL Server 迁移评估一文中所述的数据迁移助手完成对本地数据库和架构迁移的评估
使用 Install-Module PowerShell cmdlet 从 PowerShell 库下载并安装 Az.DataMigration 模块；请务必使用“以管理员身份运行”来打开 PowerShell 命令窗口。
确保用于连接到源 SQL Server 实例的凭据具有 CONTROL SERVER 权限。
确保用于连接到目标 Azure SQL DB 实例的凭据具有目标 Azure SQL 数据库的 CONTROL DATABASE 权限。
Azure 订阅。如果没有订阅，请在开始之前创建一个试用帐户。

登录到 Azure 订阅

根据使用 Azure PowerShell 登录一文中的说明，使用 PowerShell 登录到 Azure 订阅。

创建资源组

Azure 资源组是在其中部署和管理 Azure 资源的逻辑容器。请先创建资源组，然后才能创建虚拟机。

使用 New-AzResourceGroup 命令创建资源组。

以下示例在“中国东部 2”区域创建名为“myResourceGroup” 的资源组。

New-AzResourceGroup -ResourceGroupName myResourceGroup -Location ChinaEast2

创建 Azure 数据库迁移服务的实例

可以通过 New-AzDataMigrationService cmdlet 创建 Azure 数据库迁移服务的新实例。此 cmdlet 需要以下必需参数：

Azure 资源组名称。可以使用 New-AzResourceGroup 命令创建前述 Azure 资源组，并提供其名称作为参数。
服务名称。与 Azure 数据库迁移服务的所需唯一服务名称相对应的字符串
位置。指定服务的位置。指定 Azure 数据中心位置，例如“中国东部 2”
Sku。此参数对应于 DMS Sku 名称。当前支持的 Sku 名称是 GeneralPurpose_4vCores。
虚拟子网标识符。可以使用 cmdlet New-AzVirtualNetworkSubnetConfig 创建子网。

以下示例使用名为 MyVNET 的虚拟网络和名为 MySubnet 的子网，在位于“中国东部 2”区域的资源组 MyDMSResourceGroup 中创建名为 MyDMS 的服务。

 $vNet = Get-AzVirtualNetwork -ResourceGroupName MyDMSResourceGroup -Name MyVNET

$vSubNet = Get-AzVirtualNetworkSubnetConfig -VirtualNetwork $vNet -Name MySubnet

$service = New-AzDms -ResourceGroupName MyDMSResourceGroup `
  -ServiceName MyDMS `
  -Location ChinaEast2 `
  -Sku GeneralPurpose_4vCores `  
  -VirtualSubnetId $vSubNet.Id`

创建迁移项目

在创建 Azure 数据库迁移服务实例以后，创建迁移项目。 Azure 数据库迁移服务项目需要源和目标实例的连接信息，以及要在项目中迁移的数据库的列表。

创建源和目标连接的数据库连接信息对象

可以使用 New-AzDmsConnInfo cmdlet 创建数据库连接信息对象。此 cmdlet 需要以下参数：

ServerType。请求的数据库连接的类型，例如 SQL、Oracle 或 MySQL。将 SQL 用于 SQL Server 和 Azure SQL。
DataSource。 SQL Server 实例或 Azure SQL 数据库的名称或 IP。
AuthType。连接的身份验证类型，可以为 SqlAuthentication 或 WindowsAuthentication。
TrustServerCertificate 参数设置的值用于指示在绕过验证信任的证书链时，是否对通道加密。可以是 true 或 false。

以下示例使用 SQL 身份验证为名为 MySourceSQLServer 的源 SQL Server 创建连接信息对象：

$sourceConnInfo = New-AzDmsConnInfo -ServerType SQL `
  -DataSource MySourceSQLServer `
  -AuthType SqlAuthentication `
  -TrustServerCertificate:$true

注意

如果在将源 DataSource 作为 SQL Server 的公共 IP 地址或 DNS 提供时迁移最终出错，请使用运行 SQL Server 的 Azure VM 的名称。

下一示例显示如何使用 SQL 身份验证为名为 SQLAzureTarget 的服务器创建连接信息：

$targetConnInfo = New-AzDmsConnInfo -ServerType SQL `
  -DataSource "sqlazuretarget.database.chinacloudapi.cn" `
  -AuthType SqlAuthentication `
  -TrustServerCertificate:$false

为迁移项目提供数据库

创建 AzDataMigrationDatabaseInfo 对象的列表，以便指定 Azure 数据库迁移项目中的数据库（可以作为创建项目所需的参数提供）。 Cmdlet New-AzDataMigrationDatabaseInfo 可用于创建 AzDataMigrationDatabaseInfo。

以下示例为 AdventureWorks2016 数据库创建 AzDataMigrationDatabaseInfo 项目，并将其添加到列表，以便在创建项目时作为参数提供。

$dbInfo1 = New-AzDataMigrationDatabaseInfo -SourceDatabaseName AdventureWorks2016
$dbList = @($dbInfo1)

创建项目对象

最后即可使用 New-AzDataMigrationProject 并添加以前创建的源和目标连接以及要迁移的数据库的列表，在“中国东部 2”创建名为“MyDMSProject”的 Azure 数据库迁移项目。

$project = New-AzDataMigrationProject -ResourceGroupName myResourceGroup `
  -ServiceName $service.Name `
  -ProjectName MyDMSProject `
  -Location ChinaEast2 `
  -SourceType SQL `
  -TargetType SQLDB `
  -SourceConnection $sourceConnInfo `
  -TargetConnection $targetConnInfo `
  -DatabaseInfo $dbList

创建并启动迁移任务

最后，创建并启动 Azure 数据库迁移任务。除了作为先决条件为已创建的项目提供的信息，Azure 数据库迁移任务还需要源和目标的连接凭据信息，以及要迁移的数据库表的列表。

创建源和目标的凭据参数

可以将连接安全凭据作为 PSCredential 对象创建。

以下示例显示了如何为源和目标连接创建 PSCredential 对象，将密码作为字符串变量 $sourcePassword 和 $targetPassword 提供。

$secpasswd = ConvertTo-SecureString -String $sourcePassword -AsPlainText -Force
$sourceCred = New-Object System.Management.Automation.PSCredential ($sourceUserName, $secpasswd)
$secpasswd = ConvertTo-SecureString -String $targetPassword -AsPlainText -Force
$targetCred = New-Object System.Management.Automation.PSCredential ($targetUserName, $secpasswd)

创建表映射并选择用于迁移的源和目标参数

迁移所需的另一参数是映射，将要迁移的表从源映射到目标。请创建表字典，以便在源和目标表之间提供用于迁移的映射。以下示例演示了源和目标表之间的映射（针对 AdventureWorks 2016 数据库的“人力资源”架构）。

$tableMap = New-Object 'system.collections.generic.dictionary[string,string]'
$tableMap.Add("HumanResources.Department", "HumanResources.Department")
$tableMap.Add("HumanResources.Employee","HumanResources.Employee")
$tableMap.Add("HumanResources.EmployeeDepartmentHistory","HumanResources.EmployeeDepartmentHistory")
$tableMap.Add("HumanResources.EmployeePayHistory","HumanResources.EmployeePayHistory")
$tableMap.Add("HumanResources.JobCandidate","HumanResources.JobCandidate")
$tableMap.Add("HumanResources.Shift","HumanResources.Shift")

下一步是使用 New-AzDmsSelectedDB cmdlet 选择源和目标数据库并提供要作为参数迁移的表映射，如以下示例所示：

$selectedDbs = New-AzDmsSelectedDB -MigrateSqlServerSqlDb -Name AdventureWorks2016 `
  -TargetDatabaseName AdventureWorks2016 `
  -TableMap $tableMap

创建并启动迁移任务

使用 New-AzDataMigrationTask cmdlet 创建并启动迁移任务。此 cmdlet 需要以下参数：

TaskType。要创建的迁移任务的类型。对于从 SQL Server 到 Azure SQL 数据库的迁移类型，此项应为 MigrateSqlServerSqlDb。
ResourceGroupName。要在其中创建任务的 Azure 资源组的名称。
ServiceName。要在其中创建任务的 Azure 数据库迁移服务实例。
ProjectName。要在其中创建任务的 Azure 数据库迁移服务项目的名称。
TaskName。要创建的任务的名称。
SourceConnection。表示源 SQL Server 连接的 AzDmsConnInfo 对象。
TargetConnection。表示目标 Azure SQL 数据库连接的 AzDmsConnInfo 对象。
SourceCred。 PSCredential 对象，用于连接到源服务器。
TargetCred。 PSCredential 对象，用于连接到目标服务器。
SelectedDatabase。表示源和目标数据库映射的 AzDataMigrationSelectedDB 对象。
SchemaValidation。（可选，开关参数）迁移后，在源和目标之间执行架构信息比较。
DataIntegrityValidation。（可选，开关参数）迁移后，在源和目标之间执行基于校验和的数据完整性验证。
QueryAnalysisValidation。（可选，开关参数）迁移后，通过从源数据库检索查询并在目标中执行查询来执行快速智能的查询分析。

以下示例创建并启动名为 myDMSTask 的迁移任务：

$migTask = New-AzDataMigrationTask -TaskType MigrateSqlServerSqlDb `
  -ResourceGroupName myResourceGroup `
  -ServiceName $service.Name `
  -ProjectName $project.Name `
  -TaskName myDMSTask `
  -SourceConnection $sourceConnInfo `
  -SourceCred $sourceCred `
  -TargetConnection $targetConnInfo `
  -TargetCred $targetCred `
  -SelectedDatabase  $selectedDbs `

以下示例创建并启动与上面相同的迁移任务，但还执行所有三项验证：

$migTask = New-AzDataMigrationTask -TaskType MigrateSqlServerSqlDb `
  -ResourceGroupName myResourceGroup `
  -ServiceName $service.Name `
  -ProjectName $project.Name `
  -TaskName myDMSTask `
  -SourceConnection $sourceConnInfo `
  -SourceCred $sourceCred `
  -TargetConnection $targetConnInfo `
  -TargetCred $targetCred `
  -SelectedDatabase  $selectedDbs `
  -SchemaValidation `
  -DataIntegrityValidation `
  -QueryAnalysisValidation `

监视迁移

可以监视正在运行的迁移任务，方法是查询任务的状态属性，如以下示例所示：

if (($mytask.ProjectTask.Properties.State -eq "Running") -or ($mytask.ProjectTask.Properties.State -eq "Queued"))
{
  write-host "migration task running"
}

正在删除 DMS 实例

完成迁移后，可以删除 Azure DMS 实例：

Remove-AzDms -ResourceGroupName myResourceGroup -ServiceName MyDMS

使用 Azure PowerShell 将 SQL Server 数据库迁移到 Azure SQL 数据库

先决条件

登录到 Azure 订阅

创建资源组

创建 Azure 数据库迁移服务的实例

创建迁移项目

创建源和目标连接的数据库连接信息对象

为迁移项目提供数据库

创建项目对象

创建并启动迁移任务

创建源和目标的凭据参数

创建表映射并选择用于迁移的源和目标参数

创建并启动迁移任务

监视迁移

正在删除 DMS 实例

其他资源