Prefácio
A Linguagem de Transformação
Constantes
Operadores
Variáveis
Datas
Funções
- Categorias de função
  - Funções de agregação
  - Funções de agregação e Nulls
    - Condições do Filtro
  - Funções binárias
  - Funções de caractere
  - Funções de conversão
  - Funções de Limpeza de Dados
  - Funções de data
  - Funções de codificação
  - Funções financeiras
  - Funções numéricas
  - Funções científicas
  - Funções especiais
  - Funções de string
  - Funções de teste
  - Funções variáveis
  - Funções de janela
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- ASCII
- AVG
- BINARY_COMPARE
- BINARY_CONCAT
- BINARY_LENGTH
- BINARY_SECTION
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DEC_HEX
- DECODE
- DECOMPRESS
- EBCDIC_ISO88591
- ENC_BASE64
- ENC_HEX
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- ISNULL
- IS_DATE
- IS_NUMBER
- IS_SPACES
- LAG
- LAST
- LAST_DAY
- LEAD
- LEAST
- LENGTH
- LN
- LOG
- LOOKUP
- LOWER
- LPAD
- LTRIM
- MAKE_DATE_TIME
- MAX (Datas)
- MAX (Números)
- MAX (String)
- MD5
- MEDIAN
- METAPHONE
- MIN (Datas)
- MIN (Números)
- MIN (String)
- MOD
- MOVINGAVG
- MOVINGSUM
- NPER
- PERCENTILE
- PMT
- POWER
- PV
- RAND
- RATE
- REG_EXTRACT
- REG_MATCH
- REG_REPLACE
- REPLACECHR
- REPLACESTR
- REVERSE
- ROUND (Datas)
- ROUND (Números)
- RPAD
- RTRIM
- SETCOUNTVARIABLE
- SET_DATE_PART
- SETMAXVARIABLE
- SETMINVARIABLE
- SETVARIABLE
- SHA256
- SIGN
- SIN
- SINH
- SOUNDEX
- SQRT
- STDDEV
- SUBSTR
- SUM
- SYSTIMESTAMP
- TAN
- TANH
- TIME_RANGE
- TO_BIGINT
- TO_CHAR (Datas)
- TO_CHAR (Números)
- TO_DATE
- TO_DECIMAL
- TO_FLOAT
- TO_INTEGER
- TRUNC (Datas)
- TRUNC (Números)
- UPPER
- VARIANCE
Criação de funções personalizadas
Referência de API da Função Personalizada

Referência de Linguagem de Transformação

10.5
- 10.4.0

Anterior Avançar

FIRST

Retorna o primeiro valor encontrado em uma porta ou grupo. Você também pode aplicar um filtro para limitar as linhas lidas pelo

Serviço de Integração do PowerCenter

. Você pode aninhar somente uma função de agregação dentro de FIRST.

Sintaxe

FIRST( value [, filter_condition ] )

A tabela a seguir descreve os argumentos para este comando:

Argumento	Requerido/ Opcional	Descrição
valor	Requerido	Qualquer tipo de dados, exceto Binário. Passa os valores para os quais você deseja retornar o primeiro valor. Você pode inserir qualquer expressão de transformação válida.
filter_condition	Opcional	Limita as linhas na pesquisa. A condição de filtro deve ser um valor numérico ou avaliada como TRUE, FALSE ou NULL. Você pode inserir qualquer expressão de transformação válida.

Valor de Retorno

Primeiro valor em um grupo.

NULL se todos os valores passados para a função forem NULL ou se nenhuma linha for selecionada (por exemplo, a condição de filtro avaliada como FALSE ou NULL em todas as linhas).

Nulls

Se um valor for NULL, FIRST ignorará a linha. No entanto, se todos os valores passados da porta forem NULL, FIRST retornará NULL.

Por padrão, o

Serviço de Integração do PowerCenter

trata valores nulos como NULL em funções de agregação. Se você passar uma porta ou um grupo completo de valores nulos, a função retornará NULL. Mas se você configurar o

Serviço de Integração do PowerCenter

, poderá escolher como quer tratar valores nulos em funções de agregação. Você pode tratar valores nulos em funções de agregação como 0 ou como NULL.

Agrupar por

FIRST agrupa valores baseados em grupos por portas que você define na transformação, retornando um resultado para cada grupo.

Se não houver grupo por porta, FIRST tratará todas as linhas como um grupo, retornando um valor.

Exemplos

A seguinte expressão retorna a primeira linha na porta ITEM_NAME com um preço maior que US$ 10,00:

FIRST( ITEM_NAME, ITEM_PRICE > 10 )

ITEM_NAME	ITEM_PRICE
Flashlight	35.00
Navigation Compass	8.05
Regulator System	150.00
Flashlight	29.00
Depth/Pressure Gauge	88.00
Flashlight	31.00
RETURN VALUE: Flashlight

A seguinte expressão retorna a primeira linha na porta ITEM_NAME com um preço maior que US$ 40,00:

FIRST( ITEM_NAME, ITEM_PRICE > 40 )

ITEM_NAME	ITEM_PRICE
Flashlight	35.00
Navigation Compass	8.05
Regulator System	150.00
Flashlight	29.00
Depth/Pressure Gauge	88.00
Flashlight	31.00
RETURN VALUE: Regulator System

Funções

Baixar guia

Enviar comentários

Communities

Knowledge Base

Portal de Sucesso

Rename Saved Search

Sumário

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

FIRST

FIRST

Sintaxe

Valor de Retorno

Nulls

Agrupar por

Exemplos