Table des matières

Search

  1. Préface
  2. Le langage de transformation
  3. Constantes
  4. Opérateurs
  5. Variables
  6. Dates
  7. Fonctions

Référence du langage de transformation

Référence du langage de transformation

FIRST

FIRST

Renvoie la première valeur trouvée dans un port ou un groupe. Vous pouvez également appliquer un filtre pour limiter les lignes lues par le
Service d'intégration de données
. Vous pouvez imbriquer une seule autre fonction Agrégation dans la fonction FIRST.

Syntaxe

FIRST(
value
[,
filter_condition
] )
Le tableau suivant décrit les arguments de cette commande:
Argument
Obligatoire/
Facultatif
Description
valeur
Obligatoire
Tout type de données excepté Binaire. Transmet les valeurs pour lesquelles vous voulez renvoyer la première valeur. Vous pouvez entrer l'expression de transformation valide de votre choix.
filter_condition
Facultatif
Limite les lignes dans la recherche. La condition de filtre doit être une valeur numérique ou renvoyer TRUE, FALSE ou NULL. Vous pouvez entrer l'expression de transformation valide de votre choix.

Valeur de retour

Première valeur dans un groupe.
NULL si toutes les valeurs transmises à la fonction sont NULL, ou si aucune ligne n'est sélectionnée (par exemple : la condition de filtre renvoie FALSE ou NULL pour toutes les lignes).

Valeurs nulles

Si une valeur est nulle, FIRST ignore la ligne. Cependant, si toutes les valeurs transmises à partir du port sont NULL, FIRST renvoie NULL.

Grouper par

FIRST groupe des valeurs en fonction du groupement par ports que vous définissez dans la transformation et renvoie un résultat pour chaque groupe.
S'il n'existe aucun port de regroupement, FIRST traite toutes les lignes comme un seul groupe et renvoie une seule valeur.

Exemples

L'expression suivante renvoie la première valeur dans le port ITEM_NAME et dont le montant est supérieur à 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
L'expression suivante renvoie la première valeur dans le port ITEM_NAME et dont le montant est supérieur à 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