Dela via

Systemvariabler som stöds av Azure Data Factory och Azure Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Tip

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.

Pipeline scope

Dessa systemvariabler kan refereras var som helst i pipeline-JSON.

Variable Name Description
@pipeline().DataFactory Namnet på datan eller Synapse-arbetsytan där pipelinekörningen körs
@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). Lista över stödda utlösartyper finns i Körning av pipeline 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 körningen av triggern som anropade pipelinen. Det här är den tidpunkt då triggern faktiskt utlöstes för att starta pipelinekörningen, och den kan skilja sig något från triggerns 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 startar körningen av pipelinen. 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()

Note

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.

Variable Name Description
@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 starta pipelinekörning. 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.

Variable Name Description
@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 starta pipelinekörning. 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.

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

Note

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.

Note

Tjänsten förväntar sig att anpassade händelser formateras med Azure Event Grid-händelseschema.

Variable Name Description
@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 fick utlösaren att aktiveras.
@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ältetsom lagras under data.
@trigger().startTime Tidpunkt då utlösaren utlöstes för att anropa pipelinekörningen.

Note

Om du skapar din pipeline och utlösare i Azure Synapse Analytics måste du använda @trigger().outputs.body.event som parametrar. Den här egenskapen samlar in händelseinformation. Använd den här egenskapen i stället för att använda @triggerBody().event.

Related content