SQLite json_replace() 函数使用指南
SQLite json_replace()
函数在一个 JSON 文档中替换已存在的数据并返回新的 JSON 文档。
json_replace()
语法
这里是 SQLite json_replace()
的语法:
json_replace(json, path, value[, path2, value2] ...)
参数
json
- 必需的。被修改的 JSON 文档。
path
- 必需的。一个有效的路径表达式。
value
- 必需的。新的数据。
返回值
json_replace()
函数在一个 JSON 文档中替换已存在的数据并返回新的 JSON 文档。您可以提供多对 path-value
参数,以便一次替换多个数据。
json_replace()
函数只能替换已经存在的数据。如果 JSON 文档中不存在指定的路径,则不会插入数据。
如果参数 json
不是有效的 JSON 文档,SQLite 将会给出错误。您可以使用 json_valid()
验证 JSON 文档的有效性。
json_replace()
示例
在 JSON 数组中替换
让我们将数组 [1, [2, 3]]
的第一个元素和第三个元素替换为新值:
SELECT json_replace('[1, [2, 3]]', '$[0]', 0, '$[2]', 6);
json_replace('[1, [2, 3]]', '$[0]', 0, '$[2]', 6)
-------------------------------------------------
[0,[2,3]]
这里,我们想要把数组的将第一个元素替换为 0
,将数组的第三个元素替换为 6
。
我们发现,数组的第一个元素成功的被替换为了 0
。然后,数组的最后没有插入 6
。这是因为 json_replace()
函数只替换已经存在的数据。
在 JSON 对象中替换
让我们将对象 {"x": 1, "y": 1}
中的 y
的值修改为 2
:
SELECT json_replace('{"x": 1, "y": 1}', '$.y', 2);
json_replace('{"x": 1, "y": 1}', '$.y', 2)
------------------------------------------
{"x":1,"y":2}