Teilen über

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

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tip

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.

Pipeline scope

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

Variable Name Description
@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 tatsächlich ausgelöst wurde, um den Pipeline-Lauf zu starten, und er kann geringfügig vom geplanten Zeitpunkt des Triggers 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().

Note

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.

Variable Name Description
@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. Dies kann sich geringfügig vom geplanten Zeitpunkt des Auslösers unterscheiden.

Bereich „Trigger mit rollierendem Fenster“

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

Variable Name Description
@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. Dies kann geringfügig von der geplanten Triggerzeit abweichen.

Bereich des Speicherereignisauslösers

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

Variable Name Description
@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.

Note

Wenn Sie Ihre Pipeline in Azure Synapse Analytics erstellen und auslösen, 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.

Note

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

Variable Name Description
@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 Daten. 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.

Note

Wenn Sie Ihre Pipeline und Trigger in Azure Synapse Analytics erstellen, müssen Sie @trigger().outputs.body.event als Parameter verwenden. Diese Eigenschaft erfasst Ereignisinformationen. Verwenden Sie diese Eigenschaft anstelle von @triggerBody().event.

Related content

  • Last updated on