Systemvariabler som stöds av Azure Data Factory och Azure Synapse Analytics
GÄLLER FÖR: 
Azure Data Factory Azure Synapse Analytics
Dricks
Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!
I den här artikeln beskrivs systemvariabler som stöds av Azure Data Factory och Azure Synapse. Du kan använda dessa variabler i uttryck när du definierar entiteter i någon av tjänsterna.
Pipelineomfång
Dessa systemvariabler kan refereras var som helst i pipeline-JSON.
| Variabelnamn | beskrivning |
|---|---|
| @pipeline().DataFactory | Namnet på data eller Synapse-arbetsytan som pipelinekörningen körs i |
| @pipeline().Pipeline | Namn på pipelinen |
| @pipeline().RunId | ID för den specifika pipelinekörningen |
| @pipeline().TriggerType | Typen av utlösare som anropade pipelinen (till exempel ScheduleTrigger, BlobEventsTrigger). En lista över utlösartyper som stöds finns i Pipelinekörning och utlösare. En utlösartyp anger Manual att pipelinen utlöstes manuellt. |
| @pipeline().TriggerId | ID för utlösaren som anropade pipelinen |
| @pipeline().TriggerName | Namnet på utlösaren som anropade pipelinen |
| @pipeline().TriggerTime | Tidpunkten för den utlösarkörning som anropade pipelinen. Det här är den tidpunkt då utlösaren faktiskt utlöstes för att anropa pipelinekörningen, och den kan skilja sig något från utlösarens schemalagda tid. |
| @pipeline().GroupId | ID för den grupp som pipelinekörningen tillhör. |
| @pipeline()?. TriggeredByPipelineName | Namnet på pipelinen som utlöser pipelinekörningen. Gäller när pipelinekörningen utlöses av en ExecutePipeline-aktivitet. Utvärdera till Null när det används under andra omständigheter. Anteckna frågetecknet efter @pipeline() |
| @pipeline()?. TriggeredByPipelineRunId | Kör ID för pipelinen som utlöser pipelinekörningen. Gäller när pipelinekörningen utlöses av en ExecutePipeline-aktivitet. Utvärdera till Null när det används under andra omständigheter. Anteckna frågetecknet efter @pipeline() |
Kommentar
Utlösarrelaterade systemvariabler för datum/tid (i både pipeline- och utlösaromfång) returnerar UTC-datum i ISO 8601-format, till exempel 2017-06-01T22:20:00.4061448Z.
Schemalägg utlösaromfång
Dessa systemvariabler kan refereras var som helst i utlösarens JSON för utlösare av typen ScheduleTrigger.
| Variabelnamn | beskrivning |
|---|---|
| @trigger().scheduledTime | Tidpunkt då utlösaren schemalagts för att anropa pipelinekörningen. |
| @trigger().startTime | Tidpunkt då utlösaren faktiskt utlöstes för att anropa pipelinekörningen. Detta kan skilja sig något från utlösarens schemalagda tid. |
Utlösaromfång för rullande fönster
Dessa systemvariabler kan refereras var som helst i utlösarens JSON för utlösare av typen TumblingWindowTrigger.
| Variabelnamn | beskrivning |
|---|---|
| @trigger().outputs.windowStartTime | Start av fönstret som är associerat med utlösarkörningen. |
| @trigger().outputs.windowEndTime | Slutet av fönstret som är associerat med utlösarkörningen. |
| @trigger().scheduledTime | Tidpunkt då utlösaren schemalagts för att anropa pipelinekörningen. |
| @trigger().startTime | Tidpunkt då utlösaren faktiskt utlöstes för att anropa pipelinekörningen. Detta kan skilja sig något från utlösarens schemalagda tid. |
Utlösaromfång för lagringshändelse
Dessa systemvariabler kan refereras var som helst i utlösarens JSON för utlösare av typen BlobEventsTrigger.
| Variabelnamn | beskrivning |
|---|---|
| @triggerBody().fileName | Namnet på den fil vars skapande eller borttagning gjorde att utlösaren utlöstes. |
| @triggerBody().folderPath | Sökväg till mappen som innehåller filen som anges av @triggerBody().fileName. Det första segmentet i mappsökvägen är namnet på Azure Blob Storage-containern. |
| @trigger().startTime | Tidpunkt då utlösaren utlöstes för att anropa pipelinekörningen. |
Kommentar
Om du skapar din pipeline och utlösare i Azure Synapse Analytics måste du använda @trigger().outputs.body.fileName och @trigger().outputs.body.folderPath som parametrar. Dessa två egenskaper samlar in blobinformation. Använd dessa egenskaper i stället för att använda @triggerBody().fileName och @triggerBody().folderPath.
Omfång för anpassad händelseutlösare
Dessa systemvariabler kan refereras var som helst i utlösarens JSON för utlösare av typen CustomEventsTrigger.
Kommentar
Tjänsten förväntar sig att anpassade händelser formateras med Azure Event Grid-händelseschema.
| Variabelnamn | beskrivning |
|---|---|
| @triggerBody().event.eventType | Typ av händelser som utlöste körningen av anpassad händelseutlösare. Händelsetypen är ett kunddefinierat fält och tar på sig alla värden av strängtyp. |
| @triggerBody().event.subject | Ämne för den anpassade händelse som gjorde att utlösaren utlöstes. |
| @triggerBody().event.data._keyName_ | Datafält i anpassad händelse är en kostnadsfri JSON-blob som kunden kan använda för att skicka meddelanden och data. Använd data.keyName för att referera till varje fält. Returnerar @triggerBody().event.data.callback till exempel värdet för motringningsfältet som lagras under data. |
| @trigger().startTime | Tidpunkt då utlösaren utlöstes för att anropa pipelinekörningen. |
Relaterat innehåll
- Information om hur dessa variabler används i uttryck finns i Uttrycksspråk och -funktioner.
- Information om hur du använder systemvariabler för utlösaromfång i pipeline finns i Referensutlösarmetadata i pipeline