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.
Verwenden Sie die Set Variable-Aktivität, um den Wert einer vorhandenen Variablen vom Typ String, Bool oder Array festzulegen, die in einer Pipeline in Data Factory für Microsoft Fabric definiert ist, oder verwenden Sie die Set Variable-Aktivität, um einen Pipeline-Rückgabewert festzulegen. Pipelinevariablen können verwendet werden, um alle Ergebnisse oder Daten nachzuverfolgen, auf die Sie stoßen, und die Sie später bei der Ausführung der Pipeline erneut verwenden oder als Ergebnis zurückgeben können.
Die Verwendungsszenarien für die Aktivität "Variable festlegen" können je nach Ihren Anforderungen stark variieren. Sie können z. B. einen bestimmten Pfad verwenden, wenn die Anzahl der Zeilen oder des Aggregatwerts aus einem Feld in zuvor zurückgegebenen Daten größer oder kleiner als eine bestimmte Menge ist, aber möglicherweise später in Ihrer Pipeline den alternativen Pfad auswählen muss, nachdem mehrere andere Schritte, die immer erforderlich sind, abgeschlossen sind. Mithilfe einer Pipelinevariable können Sie das Ergebnis in einer Variablen speichern und dann später verwenden, um je nach Wert der Variablen den alternativen Pfad auszuwählen. Sie können auch die Set Variable-Aktivität verwenden, um einen Pipeline-Rückgabewert festzulegen, der aus einer oder mehreren Komponentenvariablen besteht. Dies kann in nachfolgenden Pipelines verwendet werden, die die Ausgabe deiner Pipeline nutzen.
Voraussetzungen
Um zu beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:
- Ein Mandantenkonto mit einem aktiven Microsoft Fabric-Abonnement. Sie können Fabric mit einer kostenlosen Testversion testen.
- Ein Fabric-Arbeitsbereich.
Hinzufügen einer Set Variable-Aktivität zu einer Pipeline mit Benutzeroberfläche
Führen Sie die folgenden Schritte aus, um die Aktivität „Variable festlegen“ in einer Pipeline zu verwenden:
Erstellen der Aktivität
Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.
Suchen Sie im Bereich Pipelineaktivitäten nach Variable festlegen, und wählen Sie sie aus, um sie dem Pipelinezeichenbereich hinzuzufügen. Möglicherweise müssen Sie die Liste der verfügbaren Aktivitäten über die Dropdownschaltfläche + ganz rechts auf der Symbolleiste erweitern, wenn die Fenstergröße nicht groß genug ist, um sie direkt anzuzeigen.
Wählen Sie die neue Aktivität im Zeichenbereich aus, wenn sie noch nicht ausgewählt ist.
Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen-Anleitung.
Festlegen von Variableneinstellungen
Auf der Registerkarte "Einstellungen " können Sie entweder eine Pipelinevariable auswählen oder einen Rückgabewert für die Pipeline direkt angeben. In diesem Beispiel wird ein einzelner Rückgabewert namens "MyVariable" mit einem Zeichenfolgendatentyp und dem Wert "Some value" gezeigt.
Sie können mehrere Werte für den Pipeline-Rückgabewert hinzufügen, indem Sie die Schaltfläche +Neu (oder die Schaltfläche " Löschen ", um sie zu entfernen) verwenden. Ebenso können Sie beim Festlegen einer Pipelinevariablen alle zuvor definierten Variablen aus dem Dropdownfeld "Name " auswählen oder neue(n) Variablen mit der Schaltfläche +Neu hinzufügen. Wenn Sie Pipelinevariablen unabhängig von der Set Variable-Aktivität erstellen möchten, wählen Sie den Hintergrund im Pipelinebereich aus (um die Pipelineeigenschaftenseiten anzuzeigen), und verwenden Sie dann die Registerkarte "Variablen " in den Pipelineeinstellungen, um sie zu erstellen. Anschließend können Sie sie aus der Dropdown-Liste in den Variableneinstellungen auswählen, wenn Sie die Pipelinevariable wählen.
Speichern und Ausführen oder Planen der Pipeline
Obwohl "Variable festlegen" in der Regel mit anderen Aktivitäten verwendet wird, kann sie wie folgt direkt ausgeführt werden.
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.