Opgrader Azure Data Factory og Synapse pipelines til Microsoft Fabric ved hjælp af PowerShell

Du kan migrere dine Azure Data Factory (ADF) og Synapse-pipelines til Microsoft Fabric ved hjælp af Microsoft. FabricPipelineUpgrade PowerShell-modul. Denne vejledning beskriver alle trinene til at udføre migreringen. Du kan finde et detaljeret selvstudium med skærmbilleder, eksempler og fejlfinding i selvstudiet til PowerShell-migrering.

For at migrere dine pipelines til Fabric ved hjælp af PowerShell, skal du:

1. Forbered dit miljø til Fabric pipeline-opgraderinger.
2. Connect PowerShell til dine Azure- og Fabric-miljøer.
3. Opgrader dine fabriksrørledninger.
4. Opret en opløsningsfil og kortlæg linkede tjenester til Fabric forbindelser.
5. Valider dine resultater.

Forudsætninger

For at komme i gang skal du fuldføre følgende forudsætninger:

• Tenant: Din ADF og Fabric workspace skal være i samme Microsoft Entra ID tenant.
• Fabric: En lejerkonto med et aktivt Fabric-abonnement - Opret en konto gratis.
• Fabric workspace anbefalinger (valgfrit): Brug et nyt Fabric workspace i samme område som din ADF til opgraderinger for bedst ydeevne.
• Tilladelser: Læs adgang til ADF-arbejdsområdet og de elementer, du vil migrere, samt bidragsyder eller højere rettigheder i det Fabric-arbejdsområde, du vil skrive til.
• Network og autentificering: Sørg for, at du kan logge ind på både Azure og Fabric fra din maskine (interaktiv eller service principal).

Understøttet funktionalitet

Ud over de aktuelt understøttede datasæt og sammenkædede tjenester og aktiviteter, der understøttes i øjeblikket, gælder følgende begrænsninger:

• Hvis en aktivitet ikke er tilgængelig i Fabric, kan Fabric Upgrader ikke opgradere den.
• Global konfiguration og parametre understøttes ikke.
• pipeline().Pipeline understøttes ikke i øjeblikket.
• At bruge dynamisk udtryk for URL-egenskaben i Web/Webhook understøttes ikke.

Datasæt, der understøttes i øjeblikket, og sammenkædede tjenester

• Blob: JSON, afgrænset tekst og binære formater
• Azure SQL Database
• ADLS Gen2: JSON, afgrænset tekst og binære formater
• Azure Function: Function app URL

Aktuelt støttede aktiviteter

• CopyActivity for understøttede datasæt
• ExecutePipeline (konverteret til Fabric InvokePipeline Activity)
• IfCondition
• Vent
• web
• SetVariable
• Azure-funktion
• ForEach
• Søg
• Switch
• SqlServerStoredProcedure

Forbered dit miljø på opgraderinger af Fabric-pipelinen

Før du begynder at opgradere pipelines, skal du kontrollere , at dit miljø har de nødvendige værktøjer og moduler:

• PowerShell 7.4.2 (x64) eller nyere
• FabricPipelineUpgrade-modul

Installer PowerShell 7.4.2 (x64) eller nyere

Du skal bruge PowerShell 7.4.2 eller nyere på din computer.

Download PowerShell

Installer og importer FabricPipelineUpgrade-modulet

1. Åbn PowerShell 7 (x64).

2. Vælg menuen Start, søg efter PowerShell 7, åbn appens genvejsmenu, og vælg Kør som administrator.

   

3. I det hævede PowerShell-vindue installerer du modulet fra PowerShell Gallery:

   Install-Module Microsoft.FabricPipelineUpgrade -Repository PSGallery -SkipPublisherCheck
   

4. Importer modulet til din session:

   Import-Module Microsoft.FabricPipelineUpgrade
   

5. Hvis du ser en fejl i signerings- eller udførelsespolitikken, skal du køre denne kommando og derefter importere modulet igen:

   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
   

Bekræft din installation

Kør denne kommando for at bekræfte, at modulet er indlæst korrekt:

Get-Command -Module Microsoft.FabricPipelineUpgrade

Connect PowerShell til dine Azure- og Fabric-miljøer

Kør disse kommandoer i PowerShell for at logge på og angive dit abonnement og din lejer til efterfølgende Az-cmdlet'er:

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

