Del via

Brug Fabric-variabelbiblioteker i Dataflow Gen2

Notat

For mere information om, hvordan du kan udnytte denne kapacitet i continuous integration / continuous deployment (CI/CD) scenarier, sørg for at læse artiklen om CI/CD- og ALM-løsningsarkitekturer for Dataflow Gen2 samt end-to-end vejledningen om variabelreferencer i et dataflow.

Strukturvariabelbiblioteker tilbyder en centraliseret måde at administrere konfigurationsværdier på tværs af Microsoft Fabric-arbejdsbelastninger. Med den nye integration i Dataflow Gen2 kan du referere til disse variabler direkte i dit dataflow, hvilket muliggør dynamisk funktionsmåde på tværs af miljøer og forenkler CI/CD-arbejdsprocesser.

Forudsætninger

Hvis du vil bruge Fabric-variabelbiblioteker i Dataflow Gen2, skal du sikre følgende:

Referencevariabler ved brug af input-widgets

Dataflow Gen2-dialoger inkluderer en input-widget, der lader dig vælge, hvordan du indtaster en feltværdi. I understøttede dialoger kan du vælge variabler ved at bruge denne widget.

Skærmbillede af input-widgetten i en filter-række-dialog, der viser de mange tilgængelige muligheder for input.

Notat

For at bruge input-widgetten, vælg Altid tillad under fanen View i båndet, i Parameters-gruppen. Skærmbillede af altid tillat-afkrydsningsboksen i fanen Vis på båndet for at aktivere input-widgetten.

Nogle dialoger understøtter input-widget-oplevelsen og Fabric-variabelbiblioteker, herunder:

Når du vælger variabelindstillingen i input-widgetten, vises variabelvælger-dialogen. I denne dialog kan du gennemse dine variabelbiblioteker og de variabler, de indeholder.

Skærmbillede af dialogen for vælg variable, der viser alle tilgængelige biblioteker og variabler i det aktuelle arbejdsområde.

Efter du har valgt en variabel, viser dialogen biblioteket og variabelnavnet, så du kan bekræfte dit valg, før du committerer.

Skærmbillede af en variabel med navnet Ceiling fra biblioteket Mit bibliotek vist som valgt i filter-rækker-dialogen.

Notat

Ikke alle Dataflow-oplevelser understøtter input-widgetten. For ikke-understøttede oplevelser eller brugerdefinerede scenarier, brug variablefunktionerne manuelt.

Variable funktioner

Inde i din Dataflow Gen2 kan du referere til en variabel ved at bruge en af følgende funktioner:

Den identifikator, du sender til en af funktionerne, skal bruge følgende format:

$(/**/LibraryName/VariableName)

Følgende eksempler antager et variabelbibliotek kaldet My Library og en strengvariabel kaldet My Variable:

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

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

At bruge en standardværdi gennem Variable.ValueOrDefault hjælper med at sikre, at din formel løses, selv når du kopierer eller flytter din løsning til et andet miljø, der ikke har det refererede variabelbibliotek.

Tips

Gem hver variabel som en separat forespørgsel, der ikke kræver staging. Denne tilgang lader dig bruge disse værdier i dialoger, der understøtter forespørgselsinputtet , og hjælper med at bevare et organiseret overblik over variabler i din dataflow.

Overvejelser og begrænsninger

På følgende liste beskrives vigtige begrænsninger og funktionsmåder, du skal være opmærksom på, når du bruger Fabric-variabelbiblioteker med Dataflow Gen2. Disse begrænsninger påvirker, hvordan variabler refereres, evalueres og anvendes under design og kørsel.

  • Arbejdsområdeomfang: Variabelbiblioteker skal være placeret i det samme arbejdsområde som Dataflow Gen2 med CI/CD.

  • Referenceplacering: Variabler kan kun bruges i mashup.pq-filen i en Dataflow Gen2 med CI/CD.

  • Kørselsadfærd: Variabelværdier hentes ved starten af en kørselsoperation og bevares gennem hele operationen. Ændringer i et bibliotek under en Dataflow-kørsel stopper eller påvirker ikke det gennemløb.

  • Brug af en standardværdi: Når du bruger en standardværdi via funktionen Variable.ValueOrDefault, skal du sørge for, at datatypen for standardværdien stemmer overens med datatypen for den variabel, der refereres til.

  • Understøttede typer: Kun variabler af grundlæggende typer understøttes (boolean, datetime, guid, integernumber, og string).

  • Faste forbindelser: Variabler kan ikke ændre forbindelsesoplysninger. Forbindelser forbliver fast til de oprettede ressourcestikonfigurationer.

  • Tilsidesæt risiko: Brugere med adgang til at ændre variabelbiblioteker kan tilsidesætte variabelværdier, hvilket potentielt kan påvirke dataflowoutput.

  • Skematilknytning: Variabler kan ikke ændre destinationsskematilknytninger. Tilknytninger følger den oprettede opsætning.

  • Synlighed af afstamning: Afstamningsvisninger viser ikke links mellem Dataflow Gen2 og de variabelbiblioteker, der refereres til.

  • Last updated on