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

  • Článek

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

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

Rozsah kanálu

Na tyto systémové proměnné můžete odkazovat kdekoli ve formátu JSON kanálu.

Název proměnné Popis
@pipeline().DataFactory Název pracovního prostoru dat nebo Synapse, ve kterém běží spuštění kanálu
@pipeline().Pipeline Název kanálu
@pipeline().RunId ID konkrétního spuštění kanálu
@pipeline().TriggerType Typ triggeru, který vyvolal kanál (například ScheduleTrigger, BlobEventsTrigger). Seznam podporovaných typů aktivačních událostí najdete v tématu Spouštění kanálů a triggery. Typ triggeru Manual označuje, že se kanál aktivoval ručně.
@pipeline().TriggerId ID aktivační události, která vyvolala kanál
@pipeline().TriggerName Název triggeru, který vyvolal kanál
@pipeline().TriggerTime Čas spuštění triggeru, který vyvolal kanál. Jedná se o čas, kdy se trigger skutečně aktivoval pro vyvolání spuštění kanálu, a může se mírně lišit od naplánovaného času triggeru.
@pipeline().GroupId ID skupiny, do které patří spuštění kanálu.
@pipeline()?. TriggeredByPipelineName Název kanálu, který aktivuje spuštění kanálu. Platí, pokud je spuštění kanálu aktivováno aktivitou ExecutePipeline. Při použití v jiných případech se vyhodnotí na hodnotu Null . Povšimněte si otazníku @pipeline()
@pipeline()?. TriggeredByPipelineRunId ID spuštění kanálu, který aktivuje spuštění kanálu. Platí, pokud je spuštění kanálu aktivováno aktivitou ExecutePipeline. Při použití v jiných případech se vyhodnotí na hodnotu Null . Povšimněte si otazníku @pipeline()

Poznámka:

Systémové proměnné pro datum a čas související s triggery (v rozsahech kanálu i triggerů) vrací data UTC ve formátu ISO 8601, 2017-06-01T22:20:00.4061448Znapříklad .

Rozsah aktivační události plánu

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 byla aktivační událost naplánována tak, aby vyvolala spuštění kanálu.
@trigger().startTime Čas, kdy se trigger skutečně aktivoval pro vyvolání spuštění kanálu. To se může mírně lišit od naplánovaného času triggeru.

Rozsah triggeru pro přeskakující okno

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

Název proměnné Popis
@trigger().outputs.windowStartTime Začátek okna přidruženého ke spuštění triggeru
@trigger().outputs.windowEndTime Konec okna přidruženého ke spuštění triggeru
@trigger().scheduledTime Čas, kdy byla aktivační událost naplánována tak, aby vyvolala spuštění kanálu.
@trigger().startTime Čas, kdy se trigger skutečně aktivoval pro vyvolání spuštění kanálu. To se může mírně lišit od naplánovaného času triggeru.

Rozsah triggeru události úložiště

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

Název proměnné Popis
@triggerBody().fileName Název souboru, jehož vytvoření nebo odstranění způsobilo aktivaci triggeru
@triggerBody().folderPath Cesta ke 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 se trigger aktivoval pro vyvolání spuštění kanálu.

Poznámka:

Pokud vytváříte kanál a trigger ve službě Azure Synapse Analytics, musíte ho použít @trigger().outputs.body.fileName a @trigger().outputs.body.folderPath jako parametry. Tyto dvě vlastnosti zachycují informace o objektu blob. Tyto vlastnosti použijte místo použití @triggerBody().fileName a @triggerBody().folderPath.

Rozsah triggeru vlastní události

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

Poznámka:

Služba očekává, že vlastní události se naformátují pomocí schématu událostí Azure Event Gridu.

Název proměnné Popis
@triggerBody().event.eventType Typ událostí, které aktivovaly spuštění vlastní události Typ události je pole definované zákazníkem a převezme všechny hodnoty typu řetězce.
@triggerBody().event.subject Předmět vlastní události, která způsobila aktivaci triggeru
@triggerBody().event.data._keyName_ Datové pole ve vlastní události je bezplatné z objektu blob JSON, který může zákazník použít k odesílání zpráv a dat. Použijte data.keyName pro odkaz na každé pole. Například @triggerBody().event.data.callback vrátí hodnotu pro pole zpětnéhovolání uloženého v datech.
@trigger().startTime Čas, kdy se trigger aktivoval pro vyvolání spuštění kanálu.

Související obsah