Tipo deVARIANT

Se aplica a: Databricks SQL Databricks Runtime 15.3 y versiones posteriores

Importante

Esta característica está en versión preliminar pública.

Representa datos semiestructurados.

Nota:

Iceberg v2 no admite columnas VARIANT. Apache Iceberg v3 admite VARIANT columnas. Consulte Uso de las características de Apache Iceberg v3.

Sintaxis

VARIANT

Límites

El tipo admite el almacenamiento de datos OBJECTsemiestructurados, ARRAYy tipos escalares. Para almacenar STRUCT y MAP usar la función to_variant_object . MAP las claves deben ser de tipo STRING.

Literales

Consulte la función parse_json para más detalles sobre la creación de un valor VARIANT. También puede usar la función CAST para convertir un literal de algún tipo en VARIANT.

Notas

• Para extraer un valor de un tipo VARIANT puede usar lo siguiente:
  • Función variant_get con una expresión de ruta de acceso JSON para navegar al tipo complejo.
  • El :operador : (signo de dos puntos) para analizar VARIANT mediante una expresión de ruta de acceso JSON.
  • La función try_variant_get mediante una ruta de acceso JSON para navegar a un tipo complejo con tolerancia a errores.
  • La función cast o el operador :: (signo de dos puntos) para convertir el tipo VARIANT en un tipo específico.
  • try_cast función para convertir VARIANT a un tipo específico con tolerancia de errores.
• Para inspeccionar el tipo de un valor VARIANT, use lo siguiente:
  • schema_of_variant función para un valor individual.
  • schema_of_variant_agg función de agregado para una colección de valores.

Ejemplos

> SELECT parse_json('{"key": 123, "data": [4, 5, "str"]}');
  {"data":[4,5,"str"],"key":123}

> SELECT parse_json(null);
  null

> SELECT parse_json('123');
  123

> SELECT CAST(123.456 AS VARIANT);
  123.456

> SELECT to_variant_object(map('key', 'val'));
  { "key": "val" }

> SELECT to_variant_object(struct('field', 'val'));
  { "field": "val" }

Temas relacionados

• Operador :: (doble dos puntos)
• cast Función
• parse_json Función
• schema_of_variant Función
• schema_of_variant_agg función de agregación
• try_cast Función
• try_variant_get Función
• variant_get Función