MAP_INSERT¶

Sintaxe¶

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

Argumentos¶

map

O mapa de origem no qual o novo par chave-valor é inserido.

key

A nova chave a ser inserida no mapa. Deve ser diferente de todas as chaves existentes no mapa, a menos que updateFlag esteja definido como TRUE.

value

O valor associado à chave.

Opcional

updateFlag

Um sinalizador booleano que, quando definido como TRUE, especifica o valor de entrada usado para atualizar/substituir uma chave existente no mapa, em vez de inserir um novo par chave-valor.

O padrão é FALSE.

Retornos¶

Retorna um MAP que consiste no MAP de entrada com um novo par chave-valor inserido ou uma chave existente atualizada com um novo valor.

Notas de uso¶

• O tipo da expressão-chave deve corresponder ao tipo da chave do mapa. Se o tipo for VARCHAR, os tipos poderão ter comprimentos diferentes.

• A função oferece suporte a valores JSON NULL, mas não a valores ou chaves SQL NULL:

  • Se key for qualquer cadeia de caracteres diferente de NULL e value for um JSON NULL (por exemplo, PARSE_JSON(“NULL”)), o par chave-valor será inserido no mapa retornado.

  • Se key for qualquer cadeia de caracteres diferente de NULL e value for um SQL NULL (por exemplo, NULL), então o valor será convertido em JSON NULL e o par chave-valor será inserido no mapa retornado.

  • Se key for um SQL NULL, o par chave-valor será omitido do mapa retornado.

• Se updateFlag estiver definido como TRUE, a entrada existente key será atualizada para a entrada value. Se updateFlag for omitido ou definido como FALSE e a chave de entrada já existir no mapa, um erro será retornado.

• Se updateFlag estiver definido como TRUE, mas a chave correspondente ainda não existir no mapa, o par chave-valor será adicionado.

Exemplos¶

Insira um terceiro par chave-valor em um mapa que contenha dois pares chave-valor:

SELECT MAP_INSERT({'a':1,'b':2}::MAP(VARCHAR,NUMBER),'c',3);

+------------------------------------------------------+
| MAP_INSERT({'A':1,'B':2}::MAP(VARCHAR,NUMBER),'C',3) |
|------------------------------------------------------|
| {                                                    |
|   "a": 1,                                            |
|   "b": 2,                                            |
|   "c": 3                                             |
| }                                                    |
+------------------------------------------------------+

Insira dois novos pares chave-valor, omitindo um par chave-valor, em um mapa vazio:

• Key_One consiste em um valor JSON NULL.

• Key_Two consiste em um valor SQL NULL, que é convertido em um valor JSON NULL.

• Key_Three consiste em uma cadeia de caracteres contendo “nulo”.

SELECT MAP_INSERT(MAP_INSERT(MAP_INSERT({}::MAP(VARCHAR,VARCHAR),
  'Key_One', PARSE_JSON('NULL')), 'Key_Two', NULL), 'Key_Three', 'null');

+---------------------------------------------------------------------------+
| MAP_INSERT(MAP_INSERT(MAP_INSERT({}::MAP(VARCHAR,VARCHAR),                |
|    'KEY_ONE', PARSE_JSON('NULL')), 'KEY_TWO', NULL), 'KEY_THREE', 'NULL') |
|---------------------------------------------------------------------------|
| {                                                                         |
|   "Key_One": null,                                                        |
|   "Key_Three": "null",                                                    |
|   "Key_Two": null                                                         |
| }                                                                         |
+---------------------------------------------------------------------------+

Atualizar um par chave-valor existente ("k1": 100) com um novo valor ("string-value"):

SELECT MAP_INSERT({'k1':100}::MAP(VARCHAR,VARCHAR), 'k1', 'string-value', TRUE) AS map;

+------------------------+
| MAP                    |
|------------------------|
| {                      |
|   "k1": "string-value" |
| }                      |
+------------------------+