try_variant_array_append Função

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

Retorna variantExpr com val anexado ao array em path, ou NULL se um valor intermediário tiver um tipo incompatível ou se o alvo não for um array.

Sintaxe

try_variant_array_append ( variantExpr, path, val )

Arguments

  • variantExpr: Uma VARIANT expressão.
  • path: Uma STRING expressão com uma expressão de caminho JSON bem formada que especifica o array alvo. Os índices de array são baseados em zero.
  • val: Uma expressão conjectável para VARIANT.

Returns

Um valor do tipo VARIANT.

Um caminho ausente permanece variantExpr inalterado.

Argumentos SQL NULL retornam SQL NULL.

A função retorna SQL NULL para tipos intermediários incompatíveis ou para um alvo que não seja de array. Para gerar um erro em vez disso, use variant_array_append.

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

Condições de erro comuns

Examples

-- Append to a root array
> SELECT try_variant_array_append(parse_json('[1]'), '$', 2)
  [1,2]

-- Append to a nested array
> SELECT try_variant_array_append(parse_json('{"a": [1, 2]}'), '$.a', 3)
  {"a":[1,2,3]}

-- Non-array target
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.a', 2)
  NULL

-- Missing path
> SELECT try_variant_array_append(parse_json('{"a": 1}'), '$.missing', 2)
  {"a":1}

-- Invalid path
> SELECT try_variant_array_append(parse_json('[]'), 'invalid', 1)
  Error: INVALID_VARIANT_PATH.