Systeemvariabelen die worden ondersteund door Azure Data Factory en Azure Synapse Analytics

  • Artikel

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel worden systeemvariabelen beschreven die worden ondersteund door Azure Data Factory en Azure Synapse. U kunt deze variabelen gebruiken in expressies bij het definiëren van entiteiten binnen een van beide services.

Pijplijnbereik

Naar deze systeemvariabelen kan overal in de pijplijn-JSON worden verwezen.

Variabelenaam Beschrijving
@pipeline().DataFactory Naam van de gegevens of Synapse-werkruimte waarin de pijplijnuitvoering wordt uitgevoerd
@pipeline().Pipeline Naam van de pijplijn
@pipeline().RunId Id van de specifieke pijplijnuitvoering
@pipeline().TriggerType Het type trigger dat de pijplijn heeft aangeroepen (bijvoorbeeld ScheduleTrigger, BlobEventsTrigger). Zie Pijplijnuitvoering en triggers voor een lijst met ondersteunde triggertypen. Een triggertype Manual geeft aan dat de pijplijn handmatig is geactiveerd.
@pipeline().TriggerId Id van de trigger die de pijplijn heeft aangeroepen
@pipeline().TriggerName Naam van de trigger die de pijplijn heeft aangeroepen
@pipeline().TriggerTime Tijd van de triggeruitvoering die de pijplijn heeft aangeroepen. Dit is het tijdstip waarop de trigger daadwerkelijk wordt geactiveerd om de pijplijnuitvoering aan te roepen en dit kan enigszins afwijken van de geplande tijd van de trigger.
@pipeline().GroupId Id van de groep waartoe de pijplijnuitvoering behoort.
@pipeline()?. TriggeredByPipelineName Naam van de pijplijn die de pijplijnuitvoering activeert. Van toepassing wanneer de pijplijnuitvoering wordt geactiveerd door een ExecutePipeline-activiteit. Evalueer null bij gebruik in andere omstandigheden. Let op het vraagteken na @pipeline()
@pipeline()?. TriggeredByPipelineRunId Voer de id uit van de pijplijn die de pijplijnuitvoering activeert. Van toepassing wanneer de pijplijnuitvoering wordt geactiveerd door een ExecutePipeline-activiteit. Evalueer null bij gebruik in andere omstandigheden. Let op het vraagteken na @pipeline()

Notitie

Systeemvariabelen met betrekking tot triggers (in zowel pijplijn- als triggerbereiken) retourneren UTC-datums in ISO 8601-indeling, bijvoorbeeld 2017-06-01T22:20:00.4061448Z.

Bereik van schematrigger

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

Variabelenaam Beschrijving
@trigger().scheduledTime Tijdstip waarop de trigger is gepland om de pijplijnuitvoering aan te roepen.
@trigger().startTime Tijdstip waarop de trigger daadwerkelijk is geactiveerd om de pijplijnuitvoering aan te roepen. Dit kan enigszins afwijken van de geplande tijd van de trigger.

Tumblingvenstertriggerbereik

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

Variabelenaam Beschrijving
@trigger().outputs.windowStartTime Begin van het venster dat is gekoppeld aan de triggeruitvoering.
@trigger().outputs.windowEndTime Einde van het venster dat is gekoppeld aan de triggeruitvoering.
@trigger().scheduledTime Tijdstip waarop de trigger is gepland om de pijplijnuitvoering aan te roepen.
@trigger().startTime Tijdstip waarop de trigger daadwerkelijk is geactiveerd om de pijplijnuitvoering aan te roepen. Dit kan enigszins afwijken van de geplande tijd van de trigger.

Bereik van opslag gebeurtenistrigger

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

Variabelenaam Beschrijving
@triggerBody().fileName De naam van het bestand waarvan het maken of verwijderen ertoe heeft geleid dat de trigger werd geactiveerd.
@triggerBody().folderPath Pad naar de map die het bestand bevat dat is opgegeven door @triggerBody().fileName. Het eerste segment van het mappad is de naam van de Azure Blob Storage-container.
@trigger().startTime Tijdstip waarop de trigger is geactiveerd om de pijplijnuitvoering aan te roepen.

Notitie

Als u uw pijplijn en trigger maakt in Azure Synapse Analytics, moet u deze gebruiken @trigger().outputs.body.fileName en @trigger().outputs.body.folderPath als parameters. Deze twee eigenschappen leggen blobgegevens vast. Gebruik deze eigenschappen in plaats van en @triggerBody().fileName@triggerBody().folderPath.

Aangepast bereik van gebeurtenistrigger

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

Notitie

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

Variabelenaam Beschrijving
@triggerBody().event.eventType Type gebeurtenissen waarmee de uitvoering van de aangepaste gebeurtenistrigger is geactiveerd. Gebeurtenistype is door de klant gedefinieerd veld en neemt alle waarden van het tekenreekstype op.
@triggerBody().event.subject Onderwerp van de aangepaste gebeurtenis waardoor de trigger werd geactiveerd.
@triggerBody().event.data._keyName_ Gegevensveld in aangepaste gebeurtenis is een gratis JSON-blob, die de klant kan gebruiken om berichten en gegevens te verzenden. Gebruik gegevens.keyName om naar elk veld te verwijzen. Retourneert bijvoorbeeld @triggerBody().event.data.callback de waarde voor het callback-veld dat is opgeslagen onder gegevens.
@trigger().startTime Tijdstip waarop de trigger is geactiveerd om de pijplijnuitvoering aan te roepen.

Gerelateerde inhoud