Kør disse kommandoer for at få adgangstoks til ADF og Fabric:

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

Opgrader dine fabriksressourcer

Først importer dine Azure Data Factory pipelines, derefter mapp dine ADF-linkede services til Fabric forbindelser, og til sidst opgrader dine Azure Data Factory pipelines.

Importer dine Azure Data Factory pipelines

Følgende PowerShell importerer dine datafabriksressourcer. Opdater Import-AdfFactory kommandoen før den første | for enten at importere alle understøttede ressourcer i din ADF eller en enkelt pipeline.

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

Importer alle fabriksressourcer

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

Importere en enkelt pipeline

Det er den samme kommando, som du brugte til at importere alle fabriksressourcer, men du tilføjer -PipelineName:

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

Kortlæg dine ADF-linkede tjenester til Fabric-forbindelser

1. Hvis din Fabric-instans ikke allerede har forbindelser til de datakilder, der bruges i dine ADF-linkede tjenester, så skab disse forbindelser i Fabric.
2. Opret din resolutionsfil for at fortælle FabricUpgrader, hvordan du skal mappe dine ADF-linkede tjenester til Fabric forbindelser.

Opret din løsningsfil

En resolution-fil er en JSON-fil, der kortlægger dine ADF-linkede services til Fabric-forbindelser:

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

• Det type er den type kortlægning, der skal udføres. Det er normalt LinkedServiceToConnectionId, men du kan også bruge andre typer i særlige tilfælde.
• Det key afhænger af, hvad type du bruger. For LinkedServiceToConnectionId, er navnet key på den ADF-linkede tjeneste , som du vil tilknytte.
• value er GUID for den Fabric forbindelse, du vil mappe til. Du kan finde GUID i indstillingerne for Fabric forbindelsen.

Så for eksempel, hvis du har to ADF-tilknyttede tjenester ved navn MyAzureBlobStorage og MySQLServer, som du vil mappe til Fabric forbindelser, vil din fil se sådan ud:

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

Opret din Resolutions.json fil ved hjælp af denne struktur, og gem den et sted på din maskine, så PowerShell kan få adgang til den.

Du kan finde flere oplysninger om løsningsfilen under Sådan føjes en forbindelse til løsningsfilen.

PowerShell-kommando til at opgradere dine ADF-pipelines

Nu hvor du har din opløsningsfil, kan du køre denne PowerShell-kommando for at udføre opgraderingen. Opdater parameteren ResolutionFilename, så den peger på opløsningsfilen. Opdater også Import-AdfFactory-kommandoen før den første | for enten at importere alle understøttede ressourcer i din ADF eller en enkelt pipeline.

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

Valider resultaterne i Microsoft Fabric

Når din migration er færdig, åbner du hver pipeline i Microsoft Fabric og verificerer aktiviteter, parametre og datasætforbindelser.

Kør testudførelser med sikre eksempelinput, og sammenlign output med dine ADF-kildekørsler for at bekræfte pariteten.

Ret eventuelle huller (for eksempel aktiviteter, der endnu ikke har en direkte Fabric ækvivalent).

Trin-for-trin vejledning

Du kan finde et detaljeret selvstudium med skærmbilleder, eksempler og fejlfinding i selvstudiet til PowerShell-migrering.

Relateret indhold

• Trin-for-trin vejledning til PowerShell-baseret migration af Azure Data Factory pipelines til Fabric

Opgradering af synapse-pipelines til Fabric

Kør disse kommandoer for at få adgangstokene til ARM, Synapse og Fabric:

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

PowerShell-kommando til at opgradere dine Synapse-pipelines

Kør disse kommandoer for at opgradere dine Synapse Pipelines til Fabric:

Import-SynapseWorkspace -SubscriptionId <your subscription ID> -ResourceGroupName <your Resource Group Name> -WorkspaceName <your Synapse Workspace Name> -PipelineName <your Pipeline Name> -ArmToken $ArmToken -SynapseToken $synapseSecureToken| Import-FabricResolutions -rf "<path to your resolutions file>" | ConvertTo-FabricResources | Export-FabricResources -Region <region> -Workspace <your Synapse Workspace Name> -Token $fabricSecureToken -AzureToken $ArmToken -EnableVerboseLogging