Delen via


Wat is een variabele bibliotheek?

Een Microsoft Fabric-variabelebibliotheek is een bucket met variabelen die andere items in de werkruimte kunnen gebruiken als onderdeel van het beheer van de levenscyclus van toepassingen (ALM). 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 efficiënt beheer van itemconfiguraties binnen een werkruimte, om schaalbaarheid en consistentie in fasen van de levenscyclus te garanderen.

Een variabelebibliotheek kan bijvoorbeeld variabelen bevatten die waarden bevatten voor:

  • Een geheel getal dat moet worden gebruikt in een wachtactiviteit in een pijplijn.
  • Een lakehouse-verwijzing naar de bron in een kopieergegevensactiviteit . Elke waarde wordt in een andere pijplijn gebruikt op basis van de releasefase van de pijplijn.
  • Een lakehouse-verwijzing die als standaard lakehouse-notebook moet worden geconfigureerd. Elke waarde wordt in een andere pijplijn gebruikt op basis van de releasefase van het notebook.

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 van een variabelebibliotheek verschilt op basis van het variabeletype, maar met alle variabelebibliotheken kunt u variabelen definiëren en beheren die andere items kunnen gebruiken.

Een infrastructuurvariabelebibliotheek:

  • Is compatibel met CI/CD-processen (continue integratie en continue levering). Deze compatibiliteit maakt integratie met Git en implementatie mogelijk via implementatiepijplijnen.
  • Ondersteunt automatisering via openbare Fabric-API's.

Voordelen

Met variabelenbibliotheken kunnen klanten configuraties aanpassen en delen.

Configuraties aanpassen

U kunt een variabelewaarde configureren op basis van de releasepijplijnfase. U kunt de variabelebibliotheek configureren met sets waarden: één waarde voor elke fase van de release-pijplijn. Na eenmalige instellingen van de actieve waarde die voor elke fase is ingesteld, wordt de juiste waarde automatisch gebruikt in de pijplijnfase. Voorbeelden zijn:

  • De verbinding van een item wijzigen op basis van de fase.
  • Overschakelen naar een andere cloudgegevensbron op basis van de fase.
  • De hoeveelheid gegevens 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 elk exemplaar een snelkoppeling heeft die gebruikmaakt van dezelfde gegevensbron, kunt u een variabelebibliotheek met die gegevensbron maken als een van de variabelen. Als u de gegevensbron zo wilt wijzigen, moet u deze slechts één keer wijzigen in de variabelebibliotheek. U hoeft het niet afzonderlijk te wijzigen in elk lakehouse.

Structuur van variabele bibliotheek

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 een variabelebibliotheek met verschillende variabelen en de bijbehorende kernonderdelen.

Standaardwaarde

De standaardwaarde is de waarde die wordt gebruikt, tenzij u specifiek een andere waarde definieert.

Alle variabelen moeten een standaardwaarde hebben. Als het variabeletype tekenreeks is, kan de standaardwaarde zijn null.

Sets met alternatieve waarden

Met waardesets worden de waarden van elke variabele in de variabelebibliotheek gedefinieerd. Een variabelebibliotheek bevat doorgaans meerdere waardesets. De actieve (of effectieve) waardeset bevat de waarde die het consumentenitem voor die werkruimte ontvangt.

In elke werkruimte selecteert u een waarde die is ingesteld op actief. De actieve-waardeset van een werkruimte verandert niet tijdens een implementatie of update van Git.

Schermopname van een variabelebibliotheek met verschillende sets alternatieve waarden.

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 variabelebibliotheek:

Overwegingen en beperkingen

Groottebeperkingen

  • Er kunnen maximaal 1000 variabelen en maximaal 1000 waardensets zijn, zolang u aan beide vereisten voldoet:

    • Het totale aantal cellen in de alternatieve waardesets is kleiner dan 10.000.
    • De grootte van het item is niet groter dan 1 MB.

    Deze vereisten worden gevalideerd wanneer u wijzigingen opslaat.

  • Het notitieveld mag maximaal 2048 tekens bevatten.

  • Het beschrijvingsveld van de waardeset mag maximaal 2048 tekens bevatten.

Beperkingen voor alternatieve waardesets

  • Alternatieve waardesets in een variabelebibliotheek worden weergegeven in de volgorde waarin u ze hebt 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 binnen een variabelebibliotheek.
  • 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 ingesteld in een variabelebibliotheek tegelijk. U kunt een waardeset niet verwijderen terwijl deze actief is. Als u deze wilt verwijderen, configureert u eerst een andere waarde die is ingesteld op actief. U kunt voor elke fase van een implementatiepijplijn een andere actieve waarde instellen.