Compartilhar via


Avalie suas expressões de pipeline antes de executá-las

Este artigo mostra como usar o recurso Avaliar expressão no Microsoft Fabric Data Factory para testar e depurar suas expressões de pipeline. Você aprenderá a verificar saídas de expressão, examinar componentes individuais e validar sua lógica sem executar todo o pipeline.

Veja o que você pode fazer com o recurso avaliar expressão:

  • Verificar a saída final
  • Examine cada parte da expressão (parâmetros, variáveis, funções, variáveis do sistema)
  • Insira valores de exemplo para itens que só existem quando o pipeline é executado

Dessa forma, você pode confirmar se a lógica e a formatação funcionam corretamente antes de agendar ou executar o pipeline.

Captura de tela do recurso Avaliar expressão mostrando a avaliação dinâmica do conteúdo.

Quando usar o recurso Avaliar expressão

Aqui estão algumas maneiras pelas quais o recurso Avaliar expressão pode ajudá-lo:

  • Confirme a cadeia de caracteres final ou o valor que sua expressão retorna (como um caminho de pasta datado ou nome de arquivo formatado)
  • Verifique se os parâmetros e as variáveis funcionam corretamente em sua expressão
  • Testar combinações de função (cadeia de caracteres, data/hora, matemática) e ver os resultados imediatamente
  • Forneça entradas de exemplo para itens que existem apenas durante uma execução real de pipeline (como valores de gatilho ou saídas de atividade)

Como usar o recurso Avaliar expressão

  1. Abra o construtor de expressões no pipeline.

    Captura de tela de uma atividade do Outlook com uma opção para exibir no construtor de expressões.

  2. Digite ou cole sua expressão.

    Captura de tela do construtor de expressões do pipeline com conteúdo de expressão.

  3. Selecione Avaliar expressão.

    Captura de tela do botão Avaliar expressão dentro do construtor de expressões pipeline.

  4. Examine a seção Valor na tabela que mostra cada parte da expressão (parâmetros, variáveis, variáveis do sistema, funções).

    Captura de tela do campo de entrada para avaliar o valor do conteúdo dinâmico.

  5. Se qualquer parte precisar de um valor de exemplo (como um tempo de gatilho ou saída de uma atividade), digite-o no campo Valor .

  6. Selecione Avaliar novamente para ver o resultado atualizado.

    Captura de tela da avaliação do conteúdo dinâmico e da visualização da expressão.

    Dica

    O painel geralmente preenche valores padrão para parâmetros e variáveis. Você pode alterá-los para testar diferentes cenários.

Limitações atuais

Atualmente, a avaliação ocorre antes da execução do pipeline. O avaliador não sabe nada que ocorra em tempo de execução ou depois. Ele não efetua pull de uma ID de execução, ID da instância de gatilho, saídas de atividade ou quaisquer valores que existam apenas durante uma execução. Portanto, você precisará fornecer manualmente esses valores.

Em vez disso, o que fazer: Na coluna Valor , digite valores de exemplo para espelhar os dados esperados no runtime (como colar um JSON fictício para activity('LookupCustomers').output). Isso permite validar a estrutura e a formatação da expressão, mesmo que o pipeline não esteja em execução.