---
title: "JSON_REPLACE - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: "JSON_REPLACE 描述 该函数用于替换 JSON 文档中的现有值并返回结果。 语法 JSON_REPLACE(json_doc, path, val[, path, val] ...) 说明 json_doc 参数用于指定 JSON 文档， path 为路径参数。如果任何参数为 NULL ，则返回 NULL …"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# JSON_REPLACE

更新时间：2026-03-26 08:11:49

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/400.functions-of-mysql-mode/700.json-functions-of-mysql-mode/300.modify-json-text-function-of-mysql-mode/800.json-replace-of-mysql-mode.md)  

## 描述

该函数用于替换 JSON 文档中的现有值并返回结果。

## 语法

```sql
JSON_REPLACE(json_doc, path, val[, path, val] ...)

```

## 说明

`json_doc` 参数用于指定 JSON 文档，`path` 为路径参数。如果任何参数为 `NULL`，则返回 `NULL`。

以下情况都会发生报错：

- `json_doc` 参数不是有效的 JSON 文档。
 - `path` 参数不是有效的路径表达式。
 - `path` 参数包含 * 或 ** 通配符。

路径值对 path-value 按照从左到右的顺序进行评估。通过 path-value 对所生成的文档作为评估下一对的新值。

文档中现有路径的 path-value 对会用新值覆盖现有文档值。文档中不存在路径的 path-value 将被忽略且无效。

## 示例

```sql
obclient> SET @jn = '{ "a": 1, "b": [2, 3, 4]}';
Query OK, 0 rows affected

obclient> SELECT JSON_REPLACE(@jn, '$.a', 10, '$.c', '[true, false]');
+------------------------------------------------------+
| JSON_REPLACE(@jn, '$.a', 10, '$.c', '[true, false]') |
+------------------------------------------------------+
| {"a": 10, "b": [2, 3, 4]}                            |
+------------------------------------------------------+
1 row in set

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线