使用 PowerShell 和 Azure 数据库迁移服务将 SQL Server 脱机迁移到 SQL 托管实例

在本文中,我们将使用 Azure PowerShell 将还原为 SQL Server 2005 或更高版本的本地实例的 Adventureworks2016 数据库脱机迁移到 Azure SQL 托管实例。 可以使用 Azure PowerShell 中的 Az.DataMigration 模块,将数据库从 SQL Server 实例迁移到 SQL 托管实例。

在本文中,学习如何:

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

提示

在 Azure 数据库迁移服务中,可以脱机或联机迁移数据库。 使用脱机迁移时,应用程序停机时间从迁移开始时算起。 若要将停机时间限制为迁移后直接转换到新环境所需的时间,请使用联机迁移。 建议测试脱机迁移,以确定停机时间是否可接受。 如果无法接受预期的停机时间,请进行联机迁移。

本文提供脱机迁移的步骤,但也可以进行联机迁移。

先决条件

若要完成这些步骤,需满足以下条件:

登录到 Azure 订阅

使用 PowerShell 登录到 Azure 订阅。 有关详细信息,请参阅使用 Azure PowerShell 登录一文。

创建资源组

Azure 资源组是在其中部署和管理 Azure 资源的逻辑容器。

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

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

New-AzResourceGroup -ResourceGroupName myResourceGroup -Location ChinaEast2

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

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

  • Azure 资源组名称。 可以使用 New-AzResourceGroup 命令创建前述 Azure 资源组,并提供其名称作为参数。
  • 服务名称。 与 Azure 数据库迁移服务的所需唯一服务名称相对应的字符串。
  • 位置。 指定服务的位置。 指定 Azure 数据中心位置,例如“ChinaEast 2”。
  • Sku。 此参数对应于 DMS Sku 名称。 目前支持的 SKU 名称为 Basic_1vCoreBasic_2vCoresGeneralPurpose_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 myResourceGroup `
  -ServiceName MyDMS `
  -Location ChinaEast2 `
  -Sku Basic_2vCores `
  -VirtualSubnetId $vSubNet.Id`

创建迁移项目

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

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

可以使用 New-AzDmsConnInfo 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

以下示例演示如何为名为“targetmanagedinstance”的 Azure SQL 托管实例创建连接信息:

$targetResourceId = (Get-AzSqlInstance -Name "targetmanagedinstance").Id
$targetConnInfo = New-AzDmsConnInfo -ServerType SQLMI -MiResourceId $targetResourceId

为迁移项目提供数据库

创建 AzDataMigrationDatabaseInfo 对象的列表,以便指定 Azure 数据库迁移服务项目中的数据库(可以作为创建项目所需的参数提供)。 可以使用 cmdlet New-AzDataMigrationDatabaseInfo 创建 AzDataMigrationDatabaseInfo

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

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

创建项目对象

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

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

创建并启动迁移任务

接下来,创建并启动 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)

创建备份 FileShare 对象

现在,使用 New-AzDmsFileShare cmdlet 创建 FileShare 对象,用于 Azure 数据库迁移服务可将源数据库备份迁移到的本地 SMB 网络共享。

$backupPassword = ConvertTo-SecureString -String $password -AsPlainText -Force
$backupCred = New-Object System.Management.Automation.PSCredential ($backupUserName, $backupPassword)

$backupFileSharePath="\\10.0.0.76\SharedBackup"
$backupFileShare = New-AzDmsFileShare -Path $backupFileSharePath -Credential $backupCred

创建选定的数据库对象

下一步是使用 New-AzDmsSelectedDB cmdlet 选择源和目标数据库。

以下示例用于将 SQL Server 中的单一数据库迁移到 Azure SQL 托管实例:

$selectedDbs = @()
$selectedDbs += New-AzDmsSelectedDB -MigrateSqlServerSqlDbMi `
  -Name AdventureWorks2016 `
  -TargetDatabaseName AdventureWorks2016 `
  -BackupFileShare $backupFileShare `

如果整个 SQL Server 实例需要直接迁移到 Azure SQL 托管实例,可以使用下面提供的从源提取所有数据库的循环。 在以下示例中,请为 $Server、$SourceUserName 和 $SourcePassword 提供源 SQL Server 详细信息。

$Query = "(select name as Database_Name from master.sys.databases where Database_id>4)";
$Databases= (Invoke-Sqlcmd -ServerInstance "$Server" -Username $SourceUserName
-Password $SourcePassword -database master -Query $Query)
$selectedDbs=@()
foreach($DataBase in $Databases.Database_Name)
    {
      $SourceDB=$DataBase
      $TargetDB=$DataBase

$selectedDbs += New-AzureRmDmsSelectedDB -MigrateSqlServerSqlDbMi `
                                              -Name $SourceDB `
                                              -TargetDatabaseName $TargetDB `
                                              -BackupFileShare $backupFileShare
      }

Azure 存储容器的 SAS URI

创建包含 SAS URI 的变量,使 Azure 数据库迁移服务能够访问它要将备份文件上传到的存储帐户容器。

$blobSasUri="https://mystorage.blob.core.chinacloudapi.cn/test?st=2018-07-13T18%3A10%3A33Z&se=2019-07-14T18%3A10%3A00Z&sp=rwdl&sv=2018-03-28&sr=c&sig=qKlSA512EVtest3xYjvUg139tYSDrasbftY%3D"

