MAP_INSERT (Lakehouse v1)

Devolve um novo MAP composto pelo MAP de entrada com um novo par chave-valor inserido (ou uma chave existente atualizada com um novo valor).

Sintaxe SQL

MAP_INSERT( <map>, <key>, <value> [, <updateFlag> ] )

Argumentos

Argumentos	Descrição
<map>	O MAP de entrada.
<key>	A nova chave a inserir no MAP.
<value>	O novo valor a inserir no MAP.
<updateFlag>	O indicador booleano que determina se uma chave existente pode ser substituída. O valor predefinido é FALSE.

Tipo de retorno

Map.

Exemplos de SQL

SELECT MAP_INSERT({'a':1,'b':2,'c':3}, 'd', 4);
┌─────────────────────────────────────────┐
│ map_insert({'a':1,'b':2,'c':3}, 'd', 4) │
├─────────────────────────────────────────┤
│ {'a':1,'b':2,'c':3,'d':4}               │
└─────────────────────────────────────────┘

SELECT MAP_INSERT({'a':1,'b':2,'c':3}, 'a', 5, true);
┌───────────────────────────────────────────────┐
│ map_insert({'a':1,'b':2,'c':3}, 'a', 5, TRUE) │
├───────────────────────────────────────────────┤
│ {'a':5,'b':2,'c':3}                           │
└───────────────────────────────────────────────┘