Delen via

Integratie van variabelenbibliotheek met pijplijnen

De variabelebibliotheek is een nieuw itemtype in Microsoft Fabric waarmee gebruikers variabelen op werkruimteniveau kunnen definiëren en beheren, zodat ze binnenkort kunnen worden gebruikt in verschillende werkruimte-items, zoals pijplijnen, notebooks, Snelkoppeling voor Lakehouse en meer. Het biedt een uniforme en gecentraliseerde manier om configuraties te beheren, de noodzaak van vastgelegde waarden te verminderen en uw CI/CD-processen te vereenvoudigen, waardoor het eenvoudiger is om configuraties in verschillende omgevingen te beheren.

Variabelenbibliotheek gebruiken met pijplijnen

  1. Navigeer naar uw werkruimte en maak een nieuw item.

    Schermopname waarin wordt weergegeven waar u een nieuw item toevoegt in uw Fabric-werkruimte gemarkeerd.

  2. Gebruik het filter om een variabelebibliotheek te zoeken of schuif omlaag naar de sectie Gegevens ontwikkelen.

    Schermopname van het filter voor een nieuw item in de variabelebibliotheek.

  3. Selecteer variabelebibliotheek om een nieuwe variabelebibliotheek te maken. Kies een naam en druk op Maken.

    Schermopname met een nieuw bibliotheekitem 'Variabele,' waarbij de naam is ingesteld en de knop 'Maken' is gemarkeerd.

  4. Zodra de variabelenbibliotheek is gemaakt, wordt u naar de startpagina gebracht. Klik op + Nieuw om een nieuwe variabele toe te voegen.

    Schermopname van de startpagina voor een nieuw variabelebibliotheekitem.

  5. Zodra u een nieuwe variabele hebt toegevoegd, kunt u de variabele configureren en de set Naam, Type en Standaardwaarde instellen. U kunt ook notities toevoegen.

    Schermopname van de configuraties die moeten worden ingesteld voor een nieuwe variabele.

  6. Voeg naar behoefte alternatieve waardesets toe (bijvoorbeeld verschillende waarden voor verschillende implementatiepijplijnomgevingen). Nadat u een naam hebt ingesteld en op Maken hebt geklikt, kunt u de variabelewaarden bewerken en de waarde kiezen die is ingesteld om actief te maken.

    Schermopname waarin wordt gemarkeerd waar nieuwe waardesets voor een variabele moeten worden toegevoegd.

    Schermopname die laat zien hoe u een naam toevoegt voor een nieuwe waardeset.

  7. Sla uw wijzigingen op zodra u klaar bent.

Schermopname met de knop Opslaan gemarkeerd in de linkerbovenhoek.

Variabelen uit de variabelenbibliotheek gebruiken in uw pipeline

  1. Als u een variabele uit een variabelenbibliotheek in uw pijplijn wilt gebruiken, maakt u een nieuwe pijplijn aan of navigeert u naar een bestaande pijplijn.

    Schermopname met de knop Nieuw item maken in de linkerbovenhoek en het pijplijnitem gemarkeerd.

  2. In uw pijplijn moet u in het onderste deelvenster een verwijzing maken naar de variabele uit uw variabelenbibliotheek.

    Schermopname met het tabblad Bibliotheekvariabelen en de knop +Nieuw in het onderste deelvenster van het pijplijncanvas.

  3. Nadat u op + Nieuw hebt geklikt, wordt er een pop-upvenster geopend waarin al uw variabelenbibliotheken worden weergegeven. U kunt deze kiezer gebruiken om uw Variabelebibliotheek-variabele te selecteren en op OK te klikken.

    Schermopname met de gemarkeerde knop +Nieuw op het tabblad Bibliotheekvariabelen.

    Schermopname van een bibliotheekvariabele die is geselecteerd in de variabelekiezer.

    Schermopname van de configuratieset voor een nieuwe bibliotheekvariabelereferentie.

  4. Nadat u de verwijzingen naar de bibliotheekvariabele hebt toegevoegd, voegt u uw pijplijnactiviteiten toe. Klik in de activiteitsinstellingen op Dynamische inhoud toevoegen voor de instelling die u wilt parameteriseren.

    Schermopname van Dynamische inhoud toevoegen gemarkeerd in de instellingen van een opzoekactiviteit.

  5. De opbouwfunctie voor expressies wordt geopend. Als u bibliotheekvariabelen niet ziet, klikt u op de drie puntjes naast Functions en selecteert u Bibliotheekvariabelen.

    Schermopname van de drie puntjes naast Functies in de expressiebouwer en het tabblad met bibliotheekvariabelen gemarkeerd.

  6. Klik op de verwijzing naar de bibliotheekvariabele om een nieuwe expressie toe te voegen aan de opbouwfunctie voor expressies. Klik vervolgens op OK om uw expressie toe te voegen.

    Schermopname van een verwijzing naar een bibliotheekvariabele die is gemarkeerd om aan de opbouwfunctie voor expressies te worden toegevoegd.

    Schermopname van de expressieset in de opbouwfunctie voor expressies.

  7. U ziet nu dat de dynamische inhoud wordt toegevoegd aan uw activiteitsinstelling.

    Schermopname van de expressie die is ingesteld als dynamische inhoud in de instellingen van de lookup-activiteit.

  8. U kunt een voorbeeld van uw gegevens bekijken door op Voorbeeldgegevens te klikken. Hiermee opent u een nieuw deelvenster waarin de waarde van de bibliotheekvariabele wordt weergegeven. Klik op OK om een voorbeeld van uw gegevens te bekijken.

    Schermopname van de optie voorbeeldgegevens.

    Schermopname van het voorbeeldgegevensvenster.

  9. Sla de pijplijn op en voer deze uit zoals u dat normaal zou doen. U ziet dat de doorgegeven waarde de waarde is die is ingesteld als Actief in uw variabelebibliotheek.

    Schermopname die de instellingen voor Opslaan en Uitvoeren gemarkeerd op het pijplijncanvas laat zien.

Bekende beperkingen

De volgende bekende beperkingen zijn van toepassing op de integratie van variabele bibliotheek in pijplijnen in Data Factory in Microsoft Fabric:

  • De bibliotheek Variabele ondersteunt booleaanse waarden, datum/tijd, guid, integer, getal en tekenreeks als gegevenstypen. In uw pijplijn ziet u Booleaanse waarde als Bool-type, Datum/tijd als tekenreekstype, Guid als tekenreekstype, integer als int-type en tekenreeks als tekenreekstype. Getaltypen worden niet ondersteund in pijplijnen.
  • Parameterisatie van externe verbindingen wordt ondersteund met een variabelebibliotheek die is geïntegreerd met pijplijnen. U moet echter de GUID voor uw verbinding opzoeken via Instellingen | Verbindingen en gateways beheren. Daar vindt u de GUID voor uw verbinding door Instellingen naast uw verbindingsnaam te selecteren.

Verwante inhoud

  • Last updated on