Variáveis de sistema suportadas pelo Azure Data Factory e Azure Synapse Analytics

  • Artigo

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