カテゴリ:

半構造化データ関数 (配列/オブジェクト)

ARRAY_MIN

入力 ARRAY が与えられると、 SQL NULL ではない最小値を持つ要素を返します。入力 ARRAY が空であるか、または SQL NULL の要素のみを含む場合、この関数は NULL を返します。

構文

ARRAY_MIN( <array> )
Copy

引数

array

入力 ARRAY。

戻り値

この関数は、 SQL NULL ではない最小値を持つ要素を含む VARIANT を返します。

array が NULL であるか、空であるか、 SQL NULL の要素のみを含む場合、この関数は NULL を返します。

使用上の注意

SQL NULL は、半構造化データの明示的なnull値とは異なります(例: JSON データの JSON null)。明示的なnull値は、最小値を持つ要素を識別する際に考慮されます。

次の例は、 ARRAY 定数 の中で最小値を持つ要素を含む VARIANT を返します。

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

次の例は、入力 ARRAY が空の場合、関数が NULL を返すことを示しています。

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

次の例は、入力 ARRAY が SQL NULLs のみを含む場合、関数が NULL を返すことを示しています。

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