AS_ARRAY

AS_ARRAY

VARIANT 값을 ARRAY 값으로 캐스팅하는 함수예요. 값 타입이 ARRAY와 일치할 때만 값을 돌려주고, 아니면 NULL을 반환해요.

출처: 공식 문서

본문

VARIANT 값을 ARRAY 값으로 캐스팅합니다.

참고 (See also): AS_ , AS_OBJECT

구문 (Syntax)

AS_ARRAY( <variant_expr> )

인자 (Arguments)

variant_expr

VARIANT 타입의 값으로 평가되는 표현식입니다.

반환값 (Returns)

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

  • variant_expr 인자 안 값의 타입이 ARRAY이면, 함수는 ARRAY 타입의 값을 반환합니다.
  • variant_expr 인자 안 값의 타입이 출력 값의 타입과 일치하지 않으면, 함수는 NULL을 반환합니다.
  • variant_expr 인자가 NULL이면, 함수는 NULL을 반환합니다.

사용 참고 (Usage notes)

예제 (Examples)

테이블을 만들고 데이터를 로드합니다:

CREATE OR REPLACE TABLE as_array_example (
  array1 VARIANT,
  array2 VARIANT);

INSERT INTO as_array_example (array1, array2)
  SELECT
    TO_VARIANT(TO_ARRAY('Example')),
    TO_VARIANT(ARRAY_CONSTRUCT('Array-like', 'example'));

쿼리에서 AS_ARRAY 함수를 사용해 VARIANT 값을 ARRAY 값으로 캐스팅합니다:

SELECT AS_ARRAY(array1) AS array1,
       AS_ARRAY(array2) AS array2
  FROM as_array_example;

+-------------+-----------------+
| ARRAY1      | ARRAY2          |
|-------------+-----------------|
| [           | [               |
|   "Example" |   "Array-like", |
| ]           |   "example"     |
|             | ]               |
+-------------+-----------------+

더 알아보기 (Learn more)