使用 PowerShell 将 Azure 数据工厂管道升级到 Microsoft Fabric

小窍门

您对迁移选项不熟悉吗？从 Microsoft Fabric 迁移概述 开始，了解完整布局和 ADF 到 Fabric 迁移指南。网络结构迁移指南

可以使用 Microsoft.FabricPipelineUpgrade PowerShell 模块将 Azure 数据工厂（ADF）管道迁移到 Microsoft Fabric。本指南概述了执行迁移的所有步骤。有关包含屏幕截图、示例和故障排除的详细教程，请参阅 PowerShell 迁移教程。

若要使用 PowerShell 将 ADF 管道迁移到 Fabric，请执行以下作：

为 Fabric 管道升级准备环境。
将 PowerShell 连接到 Azure 和 Fabric 环境。
升级工厂管道。
创建解析文件并将链接服务映射到 Fabric 连接器。
验证结果。

先决条件

若要开始，必须满足以下先决条件：

租户：ADF 和 Fabric 工作区必须位于同一 Microsoft Entra ID 租户中。
Fabric：具有活动 Fabric 订阅的租户帐户 - 免费创建帐户。
构造工作区建议 （可选）：建议在 ADF 所在的同一区域中使用新的 Fabric 工作区进行升级，以获得最佳性能。
权限：读取对 ADF 工作区和项目的访问权限，你将迁移的内容需要这些权限；对于将要写入内容的工作区，则需要在 Fabric 工作区中具备参与者（或以上）权限。
网络和身份验证：确保可以从计算机（交互式或服务主体）登录到 Azure 和 Fabric。

支持的功能

除了当前支持的数据集和链接服务和当前支持的活动外，还适用以下限制：

如果某个活动在 Fabric 中不可用，则 Fabric 升级程序无法升级它。
不支持全局配置和参数。
pipeline().Pipeline 当前不受支持。

当前支持的数据集和链接服务

Blob：JSON、带分隔符的文本和二进制格式
Azure SQL 数据库
ADLS Gen2：JSON、带分隔符的文本和二进制格式
Azure 函数：函数应用 URL

当前支持的活动

CopyActivity用于支持的数据集
ExecutePipeline （转换为 Fabric InvokePipeline 活动）
IfCondition
Wait
Web
SetVariable
Azure 函数
ForEach
查找
开关
SQL Server存储过程

为 Fabric 流程升级准备环境

在开始升级管道之前，请验证环境是否具有所需的工具和模块：

PowerShell 7.4.2 （x64）或更高版本
FabricPipelineUpgrade 模块

安装 PowerShell 7.4.2 （x64）或更高版本

计算机上需要 PowerShell 7.4.2 或更高版本。

下载 PowerShell

安装和导入 FabricPipelineUpgrade 模块

打开 PowerShell 7 （x64）。
选择“开始”菜单，搜索 PowerShell 7，打开应用的上下文菜单，然后选择“ 以管理员身份运行”。

在具有提升权限的 PowerShell 窗口中，从 PowerShell Gallery 库安装模块：

Install-Module Microsoft.FabricPipelineUpgrade -Repository PSGallery -SkipPublisherCheck

将模块导入会话：

Import-Module Microsoft.FabricPipelineUpgrade

如果看到签名或执行策略错误，请运行以下命令，然后再次导入模块：
```
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
```

验证安装

运行以下命令以确认模块已正确加载：

Get-Command -Module Microsoft.FabricPipelineUpgrade

模块命令输出的屏幕截图。

将 PowerShell 连接到 Azure 和 Fabric 环境

在 PowerShell 中运行以下命令，为后续 Az cmdlet 登录并设置订阅和租户：

Add-AzAccount
Select-AzSubscription -SubscriptionId <your subscription ID>

运行以下命令以获取 ADF 和 Fabric 的访问令牌：

$adfSecureToken = (Get-AzAccessToken -ResourceUrl "https://management.azure.com/").Token
$fabricSecureToken = (Get-AzAccessToken -ResourceUrl "https://analysis.windows.net/powerbi/api").Token

小窍门

访问令牌在大约一小时后过期。发生这种情况时，请再次运行该命令。如果 Export-FabricResources 返回令牌过期错误，你将知道令牌已过期。

升级工厂资源

首先，导入 Azure 数据工厂管道，然后将 ADF 链接服务映射到 Fabric 连接，最后升级管道。

导入 Azure 数据工厂管道

