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ältetsom 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