try_variant_set Fonction

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

Retourne variantExpr avec val inséré ou défini à path, ou NULL pour des types intermédiaires incompatibles.

Syntax

try_variant_set ( variantExpr, path, val [, create_if_missing] )

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.
  • create_if_missing: Une expression constante optionnelle (pliable BOOLEAN ). Si true, crée des champs, éléments de tableau et des objets ou tableaux intermédiaires manquants le long pathde . La valeur par défaut est true.

Returns

Valeur de type VARIANT.

Si create_if_missing est false, une cible ou un chemin intermédiaire manquant reste variantExpr inchangé.

Les arguments SQL NULL retournent SQL NULL.

La fonction retourne SQL NULL pour les types intermédiaires incompatibles. Pour générer une erreur à la place, utilisez variant_set.

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

-- Replace an object field
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.a', 99)
  {"a":99}

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

-- Missing path with creation disabled
> SELECT try_variant_set(parse_json('{"a": 1}'), '$.b', 2, false)
  {"a":1}

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