Dela via


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.