Del via

Bruk Fabric-variabelbiblioteker i Dataflow Gen2

Note

For mer informasjon om hvordan du kan utnytte denne funksjonaliteten i kontinuerlig integrasjon / kontinuerlig distribusjon (CI/CD)-scenarier, sørg for å lese artikkelen om CI/CD- og ALM-løsningsarkitekturer for Dataflow Gen2 og ende-til-ende-veiledningen om variabelreferanser i en Dataflow.

Strukturvariabelbiblioteker tilbyr en sentralisert måte å administrere konfigurasjonsverdier på tvers av Microsoft Fabric-arbeidsbelastninger. Med den nye integrasjonen i Dataflow Gen2 kan du referere til disse variablene direkte i dataflyten, noe som muliggjør dynamisk virkemåte på tvers av miljøer og forenkler CI/CD-arbeidsflyter.

Forutsetninger

Hvis du vil bruke Fabric-variabelbiblioteker i Dataflow Gen2, må du kontrollere følgende:

Referansevariabler ved bruk av input-widgets

Dataflow Gen2-dialoger inkluderer en inndatawidget som lar deg velge hvordan du skal legge inn en feltverdi. I støttede dialoger kan du velge variabler ved å bruke denne widgeten.

Skjermbilde av input-widgeten i en filterrader-dialog som viser de mange tilgjengelige alternativene for input.

Note

For å bruke input-widgeten, velg Always allow under Vis-fanen i båndet i Parameters-gruppen. Skjermbilde av alltid tillat-avkrysningsboksen i Vis-fanen på båndet for å aktivere inndatawidgeten.

Noen dialoger støtter input-widget-opplevelsen og Fabric-variabelbibliotekene, inkludert:

Når du velger variabelalternativet i input-widgeten, vises variabelvelger-dialogen. I denne dialogen kan du bla gjennom variabelbibliotekene dine og variablene de inneholder.

Skjermbilde av velg-variabel-dialogen som viser alle tilgjengelige biblioteker og variabler i det nåværende arbeidsområdet.

Etter at du har valgt en variabel, viser dialogen biblioteket og variabelnavnet slik at du kan bekrefte valget ditt før du committerer.

Skjermbilde av en variabel med navnet Ceiling fra biblioteket Biblioteket mitt vist som valgt i filterrad-dialogen.

Note

Ikke alle Dataflow-opplevelser støtter input-widgeten. For ikke-støttede opplevelser eller tilpassede scenarioer, bruk variabelfunksjonene manuelt.

Variable funksjoner

Inne i Dataflow Gen2 kan du referere til en variabel ved å bruke en av følgende funksjoner:

Identifikatoren du sender til en av funksjonene må bruke følgende format:

$(/**/LibraryName/VariableName)

Følgende eksempler antar et variabelbibliotek kalt My Library og en strengvariabel kalt My Variable:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Å bruke en standardverdi gjennom Variable.ValueOrDefault hjelper med å sikre at formelen din løses selv når du kopierer eller flytter løsningen til et annet miljø som ikke har det refererte variabelbiblioteket.

Tips

Lagre hver variabel som en separat spørring som ikke krever staging. Denne tilnærmingen lar deg bruke disse verdiene i dialoger som støtter spørringsinput , og hjelper til med å holde en organisert oversikt over variablene i dataflyten din.

Hensyn og begrensninger

Listen nedenfor skisserer viktige begrensninger og virkemåter du må huske på når du bruker Fabric-variabelbiblioteker med Dataflow Gen2. Disse begrensningene påvirker hvordan variabler refereres, evalueres og brukes under utforming og kjøretid.

  • Arbeidsområdeomfang: Variabelbiblioteker må ligge i samme arbeidsområde som Dataflow Gen2 med CI/CD.

  • Referanseplassering: Variabler kan bare brukes i mashup.pq-filen til en Dataflow Gen2 med CI/CD.

  • Kjøretidsatferd: Variabelverdier hentes ved starten av en kjøreoperasjon og beholdes gjennom hele operasjonen. Endringer i et bibliotek under en Dataflow-kjøring stopper eller påvirker ikke den kjøringen.

  • Bruke en standardverdi: Når du bruker en standardverdi via funksjonen Variable.ValueOrDefault, må du kontrollere at datatypen for standardverdien samsvarer med datatypen for den refererte variabelen.

  • Støttede typer: Bare variabler av grunnleggende typer støttes (boolean, datetime, guid, integernumber, og string).

  • Faste tilkoblinger: Variabler kan ikke endre tilkoblingsinformasjon. Tilkoblinger forblir faste til de opprettede ressursbanekonfigurasjonene.

  • Overstyr risiko: Brukere med tilgang til å endre variabelbiblioteker kan overstyre variabelverdier, noe som potensielt kan påvirke dataflytutdata.

  • Skjematilordning: Variabler kan ikke endre målskjematilordninger. Tilordninger følger det redigerte oppsettet.

  • Avstammingssynlighet: Avstammingsvisninger viser ikke koblinger mellom Dataflow Gen2 og variabelbibliotekene den refererer til.

  • Last updated on