Systémové proměnné podporované službou Azure Data Factory a Azure Synapse Analytics
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ého volání uloženého v datech. |
| @trigger().startTime | Čas, kdy se trigger aktivoval pro vyvolání spuštění kanálu. |
Související obsah
- Informace o tom, jak se tyto proměnné používají ve výrazech, najdete v tématu Jazyk výrazů a funkce.
- Informace o použití systémových proměnných oboru triggeru v kanálu najdete v tématu Referenční metadata aktivační události v kanálu.