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 值：null 元素会被正常处理
查询示例：
移除数组的第一个元素：
移除字符串数组的第一个元素：
```sql
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}] |
+-------------------------------------------------------------------------------------------------------------------------------------------+
Keywords
ARRAY, POPFRONT, ARRAY_POPFRONT
