De globale parameters van Azure Data Factory naar Fabric Data Factory-variabelenbibliotheken converteren.

Microsoft Fabric gebruikt bibliotheken voor variabelen in werkruimten om constanten in pijplijnen en andere Data Factory- en Fabric-items te definiëren. U kunt globale ADF-parameters migreren naar Fabric variabelenbibliotheken met een paar handmatige stappen.

In deze handleiding wordt u begeleid bij het proces:

  • Globale ADF-parameters exporteren
  • Werkruimtevariabelen maken in Fabric
  • Pijplijnexpressies bijwerken
  • Gedrag valideren

Inzicht in de bibliotheek met Fabric variabelen

In de Fabric variabelebibliotheek worden waarden op werkruimteniveau opgeslagen waarnaar u kunt verwijzen tussen pijplijnen en activiteiten. Het ondersteunt typen zoals tekenreeks, getal en booleaanse waarden, plus veilige waarden voor geheimen. U kunt variabelenbibliotheken versien en implementeren in omgevingen met implementatiepijplijnen.

In tegenstelling tot globale ADF-parameters bieden Fabric variabelen een strakkere beveiliging, eenvoudiger hergebruik en betere beheeropties. U kunt ze toepassen op alle Fabric items. Zie Aan de slag met variabelenbibliotheken voor meer informatie.

Globale ADF-parameters migreren naar Fabric variabelebibliotheek

  1. Exporteer de ADF-parameters globaal.

    1. Ga in Azure Data Factory Studio naar Beheer>Global Parameters. Noteer de naam, het type en de waarde van elke parameter.
    2. Ga voor grote migraties naar Beheer>ARM-sjabloon en exporteer ARM-sjablonen om parameters via programmatuur te extraheren. U vindt ze in de sjabloonmap onder de factory map, in het bestand dat eindigt op ParametersForFactory

  2. Vergelijk beschikbare typen.

    Controleer de globale ADF-parametertypen (tekenreeks, int, bool, enzovoort) en vergelijk deze met Fabric variabele bibliotheektypen. Noteer eventuele typeverschillen die mogelijk aanpassingen vereisen tijdens de migratie.

  3. Maak een variabelebibliotheek in Fabric.

    1. Selecteer in uw Fabric workspace + Nieuw item en zoek naar en selecteer Variabele bibliotheek.
    2. Een bibliotheek maken (bijvoorbeeld GlobalParams).
    3. Open de nieuwe variabelebibliotheek, selecteer +Nieuwe variabele en elke globale ADF-parameter als een variabele.

    Zie Aan de slag met variabelenbibliotheken voor meer informatie over het maken van variabelebibliotheken.

  4. Gemigreerde pijplijnexpressies bijwerken.

    Werk globale parameterverwijzingen bij, zoals @globalParameters('ParamName'), naar variabele-bibliotheekverwijzingen, zoals @pipeline.libraryVariables.ParamName.

    Werk al uw activiteitsexpressies, verbindingsreeksen, scriptargumenten, filterlogica en gegevensseteigenschappen bij. Zie De integratie van de variabele bibliotheek met gegevenspijplijnen voor meer informatie.

  5. Pijplijngedrag valideren.

    Voer validatie- en testuitvoeringen uit om te bevestigen dat variabelen correct worden opgelost in uw pipelines. Controleer of verbindingen, parameterbindingen en veilig gebruik van variabelen werken zoals verwacht.

Algemene migratiepatronen

Hier volgen enkele migratiepatronen die u kunt gebruiken bij het converteren van globale parameters naar variabelenbibliotheken:

  • Directe toewijzing : eenvoudige ADF-parameters, zoals regio- of tenantnaam, wijzen één-op-een toe aan variabele bibliotheekvermeldingen.

  • Omgevingsspecifieke bibliotheken : maak in plaats van één bibliotheek meerdere bibliotheken (Global Dev, Global-Test, Global-Prod). Implementatiepijplijnen kunnen de juiste bibliotheek binden op basis van de omgeving.

  • Hybride model : houd gedeelde constanten in de variabelebibliotheek, maar geef uitvoeringsspecifieke informatie door via pijplijnparameters.

Huidige beperkingen

Er zijn momenteel enkele beperkingen om rekening mee te houden:

  • Noch de ingebouwde upgrade-ervaring noch het Hulpprogramma voor PowerShell-migratie migreert automatisch globale parameters.
  • Expressies in gekoppelde services of pijplijnen die naar @globalParameters() verwijzen, worden niet automatisch herschreven.
  • Fabric verbindingen (de vervanging voor Azure Data Factory gekoppelde services) bieden geen ondersteuning voor parameterexpressies op dezelfde manier. U moet alle dynamische parameters die in verbindingsdefinities worden gebruikt, handmatig opnieuw ontwerpen.

Beste praktijken

Houd rekening met deze tips:

  • Naamconventies afstemmen vóór de migratie.
  • Vermijd overbelasting van variabelen op werkruimteniveau. Gebruik in plaats daarvan pijplijnparameters voor runtimewaarden.
  • Implementatiepijplijnen gebruiken om omgevingsspecifieke variabelenbibliotheken te beheren.
  • Documenteer uw variabelebibliotheek zodat teamleden weten welke pijplijnen afhankelijk zijn van welke variabelen.

Verwante inhoud

  • Last updated on