카테고리:: 변환 함수 , 반정형 및 정형 데이터 함수 (배열/오브젝트)

TO_ARRAY¶

입력 식을 ARRAY 값으로 변환합니다.

구문¶

TO_ARRAY( <expr> )

인자¶

expr: 모든 데이터 타입의 식입니다.

반환¶

이 함수는 ARRAY 타입 또는 NULL의 값을 반환합니다.

입력이 ARRAY 또는 ARRAY 값이 포함된 VARIANT 인 경우 값이 변경되지 않고 반환됩니다.

expr 이 NULL 또는 JSON null 값인 경우 함수는 NULL 을 반환합니다.

다른 값의 경우 반환되는 값은 이 값을 포함하는 단일 요소 배열입니다.

사용법 노트¶

둘 이상의 요소를 포함하는 배열을 만들려면 ARRAY_CONSTRUCT 또는 STRTOK_TO_ARRAY 를 사용할 수 있습니다.

예¶

테이블을 만들고 TO_ARRAY 함수를 호출하여 데이터를 삽입합니다.

CREATE OR REPLACE TABLE array_demo_2 (
  ID INTEGER,
  array1 ARRAY,
  array2 ARRAY);

INSERT INTO array_demo_2 (ID, array1, array2)
  SELECT 1, TO_ARRAY(1), TO_ARRAY(3);

SELECT * FROM array_demo_2;

+----+--------+--------+
| ID | ARRAY1 | ARRAY2 |
|----+--------+--------|
|  1 | [      | [      |
|    |   1    |   3    |
|    | ]      | ]      |
+----+--------+--------+

삽입 중에 생성된 단일 요소 배열과 ARRAY_CAT 을 호출하여 두 배열을 연결한 결과를 표시하는 쿼리를 실행합니다.

SELECT array1, array2, ARRAY_CAT(array1, array2)
  FROM array_demo_2;

+--------+--------+---------------------------+
| ARRAY1 | ARRAY2 | ARRAY_CAT(ARRAY1, ARRAY2) |
|--------+--------+---------------------------|
| [      | [      | [                         |
|   1    |   3    |   1,                      |
| ]      | ]      |   3                       |
|        |        | ]                         |
+--------+--------+---------------------------+

이 예에서는 TO_ARRAY 가 입력 식에 쉼표와 같은 구분 기호가 포함된 경우에도 문자열 입력 식을 단일 요소가 있는 배열로 변환하는 것을 보여줍니다.

SELECT TO_ARRAY('snowman,snowball,snowcone') AS to_array_result;

+-------------------------------+
| TO_ARRAY_RESULT               |
|-------------------------------|
| [                             |
|   "snowman,snowball,snowcone" |
| ]                             |
+-------------------------------+

동일한 문자열 입력 식을 여러 요소가 있는 배열로 변환하려면 STRTOK_TO_ARRAY 함수를 사용할 수 있습니다.

SELECT STRTOK_TO_ARRAY('snowman,snowball,snowcone', ',') AS strtok_to_array_result;

+------------------------+
| STRTOK_TO_ARRAY_RESULT |
|------------------------|
| [                      |
|   "snowman",           |
|   "snowball",          |
|   "snowcone"           |
| ]                      |
+------------------------+