Condividi tramite

Variabili di sistema supportate da Azure Data Factory e Azure Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Tip

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

Questo articolo descrive le variabili di sistema supportate da Azure Data Factory e Azure Synapse. È possibile usare queste variabili nelle espressioni quando si definiscono le entità all'interno di entrambi i servizi.

Pipeline scope

È possibile fare riferimento a queste variabili di sistema in un punto qualsiasi della pipeline JSON.

Variable Name Description
@pipeline().DataFactory Nome dei dati o dell’area di lavoro Synapse in cui è in esecuzione la pipeline
@pipeline().Pipeline Nome della pipeline
@pipeline().RunId ID dell'esecuzione della pipeline specifica
@pipeline().TriggerType Tipo di trigger che ha richiamato la pipeline , ad esempio ScheduleTrigger, BlobEventsTrigger. Per un elenco dei tipi di trigger supportati, vedere Esecuzione e trigger della pipeline. Un tipo di Manual trigger indica che la pipeline è stata attivata manualmente.
@pipeline().TriggerId ID del trigger che richiama la pipeline
@pipeline().TriggerName Nome del trigger che richiama la pipeline
@pipeline().TriggerTime Ora del trigger che richiama la pipeline. È il momento in cui il trigger viene effettivamente attivato per richiamare l'esecuzione della pipeline, e potrebbe differire leggermente dall'ora pianificata del trigger.
@pipeline().GroupId ID del gruppo a cui appartiene l'esecuzione della pipeline.
@pipeline()?.TriggeredByPipelineName Nome della pipeline che attiva l’esecuzione della pipeline. Applicabile quando l'esecuzione della pipeline viene attivata da un'attività ExecutePipeline. Diventa Null quando viene utilizzato in altre circostanze. Notare il punto interrogativo dopo @pipeline()
@pipeline()?.TriggeredByPipelineRunId ID del trigger della pipeline che attiva l’esecuzione della pipeline. Applicabile quando l'esecuzione della pipeline viene attivata da un'attività ExecutePipeline. Diventa Null quando viene utilizzato in altre circostanze. Notare il punto interrogativo dopo @pipeline()

Note

Le variabili di sistema di data/ora correlate al trigger (sia negli ambiti della pipeline che dei trigger) restituiscono date UTC in formato ISO 8601, ad esempio 2017-06-01T22:20:00.4061448Z.

Ambito del trigger di pianificazione

È possibile fare riferimento a queste variabili di sistema in qualsiasi punto del trigger JSON per i trigger di tipo ScheduleTrigger.

Variable Name Description
@trigger().scheduledTime Ora in cui il trigger è stato pianificato per richiamare l'esecuzione della pipeline.
@trigger().startTime Ora in cui il trigger ha richiamato effettivamente l'esecuzione della pipeline. Potrebbe differire leggermente rispetto all'ora pianificata del trigger.

Ambito del trigger della finestra a cascata

È possibile fare riferimento a queste variabili di sistema in qualsiasi punto del trigger JSON per i trigger di tipo TumblingWindowTrigger.

Variable Name Description
@trigger().outputs.windowStartTime Inizio della finestra associata all'esecuzione del trigger.
@trigger().outputs.windowEndTime Fine della finestra associata all'esecuzione del trigger.
@trigger().scheduledTime Ora in cui il trigger è stato pianificato per richiamare l'esecuzione della pipeline.
@trigger().startTime Ora in cui il trigger ha richiamato effettivamente l'esecuzione della pipeline. Potrebbe differire leggermente rispetto all'ora pianificata del trigger.

Ambito del trigger degli eventi di archiviazione

È possibile fare riferimento a queste variabili di sistema ovunque nel trigger JSON per i trigger di tipo BlobEventsTrigger.

Variable Name Description
@triggerBody().fileName Nome del file la cui creazione o eliminazione ha causato l'attivazione del trigger.
@triggerBody().folderPath Percorso della cartella contenente il file specificato da @triggerBody().fileName. Il primo segmento del percorso della cartella è il nome del contenitore Archiviazione BLOB di Azure.
@trigger().startTime Ora in cui il trigger è stato attivato per richiamare l'esecuzione della pipeline.

Note

Se si sta creando la pipeline e il trigger in Azure Synapse Analytics, è necessario usare @trigger().outputs.body.fileName e @trigger().outputs.body.folderPath come parametri. Queste due proprietà acquisiscono informazioni sui BLOB. Usare tali proprietà invece di usare @triggerBody().fileName e @triggerBody().folderPath.

Ambito del trigger di eventi personalizzati

È possibile fare riferimento a queste variabili di sistema in qualsiasi punto del trigger JSON per i trigger di tipo CustomEventsTrigger.

Note

Il servizio prevede che gli eventi personalizzati vengano formattati con lo schema di eventi di Azure Event Grid.

Variable Name Description
@triggerBody().event.eventType Tipo di eventi che hanno attivato l'esecuzione del trigger di eventi personalizzati. Il tipo di evento è un campo definito dal cliente e accetta qualsiasi valore di tipo stringa.
@triggerBody().event.subject Oggetto dell'evento personalizzato che ha causato l'attivazione del trigger.
@triggerBody().event.data._keyName_ Il campo dati in un evento personalizzato è un BLOB JSON a forma libera, che il cliente può usare per inviare messaggi e dati. Usare i dati. keyName per fare riferimento a ogni campo. Ad esempio, restituisce @triggerBody().event.data.callback il valore per il campo di callback archiviato nei dati.
@trigger().startTime Ora in cui il trigger è stato attivato per richiamare l'esecuzione della pipeline.

Note

Se si sta creando la pipeline e il trigger in Azure Synapse Analytics, è necessario usare @trigger().outputs.body.event come parametri. Questa proprietà acquisisce informazioni sugli eventi. Utilizzare questa proprietà invece di usare @triggerBody().event.

Related content

  • Last updated on