try_variant_insert Fonction

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 19 et supérieur

Retourne variantExpr avec val inséré à path, ou NULL pour des champs d’objet dupliqués ou des types intermédiaires incompatibles.

Syntax

try_variant_insert ( variantExpr, path, val )

Arguments

  • variantExpr: Une VARIANT expression.
  • path: Une STRING expression avec une expression de chemin JSON bien formée. Les index des tableaux sont basés sur zéro.
  • val: Une expression lancable à VARIANT.

Returns

Valeur de type VARIANT.

Les arguments SQL NULL retournent SQL NULL.

La fonction retourne SQL NULL pour les champs d’objets dupliqués ou les types intermédiaires incompatibles. Pour générer une erreur à la place, utilisez variant_insert.

Les trajectoires mal formées ou le chemin $ de racine augmentent INVALID_VARIANT_PATH, et les résultats dépassant la limite de taille de la variante augmentent VARIANT_SIZE_LIMIT.

Conditions d’erreur courantes

Examples

-- Insert an object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.b', 2)
  {"a":1,"b":2}

-- Duplicate object field
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a', 2)
  NULL

-- Incompatible path
> SELECT try_variant_insert(parse_json('{"a": 1}'), '$.a.b', 2)
  NULL

-- Invalid root path
> SELECT try_variant_insert(parse_json('{}'), '$', 1)
  Error: INVALID_VARIANT_PATH.