Condividi tramite

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

  • Articolo

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

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.

Ambito della pipeline

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

Nome variabile Descrizione
@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 ha richiamato la pipeline
@pipeline().TriggerName Nome del trigger che richiama la pipeline
@pipeline().TriggerTime Ora dell’esecuzione del trigger che ha richiamato la pipeline. Questo è il momento in cui il trigger viene effettivamente attivato per richiamare l'esecuzione della pipeline e può 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. Restituisce Null se usato in altre circostanze. Notare il punto interrogativo dopo @pipeline()
@pipeline()?.TriggeredByPipelineRunId Eseguire l’ID della pipeline che attiva l'esecuzione della pipeline. Applicabile quando l'esecuzione della pipeline viene attivata da un'attività ExecutePipeline. Restituisce Null se usato in altre circostanze. Notare il punto interrogativo dopo @pipeline()

Nota

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.

Nome variabile Descrizione
@trigger().scheduledTime Ora in cui è stato pianificato il trigger per richiamare l'esecuzione della pipeline.
@trigger().startTime Ora in cui il trigger è stato effettivamente attivato per richiamare l'esecuzione della pipeline. Questo può differire leggermente dall'ora pianificata del trigger.

Ambito del trigger di finestra a cascata

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

Nome variabile Descrizione
@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 è stato pianificato il trigger per richiamare l'esecuzione della pipeline.
@trigger().startTime Ora in cui il trigger è stato effettivamente attivato per richiamare l'esecuzione della pipeline. Questo può differire leggermente dall'ora pianificata del trigger.

Ambito del trigger di eventi di archiviazione

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

Nome variabile Descrizione
@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.

Nota

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à acquisisce informazioni sui BLOB. Usare tali proprietà invece di usare @triggerBody().fileName e @triggerBody().folderPath.

Ambito del trigger di eventi personalizzato

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

Nota

Il servizio prevede che gli eventi personalizzati vengano formattati con Griglia di eventi di Azure schema di eventi.

Nome variabile Descrizione
@triggerBody().event.eventType Tipo di eventi che hanno attivato l'esecuzione del trigger di evento personalizzato. 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 nell'evento personalizzato è gratuito dal BLOB JSON, 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.

Contenuto correlato