Sdílet prostřednictvím

Systémové proměnné podporované službami Azure Data Factory a Azure Synapse Analytics

VZTAHUJE SE NA: Azure Data Factory Azure Synapse Analytics

Návod

Vyzkoušejte Data Factory v Microsoft Fabric, komplexní analytické řešení pro podniky. Microsoft Fabric zahrnuje vše od pohybu dat po datovou vědu, analýzu v reálném čase, business intelligence a vytváření přehledů. Naučte se začít novou zkušební verzi zdarma!

Tento článek popisuje systémové proměnné podporované Azure Data Factory a Azure Synapse. Tyto proměnné můžete použít ve výrazech při definování entit v jedné z těchto služeb.

Rozsah potrubí

Tyto systémové proměnné lze použít kdekoli v JSONu potrubí.

Název proměnné Popis
@pipeline().DataFactory Název dat nebo pracovního prostoru Synapse, ve kterém je spuštěn běh kanálu
@pipeline().Pipeline Název potrubí
@pipeline().RunId ID konkrétního spuštění pipeline
@pipeline().TriggerType Typ spouštěče, který spustil kanál (například ScheduleTrigger, BlobEventsTrigger). Pro seznam podporovaných typů spouštěčů viz Provádění a spouštění pipeline. Typ aktivačního Manual indikuje, že potrubí bylo spuštěno ručně.
@pipeline().TriggerId ID spouště, který aktivoval sestavu
@pipeline().TriggerName Název spouštěče, který aktivoval kanál
@pipeline().TriggerTime Čas spuštění triggeru, který vyvolal pipelinu. Toto je čas, kdy se skutečně spustil spouštěč k zahájení běhu kanálu, a může se mírně lišit od plánovaného času spouštěče.
@pipeline().GroupId ID skupiny, do které patří spuštění kanálu.
@pipeline()?. SpuštěnoByPipelineName Název kanálu, který spouští běh kanálu. Platí, když je spuštění kanálu zahájeno aktivitou ExecutePipeline. Vyhodnoťte jako Null při použití za jiných okolností. Všimněte si otazníku za @pipeline()
@pipeline()?.SpuštěnoPodleIdentifikátoruSpuštěníPipeline ID spuštění kanálu, které spustí běh kanálu. Platí, když je spuštění kanálu zahájeno aktivitou ExecutePipeline. Vyhodnoťte jako Null při použití za jiných okolností. Všimněte si otazníku za @pipeline()

Poznámka

Pro systémové proměnné data a času související s triggerem (v obou oblastech – pipeline a trigger) vracejí daty UTC ve formátu ISO 8601, například 2017-06-01T22:20:00.4061448Z.

Rozsah plánovače spouštění

Na tyto systémové proměnné lze odkazovat kdekoli ve formátu JSON triggeru pro triggery typu ScheduleTrigger.

Název proměnné Popis
@trigger().scheduledTime Čas, kdy byl plánovač spuštění naplánován pro spuštění běhu pipeline.
@trigger().startTime Čas, kdy spoušť skutečně byla aktivována k vyvolání spuštění pipeline. To se může mírně lišit od naplánovaného času spouštěče.

Rozsah triggeru pro přeskakující okno

Tyto systémové proměnné lze odkazovat kdekoli v JSONu spuštěče pro spouštěče typu TumblingWindowTrigger.

Název proměnné Popis
@trigger().outputs.windowStartTime Začátek okna spojeného se spuštěním spouštěče.
@trigger().outputs.windowEndTime Konec okna spojeného se spuštěním spouštěče.
@trigger().scheduledTime Čas, kdy byl plánovač spuštění naplánován pro spuštění běhu pipeline.
@trigger().startTime Čas, kdy spoušť skutečně byla aktivována k vyvolání spuštění pipeline. To se může mírně lišit od naplánovaného času spouštěče.

Rozsah spuštění události úložiště

Tyto systémové proměnné lze odkazovat kdekoli v JSONu spouštěče pro spouštěče typu BlobEventsTrigger.

Název proměnné Popis
@triggerBody().fileName Název souboru, jehož vytvoření nebo odstranění způsobilo spuštění spouštěče.
@triggerBody().folderPath Cesta k složce, která obsahuje soubor určený @triggerBody().fileName. První segment cesty ke složce je název kontejneru Azure Blob Storage.
@trigger().startTime Čas, kdy spoušť vyvolala spuštění procesu v potrubí.

Poznámka

Pokud vytváříte svůj kanál a spouštěč v Azure Synapse Analytics, musíte použít @trigger().outputs.body.fileName a @trigger().outputs.body.folderPath jako parametry. Tyto dvě vlastnosti zachycují informace o blobu. Použijte tyto vlastnosti místo použití @triggerBody().fileName a @triggerBody().folderPath.

Rozsah vlastní události spuštění

Tyto systémové proměnné lze použít kdekoli v JSONu spouštěče pro spouštěče typu CustomEventsTrigger.

Poznámka

Služba očekává, že vlastní události budou formátovány pomocí schématu událostí Azure Event Grid.

Název proměnné Popis
@triggerBody().event.eventType Typ událostí, které spustily spuštění spouštěče vlastní události. Typ události je pole definované zákazníkem a může mít jakékoliv hodnoty typu řetězec.
@triggerBody().event.subject Předmět vlastního události, který způsobil aktivaci spouštěče.
@triggerBody().event.data._keyName_ Datové pole v uživatelské události je volné pole typu JSON blob, které zákazník může použít k odesílání zpráv a dat. Použijte data.keyName k odkazování na každé pole. Například @triggerBody().event.data.callback vrátí hodnotu pro pole callback uložené pod data.
@trigger().startTime Čas, kdy spoušť vyvolala spuštění procesu v potrubí.

Poznámka

Pokud vytváříte svůj kanál a spouštěcí událost v Azure Synapse Analytics, musíte jako parametry použít @trigger().outputs.body.event. Tato vlastnost zachycuje informace o události. Použijte tuto vlastnost místo použití @triggerBody().event.

Související obsah