# Construindo expressões

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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/transformation-functions.htm). 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 the Editar expressão da coluna icon na coluna.

2. Selecione um elemento e, em seguida, clique em the Inserir elemento de expressão selecionado icon 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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/lakehouse-datasets-architecture-streaming.htm#Landing).

* Funções: Calculam ou convertem valores. Forneça os argumentos na ordem mostrada pela assinatura da função. Consulte [Funções de expressão](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-functions.htm).

  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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-operators.htm).

* 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](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-headers.htm) 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`.

Editando uma expressão

Editando uma expressão

Editando uma expressão ![Editor de expressões combinando duas colunas do conjunto de dados com dois-pontos.](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_qdi_expression_editor.png)

## 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.

Nota informativaTestar chamadas para as funções `$SOURCE_LOOKUP` e `$TARGET_LOOKUP` não é suportado.

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.