Inhaltsverzeichnis

Search

  1. Vorwort
  2. Umwandlungssprache
  3. Konstanten
  4. Operatoren
  5. Variablen
  6. Datumsangaben
  7. Funktionen

Referenzhandbuch für die Umwandlungssprache

Referenzhandbuch für die Umwandlungssprache

FIRST

FIRST

Gibt den ersten Wert zurück, der in einem Port oder einer Gruppe gefunden wurde. Optional können Sie einen Filter anwenden, um die Anzahl der Zeilen zu beschränken, die
Data Integration Service
ausliest. Es kann nur eine weitere Aggregatfunktion in FIRST verschachtelt sein.

Syntax

FIRST(
value
[,
filter_condition
] )
In der folgenden Tabelle werden die Argumente für diesen Befehl beschrieben:
Argument
Erforderlich/
Optional
Beschreibung
value
Erforderlich
Alle Datentypen außer binär. Übergibt die Werte, für die Sie den ersten Wert zurückgeben möchten. Sie können einen beliebigen gültigen Umwandlungausdruck eingeben.
filter_condition
Optional
Begrenzt die Zeilen in der Suche. Die Filterbedingung muss ein numerischer Wert sein oder mit TRUE, FALSE oder NULL ausgewertet werden. Sie können einen beliebigen gültigen Umwandlungausdruck eingeben.

Rückgabewert

Erster Wert in einer Gruppe.
NULL, wenn alle übergebenen Werte NULL sind oder keine Zeilen ausgewählt wurden (z. B. wenn die Filterbedingung in allen Zeilen FALSE oder NULL ergibt).

Nullen

Wenn nur ein Wert NULL ist, ignoriert FIRST die Zeile. Wenn jedoch alle vom Port übergebenen Werte NULL ergeben, gibt FIRST NULL zurück.

Gruppieren nach

FIRST gruppiert die Werte nach der Einstellung „Gruppieren nach Ports“, die Sie in der Umwandlung festlegen, und gibt pro Gruppe ein Ergebnis zurück.
Wenn „Gruppieren nach Ports“ nicht festgelegt wurde, behandelt FIRST alle Zeilen als eine einzige Gruppe und gibt nur einen Wert zurück.

Beispiele

Der folgende Ausdruck gibt den ersten Wert im Port ITEM_NAME mit einem höheren Preis als 10.00 USD zurück:
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
Der folgende Ausdruck gibt den ersten Wert im Port ITEM_NAME mit einem höheren Preis als $40.00 USD zurück:
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