Delen via

Wat is een variabelebibliotheek? (voorbeeld)

Een Bibliotheek met Microsoft Fabric-variabelen kan worden beschouwd als een bucket met variabelen die kunnen worden gebruikt door andere items in de werkruimte. Het fungeert als een item in de werkruimte met een lijst met variabelen, samen met de bijbehorende waarden voor elke fase van de release-pijplijn. Het biedt een uniforme benadering voor klanten om itemconfiguraties in een werkruimte efficiënt te beheren, waardoor schaalbaarheid en consistentie in verschillende levenscyclusfasen worden gegarandeerd.

Een variabelebibliotheek kan bijvoorbeeld variabelen bevatten die verschillende waarden bevatten voor:

  • Een geheel getal dat moet worden gebruikt in een wachtactiviteit in een pijplijn.
  • Een lakehouse-verwijzing als bron in de activiteit Gegevens kopiëren. Elke waarde wordt in een andere pijplijn gebruikt op basis van de releasefase waarin de pijplijn zich bevindt.
  • Een lakehouse-referentie die moet worden geconfigureerd als de standaard lakehouse in Notebook. Elke waarde wordt in een andere pijplijn gebruikt op basis van de releasefase waarin het notebook zich bevindt.

Waarderesolutie in het consumentenproduct is niet per se gekoppeld aan de inzet ervan. In plaats daarvan bepaalt elk consumentenitem de waarde op basis van zijn eigen context.

De ervaring met de variabelebibliotheek verschilt op basis van het variabeletype, maar het kernconcept blijft hetzelfde: hiermee kunt u variabelen definiëren en beheren die in andere items kunnen worden gebruikt.

De Fabric Variable-bibliotheek:

Opmerking

Het bibliotheekitem Microsoft Fabric Variable is momenteel beschikbaar als preview-versie.

Met variabelenbibliotheken kunnen klanten het volgende doen:

  • Configuraties aanpassen:

    Een variabelewaarde kan worden geconfigureerd op basis van de releasepijplijnfase. De gebruiker kan de variabelebibliotheek configureren met verschillende waardensets, één voor elke fase van de release-pijplijn. Na eenmalige instellingen van de actieve waardeset voor elke fase wordt de juiste waarde automatisch gebruikt in de pijplijnfase. Enkele voorbeelden zijn:

    • Wijziging van de itemverbinding afhankelijk van de fase
    • Overschakelen naar een andere cloudgegevensbron op basis van de fase
    • Gegevenshoeveelheid in een query aanpassen op basis van de fase

  • Configuraties delen

    Variabele bibliotheken bieden een gecentraliseerde manier om configuraties in de werkruimte-elementen te beheren. Als u bijvoorbeeld meerdere Lakehouses in de werkruimte hebt en elke werkruimte een snelkoppeling heeft die gebruikmaakt van dezelfde gegevensbron, kunt u een variabelebibliotheek met die gegevensbron maken als een van de variabelen. Op die manier hoeft u de gegevensbron slechts één keer te wijzigen in de variabele-bibliotheek in plaats van deze afzonderlijk in elk Lakehouse aan te passen.

Structuur van variabele bibliotheek

Kernonderdelen

Variabelebibliotheken bevatten een of meer variabelen. Elke variabele heeft een naam, type en standaardwaarde. U kunt ook een notitie toevoegen aan elke variabele om het doel ervan te beschrijven of hoe u deze kunt gebruiken.

Schermopname van de variabelebibliotheek met verschillende variabelen en de bijbehorende kernonderdelen.

Standaardwaarde

De standaardwaarde is de waarde die wordt gebruikt, tenzij u specifiek een andere waarde definieert die moet worden gebruikt.
Alle variabelen moeten een standaardwaarde hebben. Als het variabeletype Tekenreeks is, kan de standaardwaarde null zijn.

Sets met alternatieve waarden

Met waardensets worden de waarden van elke variabele in de bibliotheek Variabele gedefinieerd. Een variabelebibliotheek bevat doorgaans meerdere waardesets. De actieve (of effectieve) waardeset bevat de waarde die consumentenitems voor die werkruimte ontvangen. In elke werkruimte selecteert u een waarde die is ingesteld op actief. De actieve-waardeset van een werkruimte wordt niet gewijzigd tijdens de implementatie of update van Git.

Schermopname van de variabelebibliotheek met verschillende alternatieve waardesets.

Wanneer u een alternatieve waardeset maakt, wordt de nieuwe waardeset gemaakt met aanwijzers naar de standaardwaarde voor elke variabele. Vervolgens kunt u de waarde voor elke variabele in de nieuwe waardeset wijzigen.

Ondersteunde items

De volgende items ondersteunen de Variabele bibliotheek:

Overwegingen en beperkingen

Groottebeperkingen

  • Er kunnen maximaal 1000 variabelen en maximaal 1.000 waardesets zijn, zolang het totale aantal cellen in de alternatieve waardesets kleiner is dan 10.000 cellen en de grootte van het item niet groter is dan 1 MB. Dit wordt gevalideerd wanneer de gebruiker wijzigingen opslaat.
  • Het notitieveld mag maximaal 2048 tekens bevatten.
  • Het beschrijvingsveld van de waardeset mag maximaal 2048 tekens bevatten.

Beperkingen voor het instellen van alternatieve waarden

  • Alternatieve waardesets in de bibliotheek Variabele worden weergegeven in de volgorde waarin ze zijn toegevoegd. Op dit moment kunt u ze niet opnieuw ordenen in de gebruikersinterface. Als u de volgorde wilt wijzigen, bewerkt u het JSON-bestand rechtstreeks.
  • De naam van elke waardeset moet uniek zijn in de bibliotheek Variabele.
  • Namen van variabelen moeten uniek zijn binnen een variabelebibliotheek. U kunt twee variabelen met dezelfde naam in een werkruimte hebben als ze zich in verschillende items bevinden.
  • Er is altijd één en slechts één actieve waarde set in een variabele bibliotheek tegelijk. U kunt de actieve-waardeset niet verwijderen. Als u deze wilt verwijderen, stelt u eerst een andere waarde in die is ingesteld op actief. U kunt voor elke fase van een implementatiepijplijn een andere actieve waarde instellen.

Verwante inhoud