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

Tip

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.

Pipeline scope

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

Variable Name Description
@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. Jedná se o čas, kdy se spouštěč skutečně aktivoval pro vyvolání běhu kanálu, a může se mírně lišit od naplánovaného času spouštěče.
@pipeline().GroupId ID skupiny, do které patří spuštění kanálu.
@pipeline()?.TriggeredByPipelineName 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()?.TriggeredByPipelineRunId 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()

Note

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.

Variable Name Description
@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 spuštění.

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.

Variable Name Description
@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 plánovaného času spuštění akce.

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.

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

Note

Pokud vytváříte kanál a trigger ve službě 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.

Note

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

Variable Name Description
@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žívejte data. keyName pro odkaz 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í.

Note

Pokud vytváříte kanál a trigger ve službě Azure Synapse Analytics, musíte použít @trigger().outputs.body.event jako parametry. Tato vlastnost zachycuje informace o události. Použijte tuto vlastnost místo použití @triggerBody().event.

Related content

  • Last updated on