Catégories :

Fonctions de données semi-structurées (tableau/objet)

ARRAY_MIN

Étant donné un ARRAY d’entrée, renvoie l’élément dont la valeur la plus faible n’est pas SQL NULL. Si le ARRAY d’entrée est vide ou ne contient que des éléments SQL NULL, cette fonction renvoie NULL.

Syntaxe

ARRAY_MIN( <array> )
Copy

Arguments

array

Le ARRAY d’entrée.

Renvoie

Cette fonction renvoie un VARIANT qui contient l’élément dont la valeur la plus faible n’est pas un SQL NULL.

La fonction renvoie NULL si array est NULL, vide, ou ne contient que des éléments SQL NULL.

Notes sur l’utilisation

Un SQL NULL se distingue d’une valeur nulle explicite dans les données semi-structurées (par exemple, un JSON null dans des données JSON). Les valeurs nulles explicites sont prises en compte lors de l’identification de l’élément ayant la valeur la plus faible.

Exemples

L’exemple suivant renvoie un VARIANT contenant l’élément ayant la valeur la plus faible dans une constante ARRAY :

SELECT ARRAY_MIN([20, 0, NULL, 10, NULL]);
Copy
+------------------------------------+
| ARRAY_MIN([20, 0, NULL, 10, NULL]) |
|------------------------------------|
| 0                                  |
+------------------------------------+

L’exemple suivant montre que la fonction renvoie NULL si le ARRAY d’entrée est vide :

SELECT ARRAY_MIN([]);
Copy
+---------------+
| ARRAY_MIN([]) |
|---------------|
| NULL          |
+---------------+

L’exemple suivant montre que la fonction renvoie NULL si le ARRAY d’entrée ne contient que des SQL NULLs :

SELECT ARRAY_MIN([NULL, NULL, NULL]);
Copy
+-------------------------+
| ARRAY_MIN([NULL, NULL]) |
|-------------------------|
| NULL                    |
+-------------------------+