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

ARRAY_POPBACK

array_popback​

SinceVersion 2.0.0

説明​

配列の最後の要素を削除します。元の配列から最後の要素を除いたすべての要素を含む新しい配列を返します。

構文​

array_popback(ARRAY<T> arr)

パラメータ​

  • arr：ARRAY 型。最後の要素を削除する対象の配列

T に使用できる型:

  • 数値型: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 文字列型: CHAR, VARCHAR, STRING
  • 日付・時刻型: DATE, DATETIME, DATEV2, DATETIMEV2, TIMESTAMP_NS
  • 真偽値型: BOOLEAN
  • IP 型: IPV4, IPV6
  • UUID: UUID
  • 複合型: 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

Report issue