メインコンテンツまでスキップ
バージョン: 26.x

ARRAY_SUM

機能​

ARRAY_SUM関数は、配列内のすべての数値要素の合計を計算します。

構文​

ARRAY_SUM(ARRAY<T>)

パラメータ​

ARRAY<T>: 数値型の要素を含む配列。

Return Value​

  • 配列内のすべての非NULL要素の合計を返します。

    • すべての要素がNULLの場合、NULLを返します。

Usage 注釈​

  1. 要素の合計には+演算子を使用します。

  2. NULLの要素は自動的に無視されます。

  3. 配列に非数値型の要素（文字列など）が含まれている場合、実行時エラーが発生します。

Examples​

  1. 簡単な例

    SELECT ARRAY_SUM([1, 2, 3, 4]);
    +-------------------------+
    | ARRAY_SUM([1, 2, 3, 4]) |
    +-------------------------+
    |                      10 |
    +-------------------------+

  2. 配列内のNULL値の処理

    SELECT ARRAY_SUM([1, NULL, 3]); 
    +-------------------------+
    | ARRAY_SUM([1, NULL, 3]) |
    +-------------------------+
    |                       4 |
    +-------------------------+

    SELECT ARRAY_SUM(NULL);
    +-----------------+
    | ARRAY_SUM(NULL) |
    +-----------------+
    |            NULL |
    +-----------------+

    SELECT ARRAY_SUM([NULL, NULL]); 
    +-------------------------+
    | ARRAY_SUM([NULL, NULL]) |
    +-------------------------+
    |                    NULL |
    +-------------------------+