카테고리:

반정형 및 정형 데이터 함수 (배열/오브젝트)

ARRAY_CONSTRUCT

0개, 1개 또는 그 이상의 입력값으로 생성된 배열을 반환합니다.

배열을 생성하고 사용하는 방법에 대한 자세한 내용은 ARRAY 섹션을 참조하십시오.

참고 항목:

ARRAY_CONSTRUCT_COMPACT

구문

ARRAY_CONSTRUCT( [ <expr1> ] [ , <expr2> [ , ... ] ] )

인자

인자는 값(또는 값으로 평가되는 식)입니다. 인자 값은 다양한 데이터 타입이 될 수 있습니다.

반환

반환된 값의 데이터 타입은 ARRAY입니다.

사용법 노트

  • 함수가 N 개의 인자로 호출된 경우, 결과 배열의 크기는 N 입니다.

  • 많은 상황에서 ARRAY_CONSTRUCT 함수 대신 ARRAY 상수 (또는 ARRAY 리터럴 이라고도 함)를 사용할 수 있습니다.

  • 배열에는 SQL NULL 값과 JSON null 값이 모두 포함될 수 있습니다. 자세한 내용은 NULL 값 섹션을 참조하십시오.

예

숫자 데이터 타입으로 구성된 기본 배열을 구성합니다.

SELECT ARRAY_CONSTRUCT(10, 20, 30);

+-----------------------------+
| ARRAY_CONSTRUCT(10, 20, 30) |
|-----------------------------|
| [                           |
|   10,                       |
|   20,                       |
|   30                        |
| ]                           |
+-----------------------------+

SQL NULL 값(undefined)과 JSON null 값(null)을 포함한 다양한 데이터 타입으로 구성된 기본 배열을 구성합니다.

SELECT ARRAY_CONSTRUCT(NULL, PARSE_JSON('null'), 'hello', 3::DOUBLE, 4, 5);

+---------------------------------------------------------------------+
| ARRAY_CONSTRUCT(NULL, PARSE_JSON('NULL'), 'HELLO', 3::DOUBLE, 4, 5) |
|---------------------------------------------------------------------|
| [                                                                   |
|   undefined,                                                        |
|   null,                                                             |
|   "hello",                                                          |
|   3.000000000000000e+00,                                            |
|   4,                                                                |
|   5                                                                 |
| ]                                                                   |
+---------------------------------------------------------------------+

빈 배열을 구성합니다.

SELECT ARRAY_CONSTRUCT();

+-------------------+
| ARRAY_CONSTRUCT() |
|-------------------|
| []                |
+-------------------+

테이블을 만들고 ARRAY 열에 배열을 삽입합니다.

CREATE OR REPLACE TABLE construct_array_example (id INT, array_column ARRAY);

INSERT INTO construct_array_example (id, array_column)
  SELECT 1,
         ARRAY_CONSTRUCT(1, 2, 3);

INSERT INTO construct_array_example (id, array_column)
  SELECT 2,
         ARRAY_CONSTRUCT(4, 5, 6);

INSERT INTO construct_array_example (id, array_column)
  SELECT 3,
         ARRAY_CONSTRUCT(7, 8, 9);

SELECT * FROM construct_array_example;

+----+--------------+
| ID | ARRAY_COLUMN |
|----+--------------|
|  1 | [            |
|    |   1,         |
|    |   2,         |
|    |   3          |
|    | ]            |
|  2 | [            |
|    |   4,         |
|    |   5,         |
|    |   6          |
|    | ]            |
|  3 | [            |
|    |   7,         |
|    |   8,         |
|    |   9          |
|    | ]            |
+----+--------------+