Del via

Opprette og administrere variable biblioteker

Microsoft Fabric-variabelbiblioteker gjør det mulig for utviklere å tilpasse og dele elementkonfigurasjoner i et arbeidsområde, med et mål om å effektivisere administrasjon av innholdslivssyklus. Denne artikkelen forklarer hvordan du oppretter, administrerer og bruker variabelbiblioteker.

Hvis du vil ha en mer detaljert gjennomgang av prosessen, kan du se opplæringen for bruk av variabelbiblioteker.

Prerequisites

Hvis du vil opprette variable bibliotekelementer i Fabric, trenger du:

Sikkerhetshensyn og tillatelsesadministrasjon for Fabric-variabelbiblioteker

Strukturvariabelbiblioteker er kraftige konstruksjoner som muliggjør sentralisert administrasjon av variabler på tvers av flere Fabric-elementer. Denne fleksibiliteten introduserer imidlertid kritiske sikkerhetshensyn.

Siden variable biblioteker i seg selv er Fabric-elementer, styres de av sine egne tillatelsessett . Disse tillatelsessettene kan avvike fra elementene som bruker variablene. Dette avviket kan føre til scenarier der en bruker har skrivetilgang til et variabelt bibliotek, men mangler tilgang til det forbrukende elementet.

I slike tilfeller kan uautoriserte brukere endre variabelverdier på måter som bevisst eller utilsiktet endrer virkemåten til avhengige Fabric-elementer. Denne muligheten skaper en potensiell angrepsvektor der ondsinnede oppdateringer av delte variabler kan kompromittere integriteten, sikkerheten eller funksjonaliteten til disse elementene.

For å redusere disse risikoene, følg disse nøkkelfremgangsmåtene:

  • Ta i bruk strenge tillatelseskontroller: Administratorer må nøye administrere skrivetillatelser for variable biblioteker, slik at bare klarerte brukere eller tjenester kan endre dem. Denne praksisen inkluderer å unngå altfor tillatt tilgang og regelmessig revidere tillatelsestilordninger.
  • Bruk klarerte bibliotekreferanser: Elementer skal bare referere til variabler fra biblioteker som er eksplisitt angitt som klarerte. Denne klareringsmodellen bør håndheves gjennom styringspolicyer som validerer kilden til variabelreferanser under utvikling og distribusjon.

Hvis du vil ha mer informasjon, kan du se Tillatelser for variabelt bibliotek.

Opprette et variabelt bibliotekelement

Du kan opprette et variabelt bibliotekelement fra Fabric-hjemmesiden eller fra arbeidsområdet:

  1. På sidefeltet velger du Opprett. (Hvis den ikke er der, merker du de tre prikkene, og deretter velger du Opprett.)

  2. I Data Factory-delen velger du Variabelbibliotek.

    Skjermbilde av Fabric-grensesnittet som viser plasseringen av variable biblioteker i datafabrikkdelen.

  3. Gi det nye variabelbiblioteket et navn, og velg deretter Opprett. Kontroller at navnet er i samsvar med de nødvendige navnekonvensjonene.

Et tomt variabelbibliotek vises. Du kan nå legge til variabler i den.

Skjermbilde av et tomt variabelbibliotek med en knapp for en ny variabel.

Behandle variabelbiblioteker og deres variabler

Du kan administrere variablene i variabelbiblioteket fra den øverste menylinjen.

Skjermbilde av et variabelbibliotek, med en knapp for å lage en ny variabel på menylinjen.

Legge til en variabel

Slik legger du til en ny variabel i biblioteket:

  1. Velg + Ny variabel.
  2. Skriv inn et navn. Kontroller at den følger navnekonvensjonene.
  3. Velg en type i rullegardinlisten. Se en liste over støttede variabeltyper.
  4. Angi en standardverdi.
  5. Legg til et notat som forklarer hva variabelen er til for, eller hvordan du bruker den (valgfritt).
  6. Velg Lagre.

Slette eller redigere en variabel

  • Hvis du vil slette en variabel, velger du én eller flere variabler og velger deretter Slett variabel>Lagre.
  • Hvis du vil redigere navnet, typen eller verdisettet for en variabel, endrer du verdien og velger deretter Lagre.
  • Hvis du vil legge til et annet alternativt verdisett, velger du Legg til verdisett.

Note

Hvis du velger Lagre etter å ha redigert en variabel i variabelbiblioteket, utløses en feilvalideringskontroll for å sikre at alle variabelnavnene og -verdiene er gyldige. Du må rette opp eventuelle feil før du lagrer endringene.

Legge til et verdisett

Slik legger du til et annet verdisett som du kan bruke i en annen fase:

  1. Velg Legg til verdisett.

  2. Gi navn til verdisettet. Kontroller at den følger navnekonvensjonene. Gi den en beskrivelse (valgfritt) på opptil 2 048 tegn.

  3. Hvis du vil bruke denne verdien til å være den aktive verdien som er angitt i dette arbeidsområdet, velger du Angi som aktiv.

  4. Angi verdier for alle variablene i variabelbiblioteket.

  5. Velg Lagre.

Redigere et verdisett

Slik redigerer du et verdisett:

  1. Velg de tre prikkene ved siden av navnet på verdisettet.

  2. Velg Angi som aktiv (for dette arbeidsområdet), Gi nytt navn eller Slett.

    Skjermbilde av alternativene for redigering av et verdisett: angi som aktiv, gi nytt navn og slett.

  3. Velg Lagre. Endringer trer først i kraft etter at du har lagret dem.

Hvis du vil tilbakestille verdien for hver variabel til standardverdien, velger du tilbakestillingsknappen.

Skjermbilde av et variabelbibliotek som viser en tilbakestillingsknapp ved siden av hver verdi for en variabel.

Hensyn og begrensninger

Størrelsesbegrensninger

  • Det kan være opptil 1 000 variabler og opptil 1 000 verdisett, så lenge du oppfyller begge disse kravene:

    • Det totale antallet celler i de alternative verdisettene er mindre enn 10 000.
    • Varens størrelse overskrider ikke 1 MB.

    Disse kravene valideres når du lagrer endringer.

  • Notatfeltet kan ha opptil 2 048 tegn.

  • Beskrivelsesfeltet for verdisettet kan ha opptil 2 048 tegn.

Begrensninger for alternative verdisett

  • Alternative verdisett i et variabelbibliotek vises i den rekkefølgen du la dem til. For øyeblikket kan du ikke endre rekkefølgen på dem i brukergrensesnittet. Hvis du vil endre rekkefølgen, redigerer du JSON-filen direkte.
  • Navnet på hvert verdisett må være unikt i et variabelbibliotek.
  • Variabelnavn må være unike i et variabelbibliotek. Du kan ha to variabler med samme navn i et arbeidsområde hvis de er i forskjellige elementer.
  • Det er alltid én (og bare én) aktiv verdi angitt i et variabelbibliotek om gangen. Du kan ikke slette et verdisett mens det er aktivt. Hvis du vil slette den, må du først konfigurere en annen verdi som er satt til å være aktiv. Du kan ha en annen aktiv verdi angitt for hver fase i et utrullingssamlebånd.
  • Last updated on