Construindo expressões

Última atualização: 28/10/2026

Use expressões para calcular valores de coluna ou definir condições ao adicionar colunas, editar expressões de coluna, criar regras de transformação ou filtrar conjuntos de dados.

O construtor de expressões lista os elementos disponíveis para a tarefa atual. As referências de tarefas de movimentação abrangem tarefas de aterrisagem gerenciada por SaaS, aterrisagem em lake e replicação. As expressões de armazenamento, transformação e data mart dependem da plataforma de dados ou do mecanismo de tarefas. Para funções de CDC Storage e Streaming Transform, consulte Funções de transformação. Use as funções e a sintaxe disponíveis em seu editor.

Criando ou editando uma expressão

1. Abra o construtor de expressões a partir da coluna, regra de transformação ou filtro de conjunto de dados que você está configurando.

   Para uma expressão de coluna, clique em na coluna.

2. Selecione um elemento e, em seguida, clique em para inseri-lo.

   Você também pode digitar a expressão. Insira parâmetros de coluna para fornecer valores de cada linha de origem, preservando a sintaxe usada pelo seu editor.

   Para inserir um operador da barra de ferramentas, clique onde ele deve ficar na expressão e, em seguida, clique no operador.

3. Substitua os espaços reservados de argumentos de função por parâmetros de coluna, constantes ou expressões aninhadas.

   Coloque as constantes de texto e data entre aspas simples, como 'Unknown' e '2026-10-08'. Represente uma aspa incorporada com duas aspas: 'O''Brien'. Insira números sem aspas, como 12 ou 12.5. Use NULL para um valor ausente, não o texto 'NULL'.

4. Teste a expressão conforme descrito abaixo e, em seguida, clique em OK para salvá-la.

Usando elementos de expressão

• Colunas: as colunas do conjunto de dados de origem fornecem valores da linha que está sendo processada.

  Para tarefas de Streaming Transform, esta lista também inclui colunas de aterrisagem como hdr__kafka_partition e hdr__file_name, na ordem de origem. Estes são separados dos cabeçalhos Q_H_ em expressões de tarefa de movimento. Consulte Tabelas de preparação.

• Funções: Calculam ou convertem valores. Forneça os argumentos na ordem mostrada pela assinatura da função. Consulte Funções de expressão.

  Nota informativaPara expressões do Azure Synapse Analytics, $RTRIM e $LTRIM removem apenas espaços, independentemente do caractere de corte especificado.

• Operadores: Combine valores, compare-os ou defina condições. Use parênteses para controlar a ordem de avaliação. Consulte Operadores de expressão.

• Cabeçalhos: Use metadados de alteração em tarefas de aterrisagem gerenciada por SaaS, aterrisagem em lake e replicação. Consulte Cabeçalhos de expressão para a aplicabilidade do endpoint de origem e os valores da fase de processamento.

Exemplo: Combinando valores de coluna

A expressão a seguir une first_file_name e first_file_title com dois-pontos:

${first_file_name} || ':' || ${first_file_title}

Para os valores de exemplo sales e Sales June 2022, o resultado é sales:Sales June 2022.

Testando expressões

Use valores de parâmetro de exemplo para verificar o resultado calculado antes de salvar. A extração de parâmetros identifica as entradas da expressão; o teste avalia a expressão com os valores que você fornece.

1. Clique em Extrair parâmetros.

2. Insira um Valor a ser testado para cada parâmetro, usando valores apropriados para o tipo de dados da coluna.

3. Clique em Testar expressão e verifique o resultado.

Se a expressão for inválida, corrija sua sintaxe e argumentos e, em seguida, extraia os parâmetros novamente antes de refazer o teste. Repita com valores representativos, incluindo valores ausentes onde for relevante. Um teste de amostragem bem-sucedido não verifica todas as linhas de origem.