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

ARRAY_POPFRONT

array_popfront​

デスクリプション​

配列から最初の要素を削除します。この関数は、元の配列から最初の要素を除くすべての要素を含む新しい配列を返します。

Syntax​

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の場合

使用上の注意:

  • この関数は配列から最初の要素を削除し、残りの要素を返します
  • 空の配列は空の配列を返し、要素が1つだけの配列は空の配列を返します
  • 配列要素内の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]                      |
+------------------------------------------+

要素が1つしかない配列は空の配列を返します：

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}]                                                                                  |
+-------------------------------------------------------------------------------------------------------------------------------------------+

Keywords​

ARRAY、POPFRONT、ARRAY_POPFRONT