注意

Azure 数据库迁移服务不支持使用帐户级别 SAS 令牌。 必须使用存储帐户容器的 SAS URI。 了解如何获取 Blob 容器的 SAS URI

其他配置要求

还需要满足一些其他要求:

  • 选择登录名。 按以下示例中所示,创建要迁移的登录名列表:

    $selectedLogins = @("user1", "user2")
    

    重要

    目前,Azure 数据库迁移服务仅支持迁移 SQL 登录名。

  • 选择代理作业。 按以下示例中所示,创建要迁移的代理作业列表:

    $selectedAgentJobs = @("agentJob1", "agentJob2")
    

    重要

    目前,Azure 数据库迁移服务仅支持包含 T-SQL 子系统作业步骤的作业。

创建并启动迁移任务

使用 New-AzDataMigrationTask cmdlet 创建并启动迁移任务。

指定参数

New-AzDataMigrationTask cmdlet 需要以下参数:

  • TaskType。 要创建的迁移任务的类型。对于从 SQL Server 到 Azure SQL 托管实例的迁移类型,此项应为“MigrateSqlServerSqlDbMi”
  • ResourceGroupName。 要在其中创建任务的 Azure 资源组的名称。
  • ServiceName。 要在其中创建任务的 Azure 数据库迁移服务实例。
  • ProjectName。 要在其中创建任务的 Azure 数据库迁移服务项目的名称。
  • TaskName。 要创建的任务的名称。
  • SourceConnection。 表示源 SQL Server 连接的 AzDmsConnInfo 对象。
  • TargetConnection。 AzDmsConnInfo 对象,表示目标 Azure SQL 托管实例连接。
  • SourceCred。 PSCredential 对象,用于连接到源服务器。
  • TargetCred。 PSCredential 对象,用于连接到目标服务器。
  • SelectedDatabase。 表示源和目标数据库映射的 AzDataMigrationSelectedDB 对象。
  • BackupFileShare。 表示 Azure 数据库迁移服务可在其上创建源数据库备份的本地网络共享的 FileShare 对象。
  • BackupBlobSasUri。 为 Azure 数据库迁移服务提供存储帐户容器访问权限的 SAS URI,该服务将备份文件上传到该容器。 了解如何获取 Blob 容器的 SAS URI。
  • SelectedLogins。 要迁移的选定登录名列表。
  • SelectedAgentJobs。 要迁移的选定代理作业列表。
  • SelectedLogins。 要迁移的选定登录名列表。
  • SelectedAgentJobs。 要迁移的选定代理作业列表。

创建并启动迁移任务

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

$migTask = New-AzDataMigrationTask -TaskType MigrateSqlServerSqlDbMi `
  -ResourceGroupName myResourceGroup `
  -ServiceName $service.Name `
  -ProjectName $project.Name `
  -TaskName myDMSTask `
  -SourceConnection $sourceConnInfo `
  -SourceCred $sourceCred `
  -TargetConnection $targetConnInfo `
  -TargetCred $targetCred `
  -SelectedDatabase  $selectedDbs `
  -BackupFileShare $backupFileShare `
  -BackupBlobSasUri $blobSasUri `
  -SelectedLogins $selectedLogins `
  -SelectedAgentJobs $selectedJobs `

监视迁移

若要监视迁移,请执行以下任务。

  1. 将所有迁移详细信息合并到名为 $CheckTask 的变量中。

    若要合并迁移详细信息(例如,与迁移相关的属性、状态和数据库信息),请使用以下代码片段:

    $CheckTask = Get-AzDataMigrationTask -ResourceGroupName myResourceGroup `
                                         -ServiceName $service.Name `
                                         -ProjectName $project.Name `
                                         -Name myDMSTask `
                                         -ResultType DatabaseLevelOutput `
                                         -Expand
    Write-Host '$CheckTask.ProjectTask.Properties.Output'
    
  2. 使用 $CheckTask 变量获取迁移任务的当前状态。

    可以使用 $CheckTask 变量获取迁移任务的当前状态,并可以通过查询任务的状态属性来监视正在运行的迁移任务,如以下示例所示:

    if (($CheckTask.ProjectTask.Properties.State -eq "Running") -or ($CheckTask.ProjectTask.Properties.State -eq "Queued"))
    {
      Write-Host "migration task running"
    }
    else if($CheckTask.ProjectTask.Properties.State -eq "Succeeded")
    {
      Write-Host "Migration task is completed Successfully"
    }
    else if($CheckTask.ProjectTask.Properties.State -eq "Failed" -or $CheckTask.ProjectTask.Properties.State -eq "FailedInputValidation" -or $CheckTask.ProjectTask.Properties.State -eq "Faulted")
    {
      Write-Host "Migration Task Failed"
    }
    

删除 Azure 数据库迁移服务的实例

完成迁移后,可以删除 Azure 数据库迁移服务实例:

Remove-AzDms -ResourceGroupName myResourceGroup -ServiceName MyDMS

后续步骤

什么是 Azure 数据库迁移服务?一文中详细了解 Azure 数据库迁移服务。