に最終更新
ARRAY_POPFRONT
array_popfront
説明
配列から最初の要素を削除します。元の配列から最初の要素を除いたすべての要素を含む新しい配列を返します。
構文
array_popfront(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_popfront(['apple', 'banana', 'cherry', 'date']);
+----------------------------------------------------+
| array_popfront(['apple', 'banana', 'cherry', 'date']) |
+----------------------------------------------------+
| ["banana", "cherry", "date"] |
+----------------------------------------------------+
NULL 値を含む配列から最初の要素を削除します：
SELECT array_popfront([1, null, 3, null, 5]);
+------------------------------------------+
| array_popfront([1, null, 3, null, 5]) |
+------------------------------------------+
| [null, 3, null, 5] |
+------------------------------------------+
要素を一つだけ含む配列は空の配列を返します：
SELECT array_popfront([42]);
+------------------------+
| array_popfront([42]) |
+------------------------+
| [] |
+------------------------+
空の配列は空の配列を返します：
SELECT array_popfront([]);
+------------------------+
| array_popfront([]) |
+------------------------+
| [] |
+------------------------+
NULL 配列は NULL を返します：
SELECT array_popfront(NULL);
+------------------------+
| array_popfront(NULL) |
+------------------------+
| NULL |
+------------------------+
IP アドレスの配列から最初の要素を削除します：
SELECT array_popfront(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>));
+----------------------------------------------------------------------------------+
| array_popfront(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>)) |
+----------------------------------------------------------------------------------+
| ["192.168.1.2", "192.168.1.3"] |
+----------------------------------------------------------------------------------+
ネストした配列から最初の要素を削除します：
SELECT array_popfront([[1, 2], [3, 4], [5, 6]]);
+------------------------------------------+
| array_popfront([[1, 2], [3, 4], [5, 6]]) |
+------------------------------------------+
| [[3, 4], [5, 6]] |
+------------------------------------------+
MAP の配列から最初の要素を削除します：
SELECT array_popfront([{'name':'Alice','age':20}, {'name':'Bob','age':30}, {'name':'Charlie','age':40}]);
+---------------------------------------------------------------------------------------------------+
| array_popfront([{'name':'Alice','age':20}, {'name':'Bob','age':30}, {'name':'Charlie','age':40}]) |
+---------------------------------------------------------------------------------------------------+
| [{"name":"Bob", "age":"30"}, {"name":"Charlie", "age":"40"}] |
+---------------------------------------------------------------------------------------------------+
STRUCT の配列から最初の要素を削除します：
SELECT array_popfront(array(named_struct('name','Alice','age',20), named_struct('name','Bob','age',30), named_struct('name','Charlie','age',40)));
+-------------------------------------------------------------------------------------------------------------------------------------------+
| array_popfront(array(named_struct('name','Alice','age',20), named_struct('name','Bob','age',30), named_struct('name','Charlie','age',40))) |
+-------------------------------------------------------------------------------------------------------------------------------------------+
| [{"name":"Bob", "age":30}, {"name":"Charlie", "age":40}] |
+-------------------------------------------------------------------------------------------------------------------------------------------+
キーワード
ARRAY, POPFRONT, ARRAY_POPFRONT