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

Fabric gebruikt variabele bibliotheken in werkruimtes om constanten te definiëren over pipelines en andere data factory- en Fabric-items. Je kunt Azure Data Factory globale parameters migreren naar Fabric-variabelbibliotheken met een paar handmatige stappen.

In deze handleiding wordt u begeleid bij het proces:

  • Exporteer je algemene parameters van Azure Data Factory
  • Werkruimtevariabelen maken in Fabric
  • Pijplijnexpressies bijwerken
  • Gedrag valideren

Inzicht in de bibliotheek met Fabric variabelen

De variabelenbibliotheek in Fabric slaat waarden op werkruimteniveau op die je in verschillende pijplijnen en activiteiten kunt gebruiken. 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 de globale parameters van Azure Data Factory bieden Fabric-variabelen strengere beveiliging, gemakkelijker hergebruik en betere governance-controles. U kunt ze toepassen op alle Fabric items. Zie Aan de slag met variabelenbibliotheken voor meer informatie.

Migreren van globale parameters van Azure Data Factory naar de Fabric-variabelenbibliotheek

  1. Exporteer je globale parameters van Azure Data Factory.

    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.

    Bekijk je globale parametertypes van je Azure Data Factory (string, int, bool, enz.) en vergelijk ze met Fabric variabelebibliotheektypes. 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 je nieuwe variabelenbibliotheek, selecteer +Nieuwe variabele en elke globale parameter van Azure Data Factory als 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 Azure Data Factory-parameters, zoals de regiocode of tenantnaam, worden één-op-één toegewezen aan items in de variabelenbibliotheek.

  • 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 de PowerShell-upgradetool updaten 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

  • Laatst bijgewerkt om