Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

JSON_REPLACE

Оновлює наявні значення в об'єкті JSON за їхнім шляхом. Функція JSON_REPLACE не додає нових ключів до документа; вона лише замінює значення наявних ключів.

Див. також:
[SELECT] [JSON_EXTRACT] [JSON_SET] [JSON_INSERT]


Синтаксис​

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

Аргументи​

json_column
Стовпець або вираз JSON, у якому потрібно замінити значення.

path
Вираз шляху JSON, що вказує на місце в документі JSON, де потрібно виконати заміну. Шлях має вказувати на наявний ключ.

new_value
Нове значення, яким потрібно замінити наявне за вказаним шляхом у документі JSON.

Значення, що повертається​

Повертає змінений документ JSON із заміненим указаним значенням. Якщо вказаного шляху не існує, функція повертає початковий документ JSON без змін.

Поведінка, якщо ключ уже існує
ФункціяПерезаписати, якщо вже існує?Створити, якщо не існує?
json_insert()НіТак
json_replace()ТакНі
json_set()ТакТак

Приклади​

Заміна одного значення в об'єкті 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"} |
|---------------------------------------|------------------------------------------|
*/

Видалення ключів і заміна значення в об'єкті 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'