Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Switch-Aktivität in Microsoft Fabric funktioniert wie eine Switch-Anweisung in einer Programmiersprache. Er wertet einen Ausdruck aus, bringt das Ergebnis mit einem Fall in Übereinstimmung und führt die Aktivitäten in diesem Fall aus.
Voraussetzungen
Bevor Sie beginnen, erfüllen Sie diese Voraussetzungen:
- Sie benötigen Zugriff auf einen Microsoft Fabric-Mandanten mit einer bereitgestellten Kapazität. Sie können Fabric mit einer kostenlosen Testversion testen.
- Ein Fabric-Arbeitsbereich , der dieser Kapazität zugewiesen ist.
Eine Switch-Aktivität zu einer Pipeline in der Benutzeroberfläche hinzufügen
Führen Sie die folgenden Schritte aus, um eine Switch-Aktivität hinzuzufügen:
- Switch-Aktivität erstellen
- Festlegen des Auswertungsausdrucks und der Fälle für die Switch-Aktivität
- Konfigurieren der Fallaktivitäten
Die Switch-Aktivität erstellen
Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.
Suchen Sie in der Symbolleiste " Pipelineaktivitäten " nach "Wechseln", und wählen Sie sie aus, um sie dem Zeichenbereich hinzuzufügen. Wenn sie nicht angezeigt wird, wählen Sie aus + , um die Aktivitätsliste zu erweitern.
Wählen Sie die neue Switch-Aktivität auf der Leinwand aus, wenn sie noch nicht ausgewählt ist.
Ausführliche Informationen zur Registerkarte " Allgemein " finden Sie unter "Allgemeine Einstellungen".
Festlegen des Auswertungsausdrucks und der Fälle für die Switchaktivität
Wählen Sie die Registerkarte "Aktivitäten " aus. Der Standardfall ist bereits in der Fallliste enthalten.
Geben Sie im Ausdruck den Wert ein, den die Switchaktivität auswerten soll. Sie können dynamische Inhalte wie Parameter, Systemvariablen, Funktionen und lokale Variablen verwenden.
Informationen zu unserer Ausdruckssprache und den unterstützten Funktionen finden Sie in der Ausdruckssprachen-Übersicht.
So konfigurieren Sie, was in jedem Fall ausgeführt wird:
- Wählen Sie auf der Registerkarte "Aktivitäten " das Stiftsymbol neben einem Fall aus.
- Fügen Sie die Aktivitäten hinzu, die ausgeführt werden sollen, wenn dieser Fall dem Ausdruck entspricht.
- Wenn Sie weitere Fälle hinzufügen möchten, wählen Sie + Fall hinzufügen.
Sie können auch Fälle hinzufügen und Aktivitäten auf der Switch-Aktivitätskarte im Pipeline-Zeichenbereich konfigurieren, indem Sie + oder das Stiftsymbol neben jedem Fall auswählen.
Konfigurieren der Fallaktivitäten
Wenn Sie das Bleistiftsymbol für einen Fall auswählen, öffnet Fabric den Editor für Fallaktivitäten. Dieser Editor sieht wie der Pipeline-Editor aus, gilt aber nur für den ausgewählten Fall.
Fügen Sie die Aktivitäten hinzu, die Sie für diesen Fall ausführen möchten. In diesem Beispiel enthält der Standardfall eine Kopieraktivität. Fabric führt diese Copy-Aktivität aus, wenn kein anderer Fall mit dem Ausdruck übereinstimmt.
In der oberen linken Ecke des Fallaktivitäten-Editors können Sie die aktuelle Pipeline und den aktuellen Fall sehen. Wenn Sie fertig sind, wählen Sie den Pipelinenamen aus, um zum Hauptpipeline-Editor zurückzukehren.
Speichern und Ausführen oder Planen der Pipeline
Wechseln Sie oben im Pipeline-Editor zur Registerkarte " Start ", und wählen Sie die Schaltfläche "Speichern" aus, um Ihre Pipeline zu speichern. Wählen Sie "Ausführen" aus, um sie direkt auszuführen, oder planen Sie die Ausführung zu bestimmten Zeiten oder Intervallen. Weitere Informationen zu Pipelineausführungen finden Sie unter: Pipelineausführungen planen.
Nach dem Ausführen können Sie die Ausführung der Pipeline überwachen und den Ausführungsverlauf über die Registerkarte Ausgabe unterhalb des Zeichenbereichs anzeigen.
Einfaches Beispiel
In diesem Beispiel wird die Datenverarbeitung basierend auf einem Pipelineparameter mit dem Namen v_string_inputweitergeleitet.
Unsere Switch-Aktivität ROYGBIV switch bewertet den Wert von v_string_input und führt die Aktivitäten in dem Fall aus, der diesem Wert entspricht. Wenn keine Übereinstimmung vorhanden ist, wird keine Aktivität ausgeführt, da der Standardfall leer ist.
In diesem Beispiel gibt es sieben Fälle, eine für jede Farbe (Rot, Orange, Gelb, Grün, Blau, Indigo, Violett). Jeder Fall enthält eine einzelne Set-Variable-Aktivität, die den Wert von v_output auf den Namen der Farbe in diesem Fall zuweist. Der Ausdruck ist eine einfache Aufnahme des Eingabeparameters v_string_inputin dieser Instanz @pipeline().parameters.v_string_input, kann jedoch ein beliebiger Ausdruck sein, der zu einem Wert ausgewertet wird.
Wenn wir die Pipeline laufen lassen, geben wir einen Wert für die v_string_input ein. Wenn wir "blue" eingeben, wertet die Switch-Aktivität diesen Ausdruck aus, vergleicht es mit dem Fall "Blau" und führt die Aktivität in diesem Fall aus, die v_output auf "Blau" setzt. Wenn wir "lime" eingeben, gibt es keinen passenden Fall, sodass die Switch-Aktivität den Standardfall ausführt, der keine Aktion ausführt.
Nach einer erfolgreichen Ausführung der Pipeline mit "blau" als Eingabe können wir in der Ausgabe der Set-Variablenaktivität im Fall "Blau" sehen, dass v_output auf "Blau" festgelegt wurde, und dies bestätigt, dass die Switch-Aktivität den Ausdruck ausgewertet und den richtigen Fall ausgeführt hat.
