Categorias:: Funções de dados semiestruturados (Matriz/objeto)

ARRAY_MIN¶

Considerando uma ARRAY de entrada, retorna o elemento com o valor mais baixo que não seja SQL NULL. Se a ARRAY de entrada estiver vazia ou contiver apenas elementos SQL NULL, esta função retornará NULL.

Sintaxe¶

ARRAY_MIN( <array> )

Copy

Argumentos¶

array: A ARRAY de entrada.

Retornos¶

Esta função retorna um VARIANT que contém o elemento com o valor mais baixo que não seja SQL NULL.

A função retorna NULL se array for NULL, vazio ou contiver apenas elementos SQL NULL.

Notas de uso¶

Um SQL NULL é diferente de um valor nulo explícito em dados semiestruturados (por exemplo, um JSON nulo em dados JSON). Valores nulos explícitos são considerados ao identificar o elemento com o valor mais baixo.

Exemplos¶

O exemplo a seguir retorna um VARIANT contendo o elemento com o valor mais baixo em uma constante ARRAY:

SELECT ARRAY_MIN([20, 0, NULL, 10, NULL]);

Copy

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

O exemplo a seguir demonstra que a função retorna NULL se a ARRAY de entrada estiver vazia:

SELECT ARRAY_MIN([]);

Copy

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

O exemplo a seguir demonstra que a função retorna NULL se a ARRAY de entrada contiver apenas SQL NULLs:

SELECT ARRAY_MIN([NULL, NULL, NULL]);

Copy

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