JSON_REMOVE

使用路径表达式从 JSON 文档中移除指定的元素。如果指定的路径在文档中不存在，则忽略该路径。路径按顺序依次处理，可能会影响后续移除所针对的结构。

另请参阅：
[SELECT] [JSON_EXTRACT]

---

语法

SELECT JSON_REMOVE(json_document, path1, path2, ...) FROM <multipartIdentifier>;

参数

json_document
要从中移除元素的 JSON 文档。

path1, path2, ...
一个或多个路径表达式，指向 JSON 文档中要移除的元素。

返回值

返回移除了指定元素的 JSON 文档副本。如果未提供路径，则返回重新格式化并去除了多余空白字符的输入 JSON。

---

示例

从 JSON 数组中移除一个元素

-- Example: Remove the third element from a JSON array
SELECT JSON_REMOVE('[0,1,2,3,4]', '$[2]') AS modified_json;

输出：'[0,1,3,4]'

从 JSON 数组中移除多个元素

-- Example: Remove the first and third elements from a JSON array
SELECT JSON_REMOVE('[0,1,2,3,4]', '$[2]', '$[0]') AS modified_json;

输出：'[1,3,4]'

使用负索引移除最后一个元素

-- Example: Remove the last and first elements from a JSON array
SELECT JSON_REMOVE('[0,1,2,3,4]', '$[#-1]', '$[0]') AS modified_json;

输出：'[1,2,3]'

移除不存在的路径

-- Example: Attempt to remove a non-existent key from a JSON object
SELECT JSON_REMOVE('{"x":25,"y":42}', '$.z') AS modified_json;

输出：'{"x":25,"y":42}'

从 JSON 对象中移除现有键

-- Example: Remove the 'y' key from a JSON object
SELECT JSON_REMOVE('{"x":25,"y":42}', '$.y') AS modified_json;

输出：'{"x":25}'

边界情况：使用根路径移除

-- Example: Attempt to remove using the root path
SELECT JSON_REMOVE('{"x":25,"y":42}', '$') AS modified_json;

输出：NULL

这些示例说明了如何使用 json_remove() 动态处理 JSON 数据，涵盖从简单删除到处理数据结构修改中的边界情况等多种场景。