JSON_ARRAY_APPEND (json_doc，路径，瓦尔[，路径，瓦尔]…)

将值附加到JSON文档中指定数组的末尾并返回结果。返回零如果任何参数是零．，则会发生错误json_doc参数不是有效的JSON文档路径参数不是有效的路径表达式或包含*或**通配符。

从左到右计算路径-值对。对其中一对求值产生的文档将成为下一对求值的新值。

如果路径选择标量或对象值，则该值将自动包装到数组中，并将新值添加到该数组中。如果路径没有在JSON文档中标识任何值，则忽略对。

mysql> SET @j = '["a"， ["b"， "c"]， "d"]';SELECT JSON_ARRAY_APPEND(@j， '$[1]'， 1);+----------------------------------+ | JSON_ARRAY_APPEND (@j[1]美元,1 ) | +----------------------------------+ | [" “,“b”,“c”,1],”d "] | +----------------------------------+ mysql >选择JSON_ARRAY_APPEND (@j[0]美元,2);+----------------------------------+ | JSON_ARRAY_APPEND (@j[0]美元,2 ) | +----------------------------------+ | [[" “2],“b”、“c”,“d "] | +----------------------------------+ mysql >选择JSON_ARRAY_APPEND (@j,美元[1][0]”,3);+-------------------------------------+ | JSON_ARRAY_APPEND (@j, ' $[1][0]”,3 ) | +-------------------------------------+ | [" ”,[[“b”,3],“c”),“d "] | +-------------------------------------+ mysql >设置@j = '{“a”:1、“b”:[2、3],“c”:4}';mysql> SELECT JSON_ARRAY_APPEND(@j， '$。b ', ' x ');+------------------------------------+ | JSON_ARRAY_APPEND (@j的美元。b”、“x ') | +------------------------------------+ | {" “b”“:1,:2、3、“x”,“c”:4 } | +------------------------------------+ mysql >选择JSON_ARRAY_APPEND (@j, ' $ c ', ' y ');+--------------------------------------+ | JSON_ARRAY_APPEND (@j, ' $ c”、“y ') | +--------------------------------------+ | {" ”:1、“b”:[2、3],”c”:[4,“y "]} | +--------------------------------------+ mysql >设置@j = '{“a”:1}';SELECT JSON_ARRAY_APPEND(@j， '$'， 'z'); +---------------------------------+ | JSON_ARRAY_APPEND(@j, '$', 'z') | +---------------------------------+ | [{"a": 1}, "z"] | +---------------------------------+

在MySQL 5.7中，这个函数被命名为JSON_APPEND ()．MySQL 8.0不再支持该名称。

JSON_ARRAY_INSERT (json_doc，路径，瓦尔[，路径，瓦尔]…)

更新JSON文档，将其插入文档中的数组并返回修改后的文档。返回零如果任何参数是零．，则会发生错误json_doc参数不是有效的JSON文档路径参数不是有效的路径表达式或包含*或**通配符或不以数组元素标识符结尾。

从左到右计算路径-值对。对其中一对求值产生的文档将成为下一对求值的新值。

如果路径不标识JSON文档中的任何数组，则忽略对。如果路径标识一个数组元素，则在该元素位置插入相应的值，并将后面的任何值向右移动。如果路径标识数组结束之后的数组位置，则在数组结束处插入该值。

mysql> SET @j = '["a"， {"b": [1,2]}， [3,4]]';mysql >选择JSON_ARRAY_INSERT (@j $ [1] ', ' x ');+------------------------------------+ | JSON_ARRAY_INSERT (@j $ [1] ', ' x ') | +------------------------------------+ | [" ”、“x”,{b:[1, 2]},[3、4 ]] | +------------------------------------+ mysql >选择JSON_ARRAY_INSERT (@j $ [100] ', ' x ');+--------------------------------------+ | JSON_ARRAY_INSERT (@j,“[100]美元”,“x ') | +--------------------------------------+ | [" ”,{b:[1, 2]},(3、4),“x "] | +--------------------------------------+ mysql >选择JSON_ARRAY_INSERT (@j”[1]。b [0] ', ' x ');+-----------------------------------------+ | JSON_ARRAY_INSERT (@j, ' $[1]。b[0]”、“x ') | +-----------------------------------------+ | [" ”,{b: [" x ", 1 2]},[3、4 ]] | +-----------------------------------------+ mysql >选择JSON_ARRAY_INSERT (@j,美元[2][1]',' y ');+---------------------------------------+ | JSON_ARRAY_INSERT (@j, ' $[2][1]”,“y ') | +---------------------------------------+ | [" ”,{b:[1, 2]},(3“y”4 ]] | +---------------------------------------+ mysql >选择JSON_ARRAY_INSERT (@j,“[0]美元”,“x”,“美元[2][1]',' y ');+----------------------------------------------------+ | JSON_ARRAY_INSERT (@j[0]美元,“x”,“美元[2][1]”,“y ') | +----------------------------------------------------+ | [" x”、“一个”,{b:[1, 2]},[3、4 ]] | +----------------------------------------------------+

前面的修改会影响数组中以下元素的位置，因此后面的路径相同JSON_ARRAY_INSERT ()Call应该考虑到这一点。在最后一个示例中，第二个路径什么也没有插入，因为在第一个插入之后，该路径不再匹配任何内容。

JSON_INSERT (json_doc，路径，瓦尔[，路径，瓦尔]…)

将数据插入JSON文档并返回结果。返回零如果任何参数是零．，则会发生错误json_doc参数不是有效的JSON文档路径参数不是有效的路径表达式或包含*或**通配符。

从左到右计算路径-值对。对其中一对求值产生的文档将成为下一对求值的新值。

文档中现有路径的路径-值对将被忽略，并且不会覆盖现有的文档值。文档中不存在的路径的路径值对，如果该路径标识以下类型的值之一，则将该值添加到文档中:

否则，文档中不存在的路径的路径-值对将被忽略，并且不起作用。

比较一下JSON_INSERT ()，JSON_REPLACE (),JSON_SET ()，见讨论JSON_SET ()．

mysql> SET @j = '{"a": 1， "b": [2,3]}';mysql> SELECT JSON_INSERT(@j， '$。A '， 10， '$.c'， '[真，假]');+----------------------------------------------------+ | JSON_INSERT (@j的美元。“10”$ c”、“[真的,假的 ]') | +----------------------------------------------------+ | {" ”:1、“b”:[2、3],”c”:“(真的,假的 ]"} | +----------------------------------------------------+

结果中列出的第三个也是最后一个值是一个带引号的字符串，而不是像第二个值那样的数组(在输出中没有带引号);不会执行将值转换为JSON类型的操作。要将数组作为数组插入，必须显式执行此类类型转换，如下所示:

mysql> SELECT JSON_INSERT(@j， '$。a'， 10， '$.c'， CAST('[true, false]' AS JSON));+------------------------------------------------------------------+ | JSON_INSERT (@j的美元。“10美元. c,演员(为JSON(真、假) )) | +------------------------------------------------------------------+ | {" ”:1、“b”:[2、3],“c”(真的,假的 ]} | +------------------------------------------------------------------+ 1行集(0.00秒)

JSON_MERGE (json_doc，json_doc[，json_doc]…)

合并两个或多个JSON文档。的同义词JSON_MERGE_PRESERVE ()；在MySQL 8.0.3中已弃用，并将在未来的版本中删除。

mysql >选择JSON_MERGE(“[1,2]”,“[真,假]”);+---------------------------------------+ | JSON_MERGE([1, 2],[真的,假的 ]') | +---------------------------------------+ | [ 1、2,真的,假的 ] | +---------------------------------------+ 1行集,警告(0.00秒)mysql >显示警告\ G  *************************** 1。行***************************级别:警告代码:1287消息:'JSON_MERGE'已弃用，将在未来的版本中删除。\请使用JSON_MERGE_PRESERVE/JSON_MERGE_PATCH代替set中的1行(0.00 sec)

有关其他示例，请参阅JSON_MERGE_PRESERVE ()．

JSON_MERGE_PATCH (json_doc，json_doc[，json_doc]…)

执行一个RFC 7396兼容两个或多个JSON文档的合并，并返回合并的结果，而不保留具有重复键的成员。如果作为参数传递给此函数的文档中至少有一个无效，则会引发错误。

mysql >选择JSON_MERGE_PATCH('{“a”:1、“b”:2}”,“{零}“b”:”);+--------------------------------------------------+ | JSON_MERGE_PATCH('{“a”:1、“b”:2}’,‘{“b”:零 }') | +--------------------------------------------------+ | {" ”:1 } | +--------------------------------------------------+

mysql >选择JSON_MERGE_PATCH({”“:{" x ": 1}}”,“{”“:{" y ": 2}}”);+----------------------------------------------------+ | JSON_MERGE_PATCH('{“a”:{" x ": 1}}”,“{”“:{“y”:2 }}') | +----------------------------------------------------+ | {" ":{“x”:1、“y”:2 }} | +----------------------------------------------------+

mysql >设置@x = '{“a”:1、“b”:2}’,> @y = "{“a”:3,“c”:4}’,> @z = "{“d”:“一”:5日6}';mysql >选择JSON_MERGE_PATCH (@x、@y @z)作为补丁,——> JSON_MERGE_PRESERVE (@x, @y @z)保存\ G  *************************** 1。行  *************************** 补丁:{“b”,“a”:5:2,“c”:4,“d”:6}保护:{“a”:1、3、5,“b”:2,“c”:4,“d”:6}

JSON_MERGE_PRESERVE (json_doc，json_doc[，json_doc]…)

合并两个或多个JSON文档并返回合并结果。返回零如果任何参数是零．如果任何参数都不是有效的JSON文档，则会发生错误。

合并按照以下规则进行。有关其他信息，请参见

• 相邻数组合并为单个数组。

• 相邻的对象合并为单个对象。

• 标量值自动包装为数组并合并为数组。

• 通过将对象自动包装为数组并合并两个数组来合并相邻数组和对象。