Type VARIANT

S’applique à : Databricks SQL Databricks Runtime 15.3 et versions ultérieures

Importante

Cette fonctionnalité est disponible en préversion publique .

Représente des données semi-structurées.

Remarque

Les tables Iceberg ne prennent pas en charge les colonnes VARIANT.

Syntaxe

VARIANT

limites

Le type prend en charge le stockage de toutes les données semi-structurées, notamment STRUCT, ARRAY, MAP et les types scalaires. VARIANT ne peut stocker que des types MAP avec des clés de type STRING.

Littéraux

Consultez la fonction parse_json, fonction pour plus de détails sur la création d’une valeur VARIANT. Vous pouvez également utiliser la fonction CAST pour convertir un littéral d’un certain type en VARIANT.

Remarques

• Pour extraire une valeur d’un VARIANT, vous pouvez utiliser l’un des éléments suivants :
  • variant_get, fonction à l’aide d’une expression de chemin d’accès JSON pour naviguer dans un type complexe.
  • l’opérateur : (signe deux-points) pour analyser VARIANT à l’aide d’une expression de chemin JSON.
  • try_variant_get, fonction à l’aide d’un chemin JSON pour naviguer dans un type complexe avec une certaine tolérance d’erreur.
  • cast, fonction ou :: (signe deux-points), opérateur pour convertir le VARIANT en un type spécifique.
  • try_cast, fonction pour convertir le VARIANT en un type spécifique avec une certaine tolérance d’erreur.
• Pour inspecter le type d’une valeur VARIANT, utilisez l’un des éléments suivants :
  • schema_of_variant, fonction pour une valeur individuelle.
  • schema_of_variant_agg aggregate, fonction pour une collection de valeurs.

Exemples

> 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

Connexe

• Opérateur :: (signe deux fois deux points)
• Fonction cast
• Fonction parse_json
• Fonction schema_of_variant
• schema_of_variant_agg fonction d’agrégation
• Fonction try_cast
• Fonction try_variant_get
• Fonction variant_get