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> )

Copy

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]);

Copy

+------------------------------------+
| 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([]);

Copy

+---------------+
| 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]);

Copy

+-------------------------+
| ARRAY_MIN([NULL, NULL]) |
|-------------------------|
| NULL                    |
+-------------------------+