Udostępnij za pośrednictwem

System variables supported by Azure Data Factory and Azure Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Tip

Wypróbuj Data Factory w Microsoft Fabric, kompleksowe rozwiązanie analityczne dla przedsiębiorstw. Microsoft Fabric obejmuje wszystko, od przesyłania danych po naukę o danych, analizy w czasie rzeczywistym, analizy biznesowe i raportowanie. Dowiedz się, jak rozpocząć nową wersję próbną za darmo!

Ten artykuł opisuje zmienne systemowe obsługiwane przez Azure Data Factory i Azure Synapse. Możesz używać tych zmiennych w wyrażeniach podczas definiowania encji w dowolnej usłudze.

Pipeline scope

Zmienne systemowe można odwołać w dowolnym miejscu w pliku JSON potoku.

Nazwa zmiennej Opis
@pipeline().DataFactory Nazwa danych lub przestrzeni roboczej Synapse, w której uruchamiany jest przebieg potoku.
@pipeline().Pipeline Nazwa potoku
@pipeline().RunId ID konkretnego przebiegu potoku
@pipeline().TriggerType Typ wyzwalacza, który uruchomił potok (na przykład, ScheduleTrigger, BlobEventsTrigger). Aby uzyskać listę obsługiwanych typów wyzwalaczy, zobacz Wykonanie potoku i wyzwalacze. A trigger type of Manual indicates that the pipeline was triggered manually.
@pipeline().TriggerId Identyfikator wyzwalacza, który uruchomił potok
@pipeline().TriggerName Nazwa wyzwalacza, który uruchomił potok
@pipeline().TriggerTime Czas uruchomienia wyzwalacza, które uruchomiło potok. Jest to czas, w którym wyzwalacz rzeczywiście uruchomił wykonanie potoku, i może się nieznacznie różnić od zaplanowanego czasu wyzwalacza.
@pipeline().GroupId ID grupy, do której należy uruchomienie potoku.
@pipeline()?.UruchomionePrzezNazwaPipelinu Nazwa potoku, który wyzwala uruchomienie potoku. Ma zastosowanie, gdy uruchomienie potoku jest wyzwalane przez aktywność ExecutePipeline. Oceń jako Null, gdy używane w innych okolicznościach. Note the question mark after @pipeline()
@pipeline()?.TriggeredByPipelineRunId Identyfikator uruchomienia potoku, który inicjuje uruchomienie potoku. Ma zastosowanie, gdy uruchomienie potoku jest wywoływane przez aktywność ExecutePipeline. Należy ocenić jako Null, gdy używane w innych okolicznościach. Zwróć uwagę na znak zapytania po @pipeline()

Note

Trigger-related date/time system variables (in both pipeline and trigger scopes) return UTC dates in ISO 8601 format, for example, 2017-06-01T22:20:00.4061448Z.

Zakres wyzwalacza harmonogramu

Zmienne systemowe mogą być odwoływane w dowolnym miejscu w JSON obiektu wyzwalającego dla wyzwalaczy typu ScheduleTrigger.

Variable Name Opis
@trigger().scheduledTime Czas, o którym zaplanowano wyzwolenie uruchomienia procesu.
@trigger().startTime Czas, w którym wyzwalacz rzeczywiście uruchomił wykonanie potoku. To może nieznacznie różnić się od zaplanowanego czasu uruchomienia.

Zakres wyzwalacza dla okna przesuwnych

These system variables can be referenced anywhere in the trigger JSON for triggers of type TumblingWindowTrigger.

Variable Name Opis
@trigger().outputs.windowStartTime Początek okna powiązanego z uruchomieniem wyzwalacza.
@trigger().outputs.windowEndTime Koniec okna powiązanego z wykonaniem wyzwalacza.
@trigger().scheduledTime Czas, w którym zaplanowano wyzwalacz do uruchomienia przebiegu potoku.
@trigger().startTime Moment, w którym wyzwalacz rzeczywiście uruchomił działanie potoku. Może się to nieznacznie różnić od zaplanowanego czasu uruchomienia.

Zakres wyzwalania zdarzenia magazynowania

Te zmienne systemowe mogą być odwoływane w dowolnym miejscu w obiekcie JSON wyzwalacza dla wyzwalaczy typu BlobEventsTrigger.

Nazwa Zmiennej Opis
@triggerBody().fileName Nazwa pliku, którego utworzenie lub usunięcie spowodowało uruchomienie wyzwalacza.
@triggerBody().folderPath Ścieżka do folderu zawierającego plik określony przez @triggerBody().fileName. Pierwszy segment ścieżki folderu to nazwa kontenera Azure Blob Storage.
@trigger().startTime Moment, w którym wyzwalacz uruchomił wykonanie potoku.

Uwaga

Jeśli tworzysz swoją potok i wyzwalacz w Azure Synapse Analytics, musisz używać @trigger().outputs.body.fileName i @trigger().outputs.body.folderPath jako parametrów. Te dwie właściwości przechwytują informacje o blobach. Użyj tych właściwości zamiast używać @triggerBody().fileName i @triggerBody().folderPath.

Zakres niestandardowego wyzwalacza zdarzeń

Te zmienne systemowe mogą być odniesione w dowolnym miejscu w pliku JSON wyzwalacza dla wyzwalaczy typu CustomEventsTrigger.

Notatka

The service expects custom events to be formatted with Azure Event Grid event schema.

Variable Name Opis
@triggerBody().event.eventType Rodzaj zdarzeń, które uruchomiły niestandardowy wyzwalacz zdarzeń. Typ zdarzenia jest polem definiowanym przez klienta i może przyjmować dowolne wartości typu string.
@triggerBody().event.subject Temat niestandardowego zdarzenia, które spowodowało uruchomienie wyzwalacza.
@triggerBody().event.data._keyName_ Pole danych w niestandardowym zdarzeniu to dostępny blob JSON, którego klient może użyć do przesyłania wiadomości i danych. Proszę użyć data.keyName, aby odwołać się do każdego pola. Na przykład @triggerBody().event.data.callback zwraca wartość dla pola callback przechowywanego w data.
@trigger().startTime Czas, w którym wyzwalacz został uruchomiony, aby zainicjować uruchomienie potoku.

Notatka

If you are creating your pipeline and trigger in Azure Synapse Analytics, you must use @trigger().outputs.body.event as parameters. Ta właściwość przechwytuje informacje o zdarzeniu. Use this property instead of using @triggerBody().event.

Related content