以下 PowerShell 脚本将导入您的数据工厂资源。在第一次出现|之前，更新 Import-AdfFactory 命令，以便导入ADF中的所有受支持的资源或单个管道。

Import-AdfFactory -SubscriptionId <your subscription ID> -ResourceGroupName <your Resource Group Name> -FactoryName <your Factory Name> -PipelineName <your Pipeline Name> -AdfToken $adfSecureToken| ConvertTo-FabricResources | Export-FabricResources -Region <region> -Workspace <workspaceId> -Token $fabricSecureToken

小窍门

区域参数是可选的。如果 Fabric 工作区与 ADF 位于同一区域，则可以使用该区域或跳过 -Region 参数。

导入所有工厂资源

Import-AdfFactory -SubscriptionId <your subscription ID> -ResourceGroupName <your Resource Group Name> -FactoryName <your Factory Name> -AdfToken $adfSecureToken

导入单个管道

它是用来导入所有工厂资源的相同命令，但要添加参数 -PipelineName：

Import-AdfFactory -SubscriptionId <your subscription ID> -ResourceGroupName <your Resource Group Name> -FactoryName <your Factory Name> -PipelineName <your Pipeline Name> -AdfToken $adfSecureToken

将 ADF 链接服务映射到 Fabric 连接

如果 Fabric 实例尚未连接到 ADF 链接服务中使用的数据源，请在 Fabric 中创建这些连接。
创建解析文件，告知 FabricUpgrader 如何将 ADF 链接服务映射到 Fabric 连接。

创建分辨率文件

解析文件是将 ADF 链接服务映射到 Fabric 连接的 JSON 文件：

[
  {
    "type": "LinkedServiceToConnectionId",
    "key": "<ADF LinkedService Name>",
    "value": "<Fabric Connection ID>"
  }
]

type 是要执行的映射类型。这通常是 LinkedServiceToConnectionId，但在某些情况下，也可能使用其他类型的类型。
key 取决于你正在使用的 type。对于 LinkedServiceToConnectionId，key 是您想要映射的 ADF 连接服务的名称。
要映射的 Fabric 连接的 GUID 是value。可以在 Fabric 连接的设置中找到 GUID。

例如，如果有两个名为 MyAzureBlobStorage 和 MySQLServer 的 ADF 链接的服务，并希望将其映射到 Fabric 连接，那么，你的文件应如下所示：

[
  {
    "type": "LinkedServiceToConnectionId",
    "key": "MyAzureBlobStorage",
    "value": "aaaa0000-bb11-2222-33cc-444444dddddd"
  },
  {
    "type": "LinkedServiceToConnectionId",
    "key": "MySQLServer",
    "value": "bbbb1111-cc22-3333-44dd-555555eeeeee"
  }
]

使用此结构创建 Resolutions.json 文件，并将其保存在计算机上的某个位置，以便 PowerShell 可以访问该文件。

有关解析文件的详细信息，请参阅如何向解析文件添加连接。

用于升级管道的 PowerShell 命令

有了解析文件后，可以运行此 PowerShell 命令来执行升级。更新 ResolutionFilename 参数以指向分辨率文件。此外，请在第一个|之前更新 Import-AdfFactory 命令，以便导入 ADF 中支持的所有资源，或者仅导入单个管道。

Import-AdfFactory -SubscriptionId <your subscription ID> -ResourceGroupName <your Resource Group Name> -FactoryName <your Factory Name> -PipelineName <your Pipeline Name> -AdfToken $adfSecureToken | ConvertTo-FabricResources | Import-FabricResolutions -ResolutionsFilename "<path to your resolutions file>" | Export-FabricResources -Region <region> -Workspace <workspaceId> -Token $fabricSecureToken

小窍门

如果升级失败，PowerShell 将在详细信息部分显示原因。有关一些示例和故障排除，请参阅教程。

在 Microsoft Fabric 中验证结果

迁移完成后，在 Microsoft Fabric 中打开每个管道，并验证活动、参数和数据集连接。

运行具有安全示例输入的测试，并将输出与源 ADF 的运行进行比较以确认一致性。

修复任何空白（例如，尚未具有直接 Fabric 等效项的活动）。

分步教程

有关包含屏幕截图、示例和故障排除的详细教程，请参阅 PowerShell 迁移教程。

有关将基于 PowerShell 的 Azure 数据工厂管道迁移到 Fabric 的分步教程

反馈

此页面是否有帮助？

Last updated on 2025-09-22