に最終更新
ARRAY_POPBACK
array_popback
説明
配列から最後の要素を削除します。この関数は、元の配列から最後の要素を除いたすべての要素を含む新しい配列を返します。
構文
array_popback(ARRAY<T> arr)
パラメータ
arr：ARRAY型。最後の要素を削除する対象の配列
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_popback(['apple', 'banana', 'cherry', 'date']);
+--------------------------------------------------+
| array_popback(['apple', 'banana', 'cherry', 'date']) |
+--------------------------------------------------+
| ["apple", "banana", "cherry"] |
+--------------------------------------------------+
null 値を含む配列から最後の要素を削除する例：
SELECT array_popback([1, null, 3, null, 5]);
+--------------------------------------------+
| array_popback([1, null, 3, null, 5]) |
+--------------------------------------------+
| [1, null, 3, null] |
+--------------------------------------------+
要素が一つだけの配列は空の配列を返します：
SELECT array_popback([42]);
+----------------------+
| array_popback([42]) |
+----------------------+
| [] |
+----------------------+
空の配列は空の配列を返します：
SELECT array_popback([]);
+----------------------+
| array_popback([]) |
+----------------------+
| [] |
+----------------------+
NULL 配列は NULL を返します：
SELECT array_popback(NULL);
+----------------------+
| array_popback(NULL) |
+----------------------+
| NULL |
+----------------------+
IP アドレスの配列から最後の要素を削除する例：
SELECT array_popback(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>));
+----------------------------------------------------------------------------------+
| array_popback(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>)) |
+----------------------------------------------------------------------------------+
| ["192.168.1.1", "192.168.1.2"] |
+----------------------------------------------------------------------------------+
ネストした配列から最後の要素を削除する例：
SELECT array_popback([[1, 2], [3, 4], [5, 6]]);
+------------------------------------------+
| array_popback([[1, 2], [3, 4], [5, 6]]) |
+------------------------------------------+
| [[1, 2], [3, 4]] |
+------------------------------------------+
MAP の配列から最後の要素を削除する例：
SELECT array_popback([{'name':'Alice','age':20}, {'name':'Bob','age':30}, {'name':'Charlie','age':40}]);
+--------------------------------------------------------------------------------------------------+
| array_popback([{'name':'Alice','age':20}, {'name':'Bob','age':30}, {'name':'Charlie','age':40}]) |
+--------------------------------------------------------------------------------------------------+
| [{"name":"Alice", "age":"20"}, {"name":"Bob", "age":"30"}] |
+--------------------------------------------------------------------------------------------------+
STRUCT の配列から最後の要素を削除する例：
SELECT array_popback(array(named_struct('name','Alice','age',20), named_struct('name','Bob','age',30), named_struct('name','Charlie','age',40)));
+-------------------------------------------------------------------------------------------------------------------------------------------+
| array_popback(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}] |
+-------------------------------------------------------------------------------------------------------------------------------------------+
キーワード
ARRAY, POPBACK, ARRAY_POPBACK