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 값이 있는 경우: 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