Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Du kan få flere oplysninger om, hvordan du udnytter denne funktion i CI/CD-scenarier (kontinuerlig integration/kontinuerlig udrulning), ved at læse artiklen om CI/CD- og ALM-løsningsarkitekturer til Dataflow Gen2 og det komplette selvstudium om parameteriseret dataflow Gen2.
Parametre i Dataflow Gen2 giver dig mulighed for dynamisk at styre og tilpasse dataflow, hvilket gør dem mere fleksible og kan genbruges ved at aktivere forskellige input og scenarier uden at ændre selve dataflowet. Det hjælper med at holde tingene organiseret ved at reducere behovet for flere dataflow og centralisere kontrolelementet i et enkelt parameteriseret dataflow.
Offentlige parametre i Dataflow Gen2 er en ny tilstand, hvor du kan tillade, at dit dataflow køres ved at overføre parameterværdier uden for Power Query-editoren via Fabric REST API eller via oprindelige Fabric-oplevelser. Det giver dig mulighed for at få en mere dynamisk oplevelse med dit dataflow, hvor hver kørsel kan aktiveres med forskellige parametre, der påvirker, hvordan dit dataflow kører.
Prerequisites
- En Dataflow Gen2 med CI/CD-understøttelse
- Parametre skal angives i dit dataflow.Få mere at vide om, hvordan du angiver forespørgselsparametre i Dataflow.
Aktivér tilstanden for offentlige parametre
Som ejer af dataflowet skal du åbne dataflowet. På fanen Hjem på båndet skal du vælge knappen Indstillinger .
Hvis du vælger knappen, åbnes en ny dialogboks med indstillinger . I den lodrette menu skal du vælge indstillingen med etiketten Parametre i dataflowgruppen . I afsnittet Parametre kan du aktivere den indstilling, der læser "Aktivér, at parametre registreres og tilsidesættes for udførelse" for at aktivere tilstanden for offentlige parametre.
Vælg knappen OK for at bekræfte disse ændringer.
Når denne tilstand er aktiveret, får du en meddelelse i dialogboksen Administrer parametre , hvor der står "Offentlig parametertilstand er aktiveret" øverst i dialogboksen.
Når den offentlige parametertilstand er aktiveret, kan du gemme dit dataflow.
Overfør brugerdefinerede parameterværdier for dataflowkørsler
Den offentlige parametertilstand følger definitionen af parametrene i dataflowet, hvor der skelnes mellem obligatoriske og ikke-krævede parametre.
- Påkrævede parametre: Hvis en parameter er angivet som påkrævet, skal der overføres en værdi til kørselsjobbet for at køre dataflowet. Kørslen mislykkes, hvis der ikke overføres en værdi for en parameter, der er angivet til påkrævet.
- Ikke-påkrævede parametre: Disse kaldes også valgfrie parametre, og der kræves ingen værdi, der skal videregives, for at en kørsel kan udløses. Hvis der ikke overføres nogen værdi, bruges den aktuelle værdi , der er defineret i parameteren, til kørsel.
Brug dataflowaktiviteten i pipelines
Note
Vi anbefaler, at du læser mere om dataflowaktiviteten fra Fabric-pipelines for at forstå alle dens funktioner.
Når du opretter en pipeline i Fabric, kan du bruge dataflowaktiviteten til at udløse kørslen af et dataflow Gen2 med CI/CD-understøttelse, hvor tilstanden for offentlige parametre er aktiveret.
Du kan vælge det dataflow, du vil bruge, og angive de parametre, du vil bruge, i sektionen Dataflowparametre .
I sektionen Dataflowparametre kan du se alle parametre, der er tilgængelige i dit dataflow, og standardværdien fra hver af dem i værdisektionen.
Påkrævede parametre har en stjerne ud for deres navn, mens valgfrie parametre ikke har. Samtidig kan valgfrie parametre fjernes fra gitteret, hvorimod påkrævede parametre ikke kan slettes, og der skal overføres en værdi, for at dataflowet kan køre.
Du kan vælge opdateringsknappen for at anmode om de nyeste parameteroplysninger fra dit dataflow.
Understøttede parametertyper
Tips
Læs og brug parameteren REST API for opdagelse af dataflow. Dokumentationen indeholder alle tilgængelige parametertyper og deres forventede værdier, og REST API giver mulighed for at hente parameteroplysningerne fra dit dataflow.
I følgende tabel vises de aktuelt understøttede parametertyper og linket til REST API-definitionen, så den kan forstå, hvilke værdier der forventes af REST API'en.
| Parametertype for dataflow | Definition af REST API |
|---|---|
| Tekst | DataflowStringParameter |
| Heltal (int64) | DataflowIntegerParameter |
| Decimaltal | DataflowNumberParameter |
| Dato | DataflowDateParameter |
| Datetime | DataflowDateTimeParameter |
| Time | DataflowTimeParameter |
| DateTimeZone | DataflowDateTimeZoneParameter |
| Duration | DataflowDurationParameter |
| Sandt/falsk | DataflowBooleanParameter |
Overvejelser og begrænsninger
Følgende er en liste over alle overvejelser og begrænsninger, når du bruger tilstanden for offentlige parametre i Dataflow Gen2 med CI/CD:
- Planlægning og manuel udløsning: Dataflow med offentlige parametre kan ikke planlægges eller udløses manuelt via Fabric, medmindre der ikke er angivet påkrævede parametre.
- Ikke-understøttet parameterisering: Parametre, der ændrer ressourcestier for kilder eller destinationer, understøttes ikke. Forbindelser er rettet til den oprettede sti.
- Trinvis opdatering: Ikke kompatibel med tilstanden for offentlige parametre.
- Logisk ændring: Offentlige parametre giver brugere med adgang adgang til at tilsidesætte værdier, hvilket potentielt kan ændre dataflowoutputtet.
- Overvågningshub: Overvågningshubben viser ikke de parameterværdier, der bruges under udførelsen.
- Midlertidig opførelse: Det er kun den seneste kørsel, der gemmes i Staging Lakehouse. Brug definerede destinationer til at bevare data.
- Duplikerede anmodninger: Hvis de samme parameterværdier sendes flere gange, accepteres kun den første anmodning, indtil den er fuldført.
- Skematilknytning: Parametre kan ikke ændre destinationsskematilknytninger. Alle tilknytninger følger den oprettede konfiguration. Se artiklen for at få flere oplysninger om datadestinationer og administrerede indstillinger i Dataflow Gen2.