TO_VARIANT

TO_VARIANT

TO_VARIANT 함수는 모든 값을 VARIANT 값으로 변환해요. 입력이 NULL이면 NULL을 반환해요.

출처: TO_VARIANT

본문

TO_VARIANT 함수는 모든 값을 VARIANT 값으로 변환해요. 입력이 NULL이면 NULL을 반환해요.

구문 (Syntax)

TO_VARIANT( <expr> )

인자 (Arguments)

  • expr — 모든 데이터 타입의 표현식이에요.

사용 메모 (Usage notes)

  • TO_VARIANT 함수는 INSERT 문에서 직접 사용할 수 없어요. 대신 INSERT INTO ... SELECT...를 사용해요. 예제 섹션에서 방법을 보여줘요.

예제 (Examples)

TO_VARIANT와 PARSE_JSON을 사용해 VARIANT 값을 테이블에 삽입해요. PARSE_JSON 함수는 VARIANT 값을 반환해요:

CREATE OR REPLACE TABLE to_variant_example (
  v_varchar   VARIANT,
  v_number    VARIANT,
  v_timestamp VARIANT,
  v_array     VARIANT,
  v_object    VARIANT);

INSERT INTO to_variant_example (v_varchar, v_number, v_timestamp, v_array, v_object)
  SELECT
    TO_VARIANT('Skiing is fun!'),
    TO_VARIANT(3.14),
    TO_VARIANT('2024-01-25 01:02:03'),
    TO_VARIANT(ARRAY_CONSTRUCT('San Mateo', 'Seattle', 'Berlin')),
    PARSE_JSON(' { "key1": "value1", "key2": "value2" } ');

SELECT * FROM to_variant_example;
+------------------+----------+-----------------------+----------------+---------------------+
| V_VARCHAR        | V_NUMBER | V_TIMESTAMP           | V_ARRAY        | V_OBJECT            |
|------------------+----------+-----------------------+----------------+---------------------|
| "Skiing is fun!" | 3.14     | "2024-01-25 01:02:03" | [              | {                   |
|                  |          |                       |   "San Mateo", |   "key1": "value1", |
|                  |          |                       |   "Seattle",   |   "key2": "value2"  |
|                  |          |                       |   "Berlin"     | }                   |
|                  |          |                       | ]              |                     |
+------------------+----------+-----------------------+----------------+---------------------+

더 알아보기 (Learn more)

  • PARSE_JSON
  • 변환 함수 (Conversion functions)
  • 반정형 데이터 (Semi-structured data)