- Kategorien:
Semistrukturierte Datenfunktionen (Array/Objekt)
ARRAY_MIN¶
Gibt für ein Eingabe-ARRAY das Element mit dem niedrigsten Wert zurück, das nicht SQL NULL ist. Wenn das Eingabe-ARRAY leer ist oder nur SQL NULL-Elemente enthält, gibt diese Funktion NULL zurück.
Syntax¶
ARRAY_MIN( <array> )
Argumente¶
array
Das Eingabe-ARRAY.
Rückgabewerte¶
Diese Funktion gibt einen VARIANT-Wert zurück, der das Element mit dem niedrigsten Wert enthält, das nicht SQL NULL ist.
Die Funktion gibt NULL zurück, wenn array
NULL ist, leer ist oder nur SQL NULL-Elemente enthält.
Nutzungshinweise¶
Ein SQL NULL-Wert unterscheidet sich von einem expliziten Nullwert in semistrukturierten Daten (z. B. ein JSON null in JSON-Daten). Explizite Nullwerte werden bei der Identifizierung des Elements mit dem niedrigsten Wert berücksichtigt.
Beispiele¶
Im folgende Beispiel wird ein VARIANT-Wert zurückgegeben, der das Element mit dem niedrigsten Wert in einer ARRAY-Konstante enthält:
SELECT ARRAY_MIN([20, 0, NULL, 10, NULL]);
+------------------------------------+
| ARRAY_MIN([20, 0, NULL, 10, NULL]) |
|------------------------------------|
| 0 |
+------------------------------------+
Im folgenden Beispiel wird gezeigt, dass die Funktion den Wert NULL zurückgibt, wenn das Eingabe-ARRAY leer ist:
SELECT ARRAY_MIN([]);
+---------------+
| ARRAY_MIN([]) |
|---------------|
| NULL |
+---------------+
Im folgenden Beispiel wird gezeigt, dass die Funktion den Wert NULL zurückgibt, wenn das Eingabe-ARRAY nur SQL NULL-Werte enthält:
SELECT ARRAY_MIN([NULL, NULL, NULL]);
+-------------------------+
| ARRAY_MIN([NULL, NULL]) |
|-------------------------|
| NULL |
+-------------------------+