variant_set Fonction

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

Renvoie variantExpr avec val inséré ou défini à path.

Syntax

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.

Le remplacement d’un élément du tableau ne déplace pas les autres éléments.

Si create_if_missing est true, les champs manquants et les conteneurs intermédiaires sont créés. Un index égal à la longueur du tableau ajoute val. Un index plus grand remplit le tableau avec des valeurs nulles variantes avant d’ajouter val.

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

Les arguments SQL NULL retournent SQL NULL.

Les types intermédiaires incompatibles font VARIANT_PATH_TYPE_MISMATCH, indépendamment de create_if_missing. Pour retourner SQL NULL à la place, utilisez try_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 variant_set(parse_json('{"a": 1}'), '$.a', 2)
  {"a":2}

-- Create a missing path
> SELECT variant_set(parse_json('{}'), '$.a.b', 1)
  {"a":{"b":1}}

-- Replace an array element
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[1]', 'z')
  ["a","z","c"]

-- Append at the array length
> SELECT variant_set(parse_json('["a", "b", "c"]'), '$[3]', 'z')
  ["a","b","c","z"]

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

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