Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

ERROR

ERROR

Faz com que o
Serviço de Integração do PowerCenter
ignore uma linha e emita uma mensagem de erro definida por você. A mensagem de erro é exibida no log de sessão. O
Serviço de Integração do PowerCenter
não grava as linhas ignoradas no arquivo rejeitado da sessão.
Use ERROR nas transformações de Expressão para validar dados. Geralmente, você usa ERROR com uma função IIF ou DECODE a fim de definir regras para ignorar linhas.
Use a função ERROR para os valores padrão da porta de entrada e de saída. Você pode usar ERROR em portas de entrada para impedir que valores nulos passem em uma transformação.
Use ERROR em portas de saída para tratar qualquer tipo de erro de transformação, incluindo as chamadas da função ERROR em uma expressão. Quando você usa a função ERROR em uma expressão e no valor padrão da porta de saída, o
Serviço de Integração do PowerCenter
ignora a linha e registra as mensagens de erro da expressão e do valor padrão. Para ter certeza de que o
Serviço de Integração do PowerCenter
ignorará as linhas que geram erro, atribua ERROR como valor padrão.
Se você usar um valor padrão de saída diferente de ERROR, o valor padrão substituirá a função ERROR em uma expressão. Por exemplo, use a função ERROR em uma expressão e atribua o valor padrão, '1234', à porta de saída. Sempre que encontra a função ERROR na expressão, o
Serviço de Integração do PowerCenter
substitui o erro pelo valor '1234' e passa '1234' à transformação seguinte. Ele não ignora a linha e não registra um erro no log da sessão.

Sintaxe

ERROR(
string
)
A tabela a seguir descreve o argumento para este comando:
Argumento
Requerido/
Opcional
Descrição
string
Requerido
Valor de string. A mensagem que você deseja exibir quando o Serviço de Integração ignora uma linha com base na expressão que contém a função ERROR. A string pode ter qualquer tamanho.

Valor de Retorno

String.

Exemplo

O exemplo a seguir mostra como consultar um mapeamento que calcula o salário médio de funcionários em todos os departamentos da organização, mas ignorar valores negativos. A seguinte expressão aninha a função ERROR em uma expressão IIF, de modo que se encontrar um salário negativo na porta Salário, o
Serviço de Integração do PowerCenter
ignorará a linha e exibirá um erro:
IIF( SALARY < 0, ERROR ('Error. Negative salary found. Row skipped.', EMP_SALARY )
SALARY
RETURN VALUE
10000
10000
-15000
'Error. Negative salary found. Row skipped.'
NULL
NULL
150000
150000
1005
1005