Del via

Brug switch-aktiviteten til betinget at forgrene udførelsen i en pipeline

Switch-aktiviteten i Microsoft Fabric fungerer som en switch-sætning i et programmeringssprog. Den evaluerer et udtryk, matcher resultatet med et tilfælde og kører aktiviteterne i det tilfælde.

Forudsætninger

Før du begynder, skal du opfylde disse forudsætninger:

Tilføj en switch-aktivitet til en pipeline i UI'en

For at tilføje en switch-aktivitet skal du gennemføre disse trin:

  1. Opret switch-aktiviteten
  2. Sæt evalueringsudtrykket og cases for switch-aktiviteten
  3. Konfigurér sagsaktiviteterne

Opret switch-aktiviteten

  1. Opret en ny pipeline i dit arbejdsområde.

  2. I pipeline-værktøjslinjen Aktiviteter , søg efter Switch, og vælg den derefter for at tilføje den til lærredet. Hvis du ikke kan se den, vælg + at udvide aktivitetslisten.

    Skærmbillede af Fabric UI med Aktiviteter-panelet og switch-aktiviteten markeret.

  3. Vælg den nye switch-aktivitet på lærredet, hvis den ikke allerede er valgt.

    Skærmbillede, der viser fanen Generelle indstillinger for switch-aktiviteten.

For detaljer om fanen Generelt , se Generelle indstillinger.

Sæt evalueringsudtrykket og cases for switch-aktiviteten

Vælg fanen Aktiviteter . Standard-sagen er allerede på sagslisten.

I Expression indtastes værdien, som switch-aktiviteten skal evaluere. Du kan bruge dynamisk indhold såsom parametre, systemvariabler, funktioner og lokale variable.

For information om vores udtryksprog og understøttede funktioner, se oversigten over udtrykssprog.

For at konfigurere, hvad hver case kører:

  1. På fanen Aktiviteter skal du vælge blyantikonet ved siden af en kasse.
  2. Tilføj de aktiviteter, der skal køre, når det tilfælde matcher Expression.
  3. For at tilføje flere sager, vælg + Tilføj sag.

Du kan også tilføje sager og konfigurere aktiviteter fra skifteaktivitetskortet på pipeline-lærredet ved at vælge + eller bruge blyantikonet ved siden af hver sag.

Skærmbillede, der viser fanen for skifteaktivitetsindstillinger, der fremhæver fanen, og hvor man vælger en ny forbindelse.

Konfigurér sagsaktiviteterne

Når du vælger blyantikonet for en sag, åbner Fabric case-aktivitetseditoren. Denne editor ligner pipeline-editoren, men den gælder kun for det valgte tilfælde.

Tilføj de aktiviteter, du vil køre i den sag. I dette eksempel indeholder Standard-tilfældet en Kopi-aktivitet. Fabric kører denne Copy-aktivitet, når ingen andre tilfælde matcher Expression-resultatet .

Skærmbillede, der viser ruden sagsaktivitetseditor for standardcasen med en eksempel på en kopiaktivitet, der er føjet til den.

I øverste venstre hjørne af case activities-editoren kan du se den aktuelle pipeline og case. Når du er færdig, vælger du pipelinenavnet for at vende tilbage til hovedpipeline-editoren.

Gem og kør eller planlæg pipelinen

Skift til fanen Hjem øverst i pipeline-editoren og vælg gem-knappen for at gemme din pipeline. Vælg Kør for at køre direkte eller Skemalæg for at planlægge løb på bestemte tidspunkter eller intervaller. For mere information om rørledningskørsler, se: planlæg rørledningskørsler.

Skærmbillede, der viser fanen Hjem i pipelineeditoren med tabulatornavnet, knapperne Gem, Kør og Planlæg fremhævet.

Efter kørsel kan du overvåge pipeline-udførelsen og se kørselshistorik fra fanen Output under lærredet.

Grundlæggende eksempel

Dette eksempel ruter databehandling baseret på en pipelineparameter kaldet v_string_input.

Vores switch-aktivitet ROYGBIV switch vurderer værdien af v_string_input og kører aktiviteterne i det tilfælde, der matcher denne værdi. Hvis der ikke er et match, kører den ingen aktivitet, da standard-caset er tomt.

Der er syv tilfælde i dette eksempel, én for hver farve (rød, orange, gul, grøn, blå, indigo, violet). Hvert tilfælde indeholder en enkelt aktivitetsaktivitet med Set-variablen , der sætter værdien af v_output til farvens navn i det pågældende tilfælde. Udtrykket er et simpelt indtag af inputparameteren v_string_input, i dette tilfælde @pipeline().parameters.v_string_input, men det kan være ethvert udtryk, der evalueres til en værdi.

Skærmbillede, der viser eksempler på Set-variabelaktiviteter, der bruges til at forberede værdier før switch-evaluering.

Når vi kører pipelinen, indtaster vi en værdi for .v_string_input Hvis vi indtaster "blå", evaluerer switch-aktiviteten udtrykket, matcher det med "Blå"-tilfældet og kører aktiviteten i det tilfælde, som sættes v_output til "Blå". Hvis vi indtaster "lime", er der ikke noget matchende tilfælde, så switch-aktiviteten kører Standard-tilfældet, som ikke gør noget.

Skærmbillede, der viser pipeline-kørsel input med parameterværdier brugt af switch-udtrykket. Inputtet er 'blå' i dette eksempel.

Efter en vellykket kørsel af pipelinen med "blue" som input, kan vi se i outputtet af aktiviteten i Set-variablen i "Blue"-tilfældet, der v_output var sat til "Blue", hvilket bekræfter, at switch-aktiviteten evaluerede udtrykket og kørte det korrekte tilfælde.

Skærmbillede, der viser et vellykket pipeline-kørselseksempel efter evaluering af switch-tilfælde, der viser, at den korrekte (blå) aktivitet blev kørt efter et input af blå.

Relateret indhold

  • Last updated on