Bruk svitsjaktiviteten til å betinget forgrene kjøringen i en pipeline

Switch-aktiviteten i Microsoft Fabric fungerer som en switch-setning i et programmeringsspråk. Den evaluerer et uttrykk, matcher resultatet med et tilfelle, og kjører aktivitetene i det tilfellet.

Forutsetninger

Før du begynner, må du fullføre disse forutsetningene:

• Du må ha tilgang til en Microsoft Fabric-leietaker med en provisjonert kapasitet. Du kan prøve Fabric med en gratis prøveperiode.
• Et Fabric-arbeidsområde tildelt den kapasiteten.

Legg til en switch-aktivitet i en pipeline i UI-en

For å legge til en bytteaktivitet, fullfør disse trinnene:

1. Lag bryteraktiviteten
2. Sett evalueringsuttrykket og tilfellene for bryteraktiviteten
3. Konfigurer saksaktivitetene

Lag bryteraktiviteten

1. Opprett et nytt datasamlebånd i arbeidsområdet.

2. I verktøylinjen for pipeline Aktiviteter , søk etter Switch, og velg den deretter for å legge den til på lerretet. Hvis du ikke ser den, velg + å utvide aktivitetslisten.

   

3. Velg den nye bryteraktiviteten på lerretet hvis den ikke allerede er valgt.

   

For detaljer under fanen Generelt , se Generelle innstillinger.

Sett evalueringsuttrykket og tilfellene for bryteraktiviteten

Velg fanen Aktiviteter . Standard-saken er allerede i sakslisten.

I Uttrykk, skriv inn verdien som switch-aktiviteten skal evaluere. Du kan bruke dynamisk innhold som parametere, systemvariabler, funksjoner og lokale variabler.

For informasjon om vårt uttrykksspråk og støttede funksjoner, se oversikten over uttrykksspråk.

For å konfigurere hva hver sak kjører:

1. På fanen Aktiviteter , velg blyantikonet ved siden av etuiet.
2. Legg til aktivitetene som skal kjøres når det tilfellet matcher Expression.
3. For å legge til flere etuier, velg + Legg til etui.

Du kan også legge til saker og konfigurere aktiviteter fra switch-aktivitetskortet på pipeline-lerretet ved å velge + eller bruke blyantikonet ved siden av hver sak.

Konfigurer saksaktivitetene

Når du velger blyantikonet for en sak, åpner Fabric case-aktivitetseditoren. Denne editoren ligner pipeline-editoren, men den gjelder kun for det valgte tilfellet.

Legg til aktivitetene du ønsker å gjennomføre i den saken. I dette eksempelet inneholder Standard-tilfellet en Kopier-aktivitet. Fabric kjører denne kopieringsaktiviteten når ingen andre tilfeller samsvarer med uttrykksresultatet.

Øverst til venstre i case-aktivitetseditoren kan du se den nåværende pipelinen og case. Når du er ferdig, velger du pipeline-navnet for å gå tilbake til hovedpipeline-editoren.

Lagre og kjøre eller planlegge datasamlebåndet

Bytt til Hjem-fanen øverst i pipeline-editoren og velg lagre-knappen for å lagre pipelinen din. Velg Kjør for å kjøre det direkte eller Planlegg for å planlegge løp til bestemte tider eller intervaller. For mer informasjon om rørledningskjøringer, se: planlegg rørledningskjøringer.

Etter kjøring kan du overvåke pipeline-kjøringen og se kjørehistorikk fra Output-fanen under lerretet.

Grunnleggende eksempel

Dette eksempelet ruter databehandling basert på en pipelineparameter kalt v_string_input.

Vår switch-aktivitet ROYGBIV switch evaluerer verdien av v_string_input og kjører aktivitetene i det tilfellet som matcher denne verdien. Hvis det ikke er noen match, kjører den ingen aktivitet, siden standardcaset er tomt.

Det er syv tilfeller i dette eksempelet, ett for hver farge (rød, oransje, gul, grønn, blå, indigo, fiolett). Hvert tilfelle inneholder en enkelt Set-variabelaktivitet som setter verdien til v_output navnet på fargen i det tilfellet. Uttrykket er et enkelt inntak av inputparameteren v_string_input, i dette tilfellet @pipeline().parameters.v_string_input, men det kan være hvilket som helst uttrykk som evalueres til en verdi.

Når vi kjører pipelinen, legger vi inn en verdi for .v_string_input Hvis vi skriver inn "blå", evaluerer bryteraktiviteten det uttrykket, matcher det med "Blå"-tilfellet, og kjører aktiviteten i det tilfellet, som settes v_output til "Blå". Hvis vi skriver inn "lime", finnes det ikke noe matchende tilfelle, så switch-aktiviteten kjører Standard-tilfellet, som ikke gjør noe.

Etter en vellykket kjøring av pipelinen med "blå" som input, kan vi se i utgangen av aktiviteten i Set-variabelen i "Blue"-tilfellet som v_output var satt til "Blue", noe som bekrefter at switch-aktiviteten evaluerte uttrykket og kjørte riktig tilfelle.

Relatert innhold

• Slik overvåker du datasamlebåndkjøringer