Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

JSON_REPLACE

Atualiza valores existentes em um objeto JSON com base no caminho deles. JSON_REPLACE não adiciona novas chaves ao documento; apenas substitui os valores das chaves existentes.

Veja também:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_REPLACE]


Sintaxe​

SELECT JSON_REPLACE(json_column, path, new_value) FROM <multipartIdentifier>;

Argumentos​

json_column
A coluna ou expressão JSON na qual os valores serão substituídos.

path
A expressão de caminho JSON que aponta para o local no documento JSON onde a substituição deve ocorrer. O caminho deve apontar para uma chave existente.

new_value
O novo valor de substituição no caminho especificado do documento JSON.

Valor(es) retornado(s)​

Retorna um documento JSON modificado com o valor especificado substituído. Se o caminho especificado não existir, a função retorna o documento JSON original sem alterações.

Comportamento se uma chave existir
FunçãoSobrescrever se já existir?Criar se não existir?
json_insert()NãoSim
json_replace()SimNão
json_set()SimSim

Exemplos​

Substituir um único valor em um objeto JSON​

SELECT sku as original,
JSON_REPLACE(sku, '$.name', 'Standard_EU') as updated
FROM azure.container_registry.registries
WHERE registry_name = 'exampleRegistryProd'
AND subscription_id = '12345678-abcd-1234-abcd-1234abcd5678'
AND resource_group_name = 'exampleResourceGroupProd';
/* expected output...
|---------------------------------------|------------------------------------------|
| original | updated |
|---------------------------------------|------------------------------------------|
| {"name":"Standard","tier":"Standard"} | {"name":"Standard_EU","tier":"Standard"} |
|---------------------------------------|------------------------------------------|
*/

Substituir vários valores em um objeto JSON​

select
properties beforechange,
json_replace(json_remove(properties,
'$.allowPort25Out',
'$.auxiliarySku',
'$.provisioningState',
'$.resourceGuid',
'$.macAddress',
'$.vnetEncryptionSupported',
'$.enableIPForwarding',
'$.defaultOutboundAccess',
'$.primary',
'$.virtualMachine',
'$.hostedWorkloads',
'$.tapConfigurations',
'$.nicType',
'$.auxiliaryMode',
'$.ipConfigurations[0].id',
'$.ipConfigurations[0].etag',
'$.ipConfigurations[0].type',
'$.ipConfigurations[0].properties.provisioningState',
'$.ipConfigurations[0].properties.privateIPAddress',
'$.ipConfigurations[0].properties.privateIPAllocationMethod',
'$.ipConfigurations[0].properties.primary',
'$.ipConfigurations[0].properties.privateIPAddressVersion'
),
'$.ipConfigurations[0].name',
'vmss-flex-vnet-nic01-defaultIpConfiguration'
) afterchange
from
azure.network.network_interfaces
where subscription_id = '0123456789'
and resource_group_name = 'vm-rg'
and network_interface_name = 'vm1450_z1'