ARRAY_CAT
ARRAY_CAT
ARRAY_CAT는 두 배열의 연결(concatenation) 결과를 반환하는 반자 구조 데이터 함수예요. 두 배열의 요소를 이어 붙인 하나의 배열이 필요할 때 사용해요.
본문
카테고리: 반자 구조·정형 데이터 함수 (Array/Object)
구문 (Syntax)
ARRAY_CAT( <array1> , <array2> )
인자 (Arguments)
<array1> — 소스 배열이에요.
<array2> — array1 뒤에 추가될 배열이에요.
반환값 (Returns)
array1의 요소 뒤에 array2의 요소를 추가한 ARRAY를 반환해요.
사용 시 유의사항 (Usage notes)
- 두 인자는 모두 구조화 ARRAY 또는 반자 구조 ARRAY여야 해요.
- 반자 구조 ARRAY를 전달한다면 두 인자 모두 ARRAY 타입이거나 배열을 포함하는 VARIANT여야 해요.
- 구조화 ARRAY를 전달한다면 함수는 두 입력 타입을 모두 수용할 수 있는 타입의 ARRAY를 반환해요.
- 인자 중 하나라도 NULL이면 함수는 오류를 보고하지 않고 NULL을 반환해요.
예시 (Examples)
이 예시는 ARRAY_CAT()를 어떻게 사용하는지 보여줘요:
간단한 테이블과 데이터를 만들어요:
CREATE TABLE array_demo (ID INTEGER, array1 ARRAY, array2 ARRAY);
INSERT INTO array_demo (ID, array1, array2)
SELECT 1, ARRAY_CONSTRUCT(1, 2), ARRAY_CONSTRUCT(3, 4);
쿼리를 실행해요:
SELECT ARRAY_CAT(array1, array2) FROM array_demo;
+---------------------------+
| ARRAY_CAT(ARRAY1, ARRAY2) |
|---------------------------|
| [ |
| 1, |
| 2, |
| 3, |
| 4 |
| ] |
+---------------------------+