Delen via

Globale azure Data Factory-parameters converteren naar Fabric Data Factory-variabelenbibliotheken

Microsoft Fabric maakt gebruik van variabelenbibliotheken in werkruimten om constanten in pijplijnen en andere data factory- en Fabric-items te definiëren. U kunt globale ADF-parameters migreren naar Infrastructuurvariabelebibliotheken 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 Fabric-variabelenbibliotheek

In de variabelenbibliotheek voor Fabric worden waarden op werkruimteniveau opgeslagen die u kunt gebruiken in 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 Infrastructuurvariabelen een strakkere beveiliging, eenvoudiger hergebruik en betere beheeropties. U kunt deze toepassen op alle Fabric-items. Zie Aan de slag met variabelenbibliotheken voor meer informatie.

Globale ADF-parameters migreren naar de Fabric-variabelenbibliotheek

  1. Exporteer de ADF-parameters globaal.

    1. Ga in Azure Data Factory Studio naarGlobale 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 de typen in de Fabric-variabelebibliotheek. Noteer eventuele typeverschillen die mogelijk aanpassingen vereisen tijdens de migratie.

  3. Maak een variabelebibliotheek in Fabric.

    1. Selecteer + Nieuw item in uw Fabric-werkruimte en zoek 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:

  • Het migratiehulpprogramma van Azure Data Factory naar Microsoft Fabric PowerShell migreert niet automatisch globale parameters.
  • Expressies in gekoppelde services of pijplijnen die naar @globalParameters() verwijzen, worden niet automatisch herschreven.
  • Infrastructuurverbindingen (de vervanging voor gekoppelde Azure Data Factory-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