---
title: "replace 和 insert_or_update 的区别 - OceanBase 数据库 V4.3.3 | OceanBase 文档中心"
description: replace 和 insert_or_update 的区别 replace 和 insert_or_update 是两个容易混淆的操作。在很多情况下，他们对外的表现相同，但他们的语义本质上又有区别。本文将详细介绍两者的区别。 replace 表示插入，当有冲突的时候，删除所有引起冲突的行，然后再插入。 insert…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库KV 型 - V 4.3.3

# replace 和 insert_or_update 的区别

更新时间：2024-10-29 23:00:00

[编辑](https://github.com/oceanbase/oceanbase-kv/edit/V4.3.3/zh-CN/100.obkv-table/100.introduction-to-obkv-table/200.differences-between-replace-and-insert_or_update.md)  

replace 和 insert_or_update 是两个容易混淆的操作。在很多情况下，他们对外的表现相同，但他们的语义本质上又有区别。本文将详细介绍两者的区别。

replace 表示插入，当有冲突的时候，删除所有引起冲突的行，然后再插入。

insert_or_update 表示插入，有冲突的时候，执行更新操作。

让我们通过例子来看下两者的区别。

## insert_or_update

OBKV-Table 提供的 insert_or_update 等价于某种特殊的 SQL 语法，下面用这种 SQL 语句做例子说明。

```sql
OceanBase (root@test)> desc test_replace;
+-------+---------+------+-----+---------+-------+
| Field | Type    | Null | Key | Default | Extra |
+-------+---------+------+-----+---------+-------+
| c1    | int(11) | NO   | PRI | NULL    |       |
| c2    | int(11) | YES  |     | NULL    |       |
| c3    | int(11) | YES  | UNI | NULL    |       |
+-------+---------+------+-----+---------+-------+
3 rows in set (0.03 sec)

OceanBase (root@test)> select * from test_replace;
+----+------+------+
| c1 | c2   | c3   |
+----+------+------+
|  1 |    2 |    3 |
|  4 |    5 |    6 |
+----+------+------+
2 rows in set (0.03 sec)

OceanBase (root@test)> insert into test_replace (c1, c2, c3) values (4, 7, 8), (5, 8, 9) on duplicate key update c1=values(c1), c2=values(c2), c3=values(c3);
Query OK, 3 rows affected (0.03 sec)
Records: 2  Duplicates: 1  Warnings: 0

OceanBase (root@test)> select * from test_replace;
+----+------+------+
| c1 | c2   | c3   |
+----+------+------+
|  1 |    2 |    3 |
|  4 |    7 |    8 |
|  5 |    8 |    9 |
+----+------+------+
3 rows in set (0.03 sec)

```

## replace

```sql
OceanBase (root@test)> select * from test_replace;
+----+------+------+
| c1 | c2   | c3   |
+----+------+------+
|  1 |    2 |    3 |
|  4 |    7 |    8 |
|  5 |    8 |    9 |
+----+------+------+
3 rows in set (0.03 sec)

OceanBase (root@test)> replace into test_replace (c1, c3) values (4, 9);
Query OK, 3 rows affected (0.04 sec)

OceanBase (root@test)> select * from test_replace;
+----+------+------+
| c1 | c2   | c3   |
+----+------+------+
|  1 |    2 |    3 |
|  4 | NULL |    9 |
+----+------+------+
2 rows in set (0.02 sec)

```

通过对比上面两个例子，可以看出，replace 有"删除"的动作，所以可能会让行数变少，而且，c1=4 这行的 c2 的值，因为是重新插入的，变成了 default 值 NULL。这两个特殊的表现，对于 insert_or_update 不会存在。多数情况下，用户"需要"的是 insert_or_update，也就是 NoSQL 的"put"含义。

在以下两种情况下，两个操作的对外表现是相同的：

- 表只有主键，没有 unique 索引。
 - 操作给定了一行所有列的值，不需要系统补缺省值。

这两种情况下，虽然对外表现相同，在 OBKV-Table 内部，insert_or_update 会使用特殊的优化实现，性能比 replace 更好。

 上一篇 下一篇 ![有帮助](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) 咨询热线