Dela via

Vad är ett variabelbibliotek?

Ett Microsoft Fabric-variabelbibliotek är en bucket med variabler som andra objekt på arbetsytan kan använda som en del av programlivscykelhantering (ALM). Den fungerar som ett objekt i arbetsytan som innehåller en lista med variabler, tillsammans med deras respektive värden för varje steg i versionspipelinen. Den presenterar en enhetlig metod för effektiv hantering av objektkonfigurationer på en arbetsyta för att säkerställa skalbarhet och konsekvens i livscykelfaser.

Ett variabelbibliotek kan till exempel innehålla variabler som innehåller värden för:

  • Ett heltal som ska användas i en vänteaktivitet i en pipeline.
  • En lakehouse-referens som är källan i en kopieringsdataaktivitet . Varje värde används i en annan pipeline, baserat på pipelinens versionssteg.
  • En lakehouse-referens som ska konfigureras som en standard lakehouse för notebook-filer. Varje värde används i en annan pipeline, baserat på versionssteget för notebook-filen.

Värdeupplösning i konsumentprodukten är inte nödvändigtvis kopplad till dess tillämpning. I stället löser varje konsumentobjekt värdet baserat på sin egen kontext.

Upplevelsen av ett variabelbibliotek skiljer sig beroende på variabeltyp, men med alla variabelbibliotek kan du definiera och hantera variabler som andra objekt kan använda.

Ett infrastrukturvariabelbibliotek:

  • Är kompatibel med processer för kontinuerlig integrering och kontinuerlig leverans (CI/CD). Den här kompatibiliteten möjliggör integrering med Git och distribution via distributionspipelines.
  • Stöder automatisering via offentliga API:er för infrastrukturresurser.

Fördelar

Med variabelbibliotek kan kunder anpassa och dela konfigurationer.

Anpassa konfigurationer

Du kan konfigurera ett variabelvärde baserat på versionspipelinesteget. Du kan konfigurera variabelbiblioteket med uppsättningar med värden: ett värde för varje steg i versionspipelinen. Efter engångsinställningar för den aktiva värdeuppsättningen för varje fas används sedan rätt värde automatiskt i pipelinesteget. Exempel är:

  • Ändra ett objekts anslutning baserat på fasen.
  • Växla till en annan molndatakälla baserat på fasen.
  • Justera datakvantitet i en fråga baserat på fasen.

Dela konfigurationer

Variabelbibliotek är ett centraliserat sätt att hantera konfigurationer i arbetsyteobjekten. Om du till exempel har flera sjöhus på arbetsytan och var och en har en genväg som använder samma datakälla kan du skapa ett variabelbibliotek med datakällan som en av variablerna. På så sätt, om du vill ändra datakällan, måste du bara ändra den en gång i variabelbiblioteket. Du behöver inte ändra det i varje sjöhus separat.

Struktur för variabelbibliotek

Variabelbibliotek innehåller en eller flera variabler. Varje variabel har ett namn, en typ och ett standardvärde. Du kan också lägga till en anteckning i varje variabel för att beskriva dess syfte eller hur du använder den.

Skärmbild av ett variabelbibliotek med flera variabler och deras kärnkomponenter.

Standardvärde

Standardvärdet är det värde som används om du inte specifikt definierar ett annat värde.

Alla variabler måste ha ett standardvärde. Om variabeltypen är sträng kan standardvärdet vara null.

Alternativa värdeuppsättningar

Värdeuppsättningar definierar värdena för varje variabel i variabelbiblioteket. Ett variabelbibliotek innehåller vanligtvis flera värdeuppsättningar. Den aktiva (eller effektiva) värdeuppsättningen innehåller det värde som konsumentobjektet tar emot för arbetsytan.

I varje arbetsyta väljer du ett värde som ska vara aktivt. Den aktiva värdeuppsättningen för en arbetsyta ändras inte under en distribution eller uppdatering från Git.

Skärmbild av ett variabelbibliotek med flera alternativa värdeuppsättningar.

När du skapar en alternativ värdeuppsättning skapas den nya värdeuppsättningen med pekare till standardvärdet för varje variabel. Du kan sedan ändra värdet för varje variabel i den nya värdeuppsättningen.

Objekt som stöds

Följande objekt stöder variabelbiblioteket:

Överväganden och begränsningar

Storleksgränser

  • Det kan finnas upp till 1 000 variabler och upp till 1 000 värdeuppsättningar, så länge du uppfyller båda dessa krav:

    • Det totala antalet celler i de alternativa värdeuppsättningarna är mindre än 10 000.
    • Objektets storlek överskrider inte 1 MB.

    Dessa krav verifieras när du sparar ändringar.

  • Anteckningsfältet kan innehålla upp till 2 048 tecken.

  • Beskrivningsfältet för värdemängd kan ha upp till 2 048 tecken.

Begränsningar för alternativa värdeuppsättningar

  • Alternativa värdeuppsättningar i ett variabelbibliotek visas i den ordning som du lade till dem. För närvarande kan du inte ändra ordning på dem i användargränssnittet. För att ändra ordningen, redigera JSON-filen direkt.
  • Namnet på varje värdeuppsättning måste vara unikt i ett variabelbibliotek.
  • Variabelnamn måste vara unika i ett variabelbibliotek. Du kan ha två variabler med samma namn på en arbetsyta om de finns i olika objekt.
  • Det finns alltid ett (och bara ett) aktivt värde som anges i ett variabelbibliotek i taget. Du kan inte ta bort en värdeuppsättning när den är aktiv. Om du vill ta bort det konfigurerar du först ett annat värde som ska vara aktivt. Du kan ha olika aktiva värden för varje steg i en distributionspipeline.

Relaterat innehåll