variant_set Função

Aplica-se a:marcado sim Databricks SQL marcado sim Databricks Runtime 19 e superior

Retorna variantExpr com val inserido ou definido em path.

Sintaxe

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

Arguments

  • variantExpr: Uma VARIANT expressão.
  • path: Uma STRING expressão com uma expressão de caminho JSON bem formada. Os índices de array são baseados em zero.
  • val: Uma expressão conjectável para VARIANT.
  • create_if_missing: Uma expressão constante opcional (dobrável BOOLEAN ). Se true, cria campos ausentes, elementos de array e objetos ou arrays intermediários ao longo pathde . O padrão é true.

Returns

Um valor do tipo VARIANT.

Substituir um elemento do array não desloca outros elementos.

Se create_if_missing for true, campos ausentes e contêineres intermediários são criados. Um índice igual ao comprimento do array acrescenta val. Um índice maior preenche o array com variantes nulas antes de adicionar val.

Se create_if_missing for false, um alvo ausente ou um caminho intermediário permanece variantExpr inalterado.

Argumentos SQL NULL retornam SQL NULL.

Tipos intermediários incompatíveis levantam VARIANT_PATH_TYPE_MISMATCH, independentemente de create_if_missing. Para retornar SQL NULL em vez disso, use try_variant_set.

Caminhos malformados ou o caminho $ da raiz aumentam INVALID_VARIANT_PATH, e resultados que excedem o limite de tamanho da variante aumentam VARIANT_SIZE_LIMIT.

Condições de erro comuns

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.