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.

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.
  • 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.

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

De variabelebibliotheek in Fabric is een gestructureerd systeem dat is ontworpen voor het beheren van configuratieparameters in werkruimten en implementatiefasen. In de kern zijn door de gebruiker gedefinieerde variabelen, die basistypen (zoals tekenreeks, geheel getal, Booleaanse waarde) of complexe typen, zoals itemverwijzingen, kunnen zijn. Deze variabelen worden gegroepeerd binnen een item in de variabelenbibliotheek en kunnen door consumeritems binnen dezelfde werkruimte worden geraadpleegd.

Ter ondersteuning van dynamische configuratie kan elke variabele meerdere waardesets of alternatieve sets waarden bevatten die zijn afgestemd op verschillende omgevingen (bijvoorbeeld dev, test, prod). Eén waardeset wordt aangeduid als 'actief' per werkruimte, waarmee wordt bepaald welke waarden tijdens runtime worden gebruikt.

Gebruikers kunnen variabelen en waardesets maken, bewerken en beheren via de infrastructuurgebruikersinterface of API's, met ingebouwde validatie- en machtigingscontroles. Het systeem ondersteunt CI/CD-werkstromen, waardoor variabelen kunnen worden beheerd als code, geïntegreerd met Git en kunnen worden geïmplementeerd via pijplijnen. Deze structuur zorgt voor schaalbaar, geautomatiseerd en beheerd configuratiebeheer in complexe gegevenssystemen.

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

Ondersteunde items

De volgende items ondersteunen de variabelebibliotheek:

Naamgevingsconventies

De naam van het variabele bibliotheekitem zelf moet de volgende conventies volgen:

  • Is niet leeg
  • Heeft geen voorloop- of volgspaties
  • Begint met een letter
  • Kan letters, cijfers, onderstrepingstekens, afbreekstreepjes en spaties bevatten
  • Mag niet langer zijn dan 256 tekens

De naam van de variabelebibliotheek is niet hoofdlettergevoelig.

Overwegingen en beperkingen

Beperkingen voor variabelen

  • 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.

Verwante inhoud

  • Last updated on