Fonction variant_get

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

Extrait une valeur de type à partir de variantExpr, spécifié par path.

Syntaxe

variant_get ( variantExpr, path, type )

Les arguments

• variantExpr : expression VARIANT.
• path : un littéral STRING avec une expression de chemin JSON bien formée.
• type : un littéral STRING définissant le type.

Retours

Valeur de type type.

Si l’objet est introuvable, retourne NULL. Si l’objet est trouvé mais ne peut pas être converti en type souhaité, Azure Databricks déclenche INVALID_VARIANT_CAST. Pour retourner NULL au lieu d’une erreur, utilisez la fonction try_variant_get.

Exemples

-- Simple example
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.data[1].a', 'string')
  hello

-- missing path
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.missing', 'int')
  null

-- Invalid cast
> SELECT variant_get(parse_json('{"key": 123, "data": [4, {"a": "hello"}, "str"]}'), '$.key', 'array<int>')
  Error: INVALID_VARIANT_CAST.

Fonctions connexes

• Fonction try_variant_get
• Fonction parse_json
• Expression de chemin JSON