Diese Seite wurde mit KI-Unterstützung aus dem Englischen übersetzt. Bei Abweichungen ist die englische Version maßgeblich.
FIRST_VALUE
Gibt den Wert des Ausdrucks zurück, der für die erste Zeile im Fensterrahmen ausgewertet wird.
Diese eingebaute Fensterfunktion berechnet den Fensterrahmen für jede Zeile auf dieselbe Weise wie eine Aggregat-Fensterfunktion. Sie gibt für jede Zeile den Wert des Ausdrucks zurück, der für die erste Zeile im Fensterrahmen ausgewertet wird.
Siehe auch:
[SELECT] [LAST_VALUE] [NTH_VALUE]
Syntax
SELECT FIRST_VALUE(expr) OVER (
[PARTITION BY column]
ORDER BY column
[ROWS BETWEEN frame_start AND frame_end]
) FROM <multipartIdentifier>;
Argumente
expr Der Ausdruck, der für die erste Zeile im Fensterrahmen ausgewertet wird.
PARTITION BY column
Optional. Teilt die Ergebnismenge in Partitionen auf. Die Funktion FIRST_VALUE wird innerhalb jeder Partition separat angewendet.
ORDER BY column Legt die Reihenfolge fest, in der die Zeilen verarbeitet werden.
ROWS BETWEEN frame_start AND frame_end Optional. Definiert den Fensterrahmen. Gängige Optionen sind:
ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROWROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
Ohne Rahmenklausel ist der Fensterrahmen RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW: Er endet bei der letzten Zeile, die in den ORDER BY-Spalten mit der aktuellen Zeile gleichrangig ist, nicht bei der aktuellen Zeile.
Rückgabewert(e)
Gibt den Wert des Ausdrucks zurück, der für die erste Zeile im Fensterrahmen ausgewertet wird.
Beispiele
Das erste Release als Kontext ermitteln
-- Find first and latest release for context
SELECT
tag_name,
name,
published_at,
FIRST_VALUE(tag_name) OVER (
ORDER BY published_at
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
) as first_release,
LAST_VALUE(tag_name) OVER (
ORDER BY published_at
ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
) as latest_release
FROM github.repos.releases
WHERE owner = 'stackql'
AND repo = 'stackql';
Standardmäßig erstreckt sich der Fensterrahmen vom Anfang der Partition bis zur letzten Zeile, die in den ORDER BY-Spalten mit der aktuellen Zeile gleichrangig ist. FIRST_VALUE liest die erste Zeile des Rahmens und gibt daher mit dem Standardrahmen und mit ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING denselben Wert zurück; der explizite Rahmen ist für LAST_VALUE und NTH_VALUE relevant, die weiter in den Rahmen hineinlesen.
Weitere Informationen finden Sie unter https://sqlite.org/windowfunctions.html#built-in_window_functions.