カテゴリ：

変換関数

TO_VARIANT

任意の値を VARIANT 値または NULL に変換します（入力が NULLの場合）。

構文

TO_VARIANT( <expr> )

引数

expr

任意のデータ型の式です。

使用上の注意

  • TO_VARIANT 関数を INSERT ステートメントで直接使用することはできません。代わりに、 INSERT INTO ... SELECT... を使用してください。例のセクションでは、これを行う方法を示します。

例

テーブルに VARIANT 値を挿入するには TO_VARIANT と PARSE_JSON を使用します。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"     | }                   |
|                  |          |                       | ]              |                     |
+------------------+----------+-----------------------+----------------+---------------------+