- カテゴリ:
半構造化データ関数 (配列/オブジェクト)
ARRAY_MIN¶
入力 ARRAY が与えられると、 SQL NULL ではない最小値を持つ要素を返します。入力 ARRAY が空であるか、または SQL NULL の要素のみを含む場合、この関数は NULL を返します。
構文¶
ARRAY_MIN( <array> )
引数¶
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]);
+------------------------------------+
| ARRAY_MIN([20, 0, NULL, 10, NULL]) |
|------------------------------------|
| 0 |
+------------------------------------+
次の例は、入力 ARRAY が空の場合、関数が NULL を返すことを示しています。
SELECT ARRAY_MIN([]);
+---------------+
| ARRAY_MIN([]) |
|---------------|
| NULL |
+---------------+
次の例は、入力 ARRAY が SQL NULLs のみを含む場合、関数が NULL を返すことを示しています。
SELECT ARRAY_MIN([NULL, NULL, NULL]);
+-------------------------+
| ARRAY_MIN([NULL, NULL]) |
|-------------------------|
| NULL |
+-------------------------+