Teilen über

Von Azure Data Factory und Azure Synapse Analytics unterstützte Systemvariablen

  • Artikel

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

Dieser Artikel beschreibt die Systemvariablen, die von Azure Data Factory und Azure Synapse unterstützt werden. Sie können diese Variablen in Ausdrücken verwenden, wenn Sie Entitäten in einem dieser Dienste definieren.

Bereich „Pipeline“

Auf diese Systemvariablen kann überall im Pipeline-JSON verwiesen werden.

Variablenname BESCHREIBUNG
@pipeline().DataFactory Name des Daten- oder Synapse-Arbeitsbereich, in dem die Pipelineausführung erfolgt
@pipeline().Pipeline Name der Pipeline
@pipeline().RunId ID der jeweiligen Pipelineausführung
@pipeline().TriggerType Der Typ des Triggers, der die Pipeline aufgerufen hat (z. B. ScheduleTrigger, BlobEventsTrigger). Eine Liste der unterstützten Triggertypen finden Sie unter Pipelineausführung und Trigger. Der Triggertyp Manual gibt an, dass die Pipeline manuell ausgelöst wurde.
@pipeline().TriggerId ID des Triggers, der die Pipeline aufgerufen hat
@pipeline().TriggerName Name des Triggers, der die Pipeline aufgerufen hat
@pipeline().TriggerTime Zeitpunkt der Triggerausführung, durch die die Pipeline aufgerufen wurde. Dies ist der Zeitpunkt, zu dem der Trigger zum Aufrufen der Pipelineausführung tatsächlich ausgelöst wurde. Er kann vom geplanten Zeitpunkt für den Trigger geringfügig abweichen.
@pipeline().GroupId ID der Gruppe, zu der die Pipelineausführung gehört.
@pipeline()?.TriggeredByPipelineName Name der Pipeline, die die Pipelineausführung auslöst. Gilt, wenn die Pipelineausführung durch eine ExecutePipeline-Aktivität ausgelöst wird. Wird in anderen Fällen als Null ausgewertet. Beachten Sie das Fragezeichen nach @pipeline().
@pipeline()?.TriggeredByPipelineRunId Ausführungs-ID der Pipeline, die die Pipelineausführung auslöst. Gilt, wenn die Pipelineausführung durch eine ExecutePipeline-Aktivität ausgelöst wird. Wird in anderen Fällen als Null ausgewertet. Beachten Sie das Fragezeichen nach @pipeline().

Hinweis

Triggerbezogene Systemvariablen für Datum/Uhrzeit (in Pipeline- und Triggerbereichen) geben UTC-Datumsangaben im ISO 8601-Format zurück, z. B. 2017-06-01T22:20:00.4061448Z.

Bereich „Plantrigger“

Auf diese Systemvariablen kann überall im Trigger-JSON für Trigger vom Typ ScheduleTrigger verwiesen werden.

Variablenname BESCHREIBUNG
@trigger().scheduledTime Zeitpunkt, zu dem der Trigger die Pipelineausführung planmäßig aufrufen sollte.
@trigger().startTime Zeitpunkt, zu dem der Trigger tatsächlich ausgelöst wurde, um die Pipelineausführung aufzurufen. Er kann vom geplanten Zeitpunkt für den Trigger geringfügig abweichen.

Bereich „Trigger mit rollierendem Fenster“

Auf diese Systemvariablen kann überall im Trigger-JSON für Trigger vom Typ TumblingWindowTrigger verwiesen werden.

Variablenname BESCHREIBUNG
@trigger().outputs.windowStartTime Anfang des Fensters, das der Triggerausführung zugeordnet wurde.
@trigger().outputs.windowEndTime Ende des Fensters, das der Triggerausführung zugeordnet wurde.
@trigger().scheduledTime Zeitpunkt, zu dem der Trigger die Pipelineausführung planmäßig aufrufen sollte.
@trigger().startTime Zeitpunkt, zu dem der Trigger tatsächlich ausgelöst wurde, um die Pipelineausführung aufzurufen. Er kann vom geplanten Zeitpunkt für den Trigger geringfügig abweichen.

Bereich des Speicherereignisauslösers

Auf diese Systemvariablen kann überall im Trigger-JSON für Trigger vom Typ BlobEventsTrigger verwiesen werden.

Variablenname BESCHREIBUNG
@triggerBody().fileName Name der Datei, deren Erstellung oder Löschung bewirkt hat, dass der Trigger ausgelöst wurde.
@triggerBody().folderPath Pfad zu dem Ordner, der die durch @triggerBody().fileNameangegebene Datei enthält. Das erste Segment des Ordnerpfads ist der Name des Azure Blob Storage-Containers.
@trigger().startTime Zeitpunkt, zu dem der Trigger ausgelöst wurde, um die Pipelineausführung aufzurufen.

Hinweis

Wenn Sie die Pipeline und den Trigger in Azure Synapse Analytics erstellen, müssen Sie @trigger().outputs.body.fileName und @trigger().outputs.body.folderPath als Parameter verwenden. Diese beiden Eigenschaften erfassen Blobinformationen. Verwenden Sie diese Eigenschaften anstelle von @triggerBody().fileName und @triggerBody().folderPath.

Triggerbereich für benutzerdefinierte Ereignisse

Auf diese Systemvariablen kann überall im Trigger-JSON für Trigger vom Typ CustomEventsTrigger verwiesen werden.

Hinweis

Der Dienst erwartet, dass benutzerdefinierte Ereignisse gemäß Azure Event Grid-Ereignisschema formatiert werden.

Variablenname BESCHREIBUNG
@triggerBody().event.eventType Hierbei handelt es sich um den Typ der Ereignisse, die die Ausführung des Triggers für benutzerdefinierte Ereignisse ausgelöst hat. Der Ereignistyp ist ein vom Kunden definiertes Feld und akzeptiert alle Werte vom Typ „string“ (Zeichenfolge).
@triggerBody().event.subject Hierbei handelt es sich um den Antragsteller des benutzerdefinierten Ereignisses, der den Trigger ausgelöst hat.
@triggerBody().event.data._keyName_ Hierbei handelt es sich um ein Datenfeld im benutzerdefinierten Ereignis, das Kunden zum Senden von Nachrichten und Daten verwenden können. Verwenden Sie „data.keyName“, um auf jedes Feld zu verweisen. Beispielsweise gibt „@triggerBody().event.data.callback().event.data.callback“ den Wert für das Feld callback (Rückruf) zurück, das unter data (Daten) gespeichert ist.
@trigger().startTime Zeitpunkt, zu dem der Trigger ausgelöst wurde, um die Pipelineausführung aufzurufen.

Zugehöriger Inhalt