Categorias:: Funções de conversão

TO_VARIANT¶

Converte qualquer valor em um valor VARIANT ou NULL (se a entrada for NULL).

Sintaxe¶

TO_VARIANT( <expr> )

Argumentos¶

expr: Uma expressão de qualquer tipo de dados.

Notas de uso¶

A função TO_VARIANT não pode ser usada diretamente em uma instrução INSERT. Em vez disso, use INSERT INTO ... SELECT.... A seção Exemplos mostra como fazer isso.

Exemplos¶

Use TO_VARIANT e PARSE_JSON para inserir valores VARIANT em uma tabela. A função PARSE_JSON retorna um valor 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"     | }                   |
|                  |          |                       | ]              |                     |
+------------------+----------+-----------------------+----------------+---------------------+