Variáveis de sistema suportadas pelo Azure Data Factory e Azure Synapse Analytics
APLICA-SE A: 
Azure Data Factory Azure Synapse Analytics
Gorjeta
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!
Este artigo descreve as variáveis de sistema suportadas pelo Azure Data Factory e Azure Synapse. Você pode usar essas variáveis em expressões ao definir entidades dentro de qualquer serviço.
Escopo do pipeline
Essas variáveis de sistema podem ser referenciadas em qualquer lugar no pipeline JSON.
| Nome da variável | Description |
|---|---|
| @pipeline().DataFactory | Nome dos dados ou espaço de trabalho Synapse em que o pipeline executado está sendo executado |
| @pipeline().Pipeline | Nome do gasoduto |
| @pipeline().RunId | ID da execução do pipeline específico |
| @pipeline().TriggerType | O tipo de gatilho que invocou o pipeline (por exemplo, ScheduleTriggerBlobEventsTrigger, ). Para obter uma lista dos tipos de gatilho suportados, consulte Execução e gatilhos de pipeline. Um tipo de gatilho indica Manual que o pipeline foi acionado manualmente. |
| @pipeline().TriggerId | ID do gatilho que invocou o pipeline |
| @pipeline().TriggerName | Nome do gatilho que invocou o pipeline |
| @pipeline().TriggerTime | Hora da execução do gatilho que invocou o pipeline. Este é o momento em que o gatilho realmente disparou para invocar a execução do pipeline, e pode diferir ligeiramente do tempo agendado do gatilho. |
| @pipeline().GroupId | ID do grupo ao qual o pipeline é executado. |
| @pipeline()?. TriggeredByPipelineName | Nome do pipeline que aciona a execução do pipeline. Aplicável quando a execução do pipeline é acionada por uma atividade ExecutePipeline. Avalie como Nulo quando usado em outras circunstâncias. Observe o ponto de interrogação após @pipeline() |
| @pipeline()?. TriggeredByPipelineRunId | ID de execução do pipeline que dispara a execução do pipeline. Aplicável quando a execução do pipeline é acionada por uma atividade ExecutePipeline. Avalie como Nulo quando usado em outras circunstâncias. Observe o ponto de interrogação após @pipeline() |
Nota
As variáveis do sistema de data/hora relacionadas ao gatilho (nos escopos de pipeline e gatilho) retornam datas UTC no formato ISO 8601, por exemplo, 2017-06-01T22:20:00.4061448Z.
Escopo do gatilho do cronograma
Essas variáveis de sistema podem ser referenciadas em qualquer lugar no JSON de gatilho para gatilhos do tipo ScheduleTrigger.
| Nome da variável | Description |
|---|---|
| @trigger().scheduledTime | Hora em que o gatilho foi agendado para invocar a execução do pipeline. |
| @trigger().startTime | Momento em que o gatilho realmente disparou para invocar a execução do pipeline. Isso pode diferir ligeiramente da hora programada do gatilho. |
Escopo do gatilho da janela de tombamento
Essas variáveis de sistema podem ser referenciadas em qualquer lugar no JSON de gatilho para gatilhos do tipo TumblingWindowTrigger.
| Nome da variável | Description |
|---|---|
| @trigger().outputs.windowStartTime | Início da janela associada à execução do gatilho. |
| @trigger().outputs.windowEndTime | Fim da janela associada à execução do gatilho. |
| @trigger().scheduledTime | Hora em que o gatilho foi agendado para invocar a execução do pipeline. |
| @trigger().startTime | Momento em que o gatilho realmente disparou para invocar a execução do pipeline. Isso pode diferir ligeiramente da hora programada do gatilho. |
Escopo do gatilho de evento de armazenamento
Essas variáveis de sistema podem ser referenciadas em qualquer lugar no JSON de gatilho para gatilhos do tipo BlobEventsTrigger.
| Nome da variável | Description |
|---|---|
| @triggerBody().fileName | Nome do arquivo cuja criação ou exclusão causou o disparo do gatilho. |
| @triggerBody().folderPath | Caminho para a pasta que contém o arquivo especificado pelo @triggerBody().fileName. O primeiro segmento do caminho da pasta é o nome do contêiner de Armazenamento de Blob do Azure. |
| @trigger().startTime | Momento em que o gatilho disparou para invocar a execução do pipeline. |
Nota
Se você estiver criando seu pipeline e gatilho no Azure Synapse Analytics, deverá usar @trigger().outputs.body.fileName e @trigger().outputs.body.folderPath como parâmetros. Essas duas propriedades capturam informações de blob. Use essas propriedades em vez de usar @triggerBody().fileName e @triggerBody().folderPath.
Escopo do gatilho de evento personalizado
Essas variáveis de sistema podem ser referenciadas em qualquer lugar no JSON de gatilho para gatilhos do tipo CustomEventsTrigger.
Nota
O serviço espera que os eventos personalizados sejam formatados com o esquema de eventos da Grade de Eventos do Azure.
| Nome da variável | Description |
|---|---|
| @triggerBody().event.eventType | Tipo de eventos que dispararam a execução do Gatilho de Evento Personalizado. Tipo de evento é o campo definido pelo cliente e assume quaisquer valores do tipo de cadeia de caracteres. |
| @triggerBody().event.subject | Assunto do evento personalizado que causou o disparo do gatilho. |
| @triggerBody().event.data._keyName_ | Campo de dados em evento personalizado é livre de blob JSON, que o cliente pode usar para enviar mensagens e dados. Por favor, use dados.keyName para fazer referência a cada campo. Por exemplo, @triggerBody().event.data.callback retorna o valor do campo de retorno de chamada armazenado em dados. |
| @trigger().startTime | Momento em que o gatilho disparou para invocar a execução do pipeline. |
Conteúdos relacionados
- Para obter informações sobre como essas variáveis são usadas em expressões, consulte Expressão linguagem & funções.
- Para usar variáveis do sistema de gatilho de escopo no pipeline, consulte Metadados de gatilho de referência no pipeline