Door Azure Data Factory en Azure Synapse Analytics ondersteunde systeemvariabelen

Van toepassing op: Azure Data Factory Azure Synapse Analytics

Aanbeveling

Probeer Data Factory in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles van gegevensverplaatsing tot datawetenschap, realtime-analyse, bedrijfsinformatie en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Dit artikel beschrijft systeemvariabelen die worden ondersteund door Azure Data Factory en Azure Synapse. U kunt deze variabelen in uitdrukkingen gebruiken bij het definiëren van entiteiten binnen beide diensten.

Omvang van de pijplijn

Deze systeemvariabelen kunnen overal in de pipeline JSON worden gebruikt.

Variabelenaam	Beschrijving
@pipeline().DataFactory	Naam van de gegevens of Synapse-werkruimte waarin de pipeline-uitvoering plaatsvindt
@pipeline().Pipeline	Naam van de pijplijn
@pipeline().RunId	ID van de specifieke pijplijnuitvoering
@pipeline().TriggerType	Het type trigger dat de pijplijn in werking heeft gesteld (bijvoorbeeld, ScheduleTrigger, BlobEventsTrigger). Voor een lijst van ondersteunde trigger types, zie Pipeline-executie en triggers. Een trigger type van Manual geeft aan dat de pijplijn handmatig is gestart.
@pipeline().TriggerId	ID van de trigger die de pijplijn heeft aangeroepen
@pipeline().TriggerName	Naam van de trigger die de pijplijn heeft opgeroepen
@pipeline().TriggerTime	Tijd van de triggeruitvoering die de pijplijn heeft opgeroepen. Dit is het moment waarop de trigger daadwerkelijk afging om de pijplijnuitvoering te starten, en dit kan enigszins verschillen van de geplande tijd van de trigger.
@pipeline().GroupId	ID van de groep waartoe de pijplijnrun behoort.
@pipeline()?.GeactiveerdDoorPipelineNaam	Naam van de pijplijn die de uitvoering van de pijplijn triggert. Van toepassing wanneer de pijplijnuitvoering wordt geactiveerd door een ExecutePipeline-activiteit. Beoordeel als Null wanneer gebruikt in andere omstandigheden. Let op het vraagteken na @pipeline()
@pipeline()?. GetriggerdDoorPijplijnRunId	De run-ID van de pijplijn die de pijplijnrun activeert. Van toepassing wanneer de pijplijnuitvoering wordt geactiveerd door een ExecutePipeline-activiteit. Beoordeel als Null wanneer gebruikt in andere omstandigheden. Let op het vraagteken na @pipeline()

Opmerking

Systeemvariabelen gerelateerd aan de trigger voor datum/tijd (in zowel de pijplijn- als de triggervelden) geven UTC-datums terug in ISO 8601-formaat, bijvoorbeeld 2017-06-01T22:20:00.4061448Z.

Schema triggerbereik

Naar deze systeemvariabelen kan overal in de trigger-JSON worden verwezen voor triggers van het type ScheduleTrigger.

Variabelenaam	Beschrijving
@trigger().scheduledTime	Het tijdstip waarop de trigger was gepland om de pipeline-run te starten.
@trigger().startTime	Tijdstip waarop de trigger actually werd geactiveerd om de pipeline-run te starten. Dit kan enigszins afwijken van de geplande tijd van de trigger.

Bereik van tuimelvenster-trigger

Deze systeemvariabelen kunnen overal in de trigger-JSON worden gebruikt voor triggers van het type TumblingWindowTrigger.

Variabelenaam	Beschrijving
@trigger().outputs.windowStartTime	Begin van het venster dat verband houdt met de triggeruitvoering.
@trigger().outputs.windowEndTime	Eindpunt van het venster dat geassocieerd is met de trigger run.
@trigger().scheduledTime	Het tijdstip waarop de trigger was gepland om de pipeline-run te starten.
@trigger().startTime	Tijdstip waarop de trigger actually werd geactiveerd om de pipeline-run te starten. Dit kan enigszins afwijken van de geplande tijd van de trigger.

Opslagevenement-triggerbereik

Deze systeemvariabelen kunnen overal in de trigger JSON worden gereferenceerd voor triggers van het type BlobEventsTrigger.

Variabelenaam	Beschrijving
@triggerBody().fileName	Naam van het bestand waarvan de aanmaak of verwijdering ervoor zorgde dat de trigger afging.
@triggerBody().folderPath	Pad naar de map die het bestand bevat gespecificeerd door @triggerBody().fileName. Het eerste segment van het map pad is de naam van de Azure Blob Storage-container.
@trigger().startTime	Tijdstip waarop de trigger werd geactiveerd om de uitvoering van de pijplijn te starten.

Opmerking

Als u uw pijplijn en trigger maakt in Azure Synapse Analytics, moet u @trigger().outputs.body.fileName en @trigger().outputs.body.folderPath als parameters gebruiken. Die twee eigenschappen vangen blob-informatie op. Gebruik die eigenschappen in plaats van en @triggerBody().folderPathte gebruiken@triggerBody().fileName.

Aangepaste gebeurtenis-triggerbereik

Deze systeemvariabelen kunnen overal worden verwezen in de trigger JSON voor triggers van het type CustomEventsTrigger.

Opmerking

De service verwacht dat aangepaste gebeurtenissen worden opgemaakt volgens het Azure Event Grid-gebeurtenisschema.

Variabelenaam	Beschrijving
@triggerBody().event.eventType	Type gebeurtenissen die de uitvoering van de Aangepaste Gebeurtenistrigger activeerden. Het evenementtype is een door de klant gedefinieerd veld en kan elke waarde van het type string aannemen.
@triggerBody().event.subject	Onderwerp van de aangepaste gebeurtenis die ervoor zorgde dat de trigger werd geactiveerd.
@triggerBody().event.data._keyName_	Het gegevensveld in een aangepast evenement is een vrij JSON-blok, dat de klant kan gebruiken om berichten en gegevens te verzenden. Gebruik data.keyName om naar elk veld te verwijzen. Bijvoorbeeld, @triggerBody().event.data.callback retourneert de waarde voor het callback veld dat is opgeslagen onder data.
@trigger().startTime	Tijdstip waarop de trigger werd geactiveerd om de uitvoering van de pijplijn te starten.

Opmerking

Als je je pipeline en trigger aan het maken bent in Azure Synapse Analytics, moet je @trigger().outputs.body.event als parameters gebruiken. Deze eigenschap legt evenementinformatie vast. Gebruik deze eigenschap in plaats van @triggerBody().event te gebruiken.

Gerelateerde inhoud

• Voor informatie over hoe deze variabelen in expressies worden gebruikt, zie Expressietaal & functies.
• Om triggerbereik systeemvariabelen in de pijplijn te gebruiken, zie Referentie trigger metadata in pijplijn