- Categorias:
MAP_INSERT¶
Retorna um novo MAP que consiste no MAP de entrada com um novo par chave-valor inserido. Ou seja, uma chave existente atualizada com um novo valor.
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 é compatível com os valores JSON nulos, mas não com os valores ou chaves SQL NULL:
Se
key
for qualquer string diferente de NULL evalue
for um JSON nulo (por exemplo,PARSE_JSON('NULL')
), então o par chave-valor será inserido no mapa retornado.Se
key
for qualquer string diferente de NULL evalue
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 existentekey
será atualizada para a entradavalue
. SeupdateFlag
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 nulo.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" |
| } |
+------------------------+
Crie uma tabela temporária que contenha valores MAP:
CREATE OR REPLACE TEMP TABLE demo_maps(
id INTEGER,
attrs MAP(VARCHAR, VARCHAR),
defaults MAP(VARCHAR, VARCHAR),
keep_keys ARRAY(VARCHAR),
ins_key VARCHAR,
ins_val VARCHAR,
update_existing BOOLEAN,
del_key1 VARCHAR,
del_key2 VARCHAR);
INSERT INTO demo_maps SELECT
1,
{'color':'red','size':'M','brand':'Acme'}::MAP(VARCHAR, VARCHAR),
{'currency':'USD','size':'L'}::MAP(VARCHAR, VARCHAR),
['color','brand']::ARRAY(VARCHAR),
'material',
'cotton',
TRUE,
'size',
'brand';
INSERT INTO demo_maps SELECT
2,
{'color':'blue','brand':'ZenCo'}::MAP(VARCHAR, VARCHAR),
{'currency':'EUR','size':'M','brand':'ZenCo'}::MAP(VARCHAR, VARCHAR),
['brand','currency']::ARRAY(VARCHAR),
'brand',
'ZC',
FALSE,
'currency',
'material';
Consulte a tabela para mostrar os dados:
SELECT * FROM demo_maps;
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+
| ID | ATTRS | DEFAULTS | KEEP_KEYS | INS_KEY | INS_VAL | UPDATE_EXISTING | DEL_KEY1 | DEL_KEY2 |
|----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------|
| 1 | { | { | [ | material | cotton | True | size | brand |
| | "brand": "Acme", | "currency": "USD", | "color", | | | | | |
| | "color": "red", | "size": "L" | "brand" | | | | | |
| | "size": "M" | } | ] | | | | | |
| | } | | | | | | | |
| 2 | { | { | [ | brand | ZC | False | currency | material |
| | "brand": "ZenCo", | "brand": "ZenCo", | "brand", | | | | | |
| | "color": "blue" | "currency": "EUR", | "currency" | | | | | |
| | } | "size": "M" | ] | | | | | |
| | | } | | | | | | |
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+
Usando as chaves na coluna ins_key
e os valores na coluna ins_val
, insira ou atualize pares chave-valor nos mapas na coluna attrs
:
SELECT id, MAP_INSERT(attrs, ins_key, ins_val, TRUE) AS attrs_insert_or_update
FROM demo_maps;
+----+-------------------------+
| ID | ATTRS_INSERT_OR_UPDATE |
|----+-------------------------|
| 1 | { |
| | "brand": "Acme", |
| | "color": "red", |
| | "material": "cotton", |
| | "size": "M" |
| | } |
| 2 | { |
| | "brand": "ZC", |
| | "color": "blue" |
| | } |
+----+-------------------------+