メインコンテンツまでスキップ
に最終更新

ARRAY_PUSHBACK

array_pushback​

SinceVersion 2.0.0

説明​

配列の末尾に要素を追加します。この関数は、元の配列のすべての要素と追加した要素を含む新しい配列を返します。

別名​

  • array_append

構文​

array_pushback(ARRAY<T> arr, T element)

パラメータ​

  • arr：ARRAY 型。要素を追加する対象の配列
  • element：T 型。配列の末尾に追加する要素

T でサポートされる型：

  • 数値型: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 文字列型: CHAR, VARCHAR, STRING
  • 日付と時刻の型: DATE, DATETIME, DATEV2, DATETIMEV2
  • 真偽値型: BOOLEAN
  • IP 型: IPV4, IPV6
  • 複合型: ARRAY, MAP, STRUCT

戻り値​

戻り値の型: ARRAY

戻り値の意味:

  • 元の配列のすべての要素と追加した要素を含む新しい配列を返します
  • NULL: 入力配列が NULL の場合

使用上の注意:

  • 指定した要素を配列の末尾に追加します
  • 空の配列にも要素を追加できます。追加する要素の型は、配列の要素型と互換性がある必要があります
  • 配列内の NULL 要素も通常どおり扱われます

クエリ例：

文字列配列の末尾に要素を追加します:

SELECT array_pushback(['apple', 'banana', 'cherry'], 'date');
+----------------------------------------------------+
| array_pushback(['apple', 'banana', 'cherry'], 'date') |
+----------------------------------------------------+
| ["apple", "banana", "cherry", "date"]              |
+----------------------------------------------------+

NULL 値を含む配列の末尾に NULL 要素を追加します:

SELECT array_pushback([1, null, 3], null);
+------------------------------------+
| array_pushback([1, null, 3], null) |
+------------------------------------+
| [1, null, 3, null]                 |
+------------------------------------+

空の配列の末尾に要素を追加します:

SELECT array_pushback([], 42);
+--------------------------+
| array_pushback([], 42)   |
+--------------------------+
| [42]                     |
+--------------------------+

浮動小数点数の配列の末尾に要素を追加します:

SELECT array_pushback([1.1, 2.2, 3.3], 4.4);
+------------------------------------------+
| array_pushback([1.1, 2.2, 3.3], 4.4)    |
+------------------------------------------+
| [1.1, 2.2, 3.3, 4.4]                    |
+------------------------------------------+

NULL の配列に対しては NULL を返します:

SELECT array_pushback(NULL, 1);
+--------------------------+
| array_pushback(NULL, 1)  |
+--------------------------+
| NULL                     |
+--------------------------+

IP アドレスの配列の末尾に要素を追加します:

SELECT array_pushback(CAST(['192.168.1.1', '192.168.1.2'] AS ARRAY<IPV4>), CAST('192.168.1.3' AS IPV4));
+----------------------------------------------------------------------------------+
| array_pushback(CAST(['192.168.1.1', '192.168.1.2'] AS ARRAY<IPV4>), CAST('192.168.1.3' AS IPV4)) |
+----------------------------------------------------------------------------------+
| ["192.168.1.1", "192.168.1.2", "192.168.1.3"]                                   |
+----------------------------------------------------------------------------------+

ネストした配列の末尾に要素を追加します:

SELECT array_pushback([[1,2], [3,4]], [5,6]);
+------------------------------------------+
| array_pushback([[1,2], [3,4]], [5,6])   |
+------------------------------------------+
| [[1, 2], [3, 4], [5, 6]]                |
+------------------------------------------+

MAP の配列の末尾に要素を追加します:

SELECT array_pushback([{'a':1}, {'b':2}], {'c':3});
+----------------------------------------------+
| array_pushback([{'a':1}, {'b':2}], {'c':3}) |
+----------------------------------------------+
| [{"a":1}, {"b":2}, {"c":3}]                 |
+----------------------------------------------+

STRUCT の配列の末尾に要素を追加します:

SELECT array_pushback(array(named_struct('name','Alice','age',20), named_struct('name','Bob','age',30)), named_struct('name','Charlie','age',40));
+-------------------------------------------------------------------------------------------------------------------------------------------+
| array_pushback(array(named_struct('name','Alice','age',20), named_struct('name','Bob','age',30)), named_struct('name','Charlie','age',40)) |
+-------------------------------------------------------------------------------------------------------------------------------------------+
| [{"name":"Alice", "age":20}, {"name":"Bob", "age":30}, {"name":"Charlie", "age":40}]                                                    |
+-------------------------------------------------------------------------------------------------------------------------------------------+

パラメータの数が正しくない場合のエラー:

SELECT array_pushback([1,2,3]);
ERROR 1105 (HY000): errCode = 2, detailMessage: Can not found function 'array_pushback' which has 1 arity. Candidate functions are: [array_pushback(Expression, Expression)]

配列以外の型を渡した場合のエラー:

SELECT array_pushback('not_an_array', 1);
ERROR 1105 (HY000): errCode = 2, detailMessage: Can not find the compatibility function signature: array_pushback(VARCHAR(12), TINYINT)

キーワード​

ARRAY, PUSHBACK, ARRAY_PUSHBACK

Report issue