Fonction variant_get

  • Article

S’applique à : coche pour oui Databricks SQL coche marquée oui 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 )

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 forcé dans le 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.