Delete 操作
更新时间：2025-05-29
删除操作语句通过 MySQL 协议，按条件删除指定表或分区中的数据。支持通过简单的谓词组合条件来指定要删除的数据，也支持在主键表上使用 USING 子句关联多表进行删除。
通过指定过滤谓词删除
Plain Text
1DELETE FROM table_name [table_alias]
2 [PARTITION partition_name | PARTITIONS (partition_name [, partition_name])]
3 WHERE column_name op { value | value_list } [ AND column_name op { value | value_list } ...];必须参数
table_name: 指定需要删除数据的表column_name: 属于table_name的列op: 逻辑比较操作符，包括：=, >, <, >=, <=, !=, in, not invalue | value_list: 进行逻辑比较的值或值列表
可选参数
PARTITION partition_name | PARTITIONS (partition_name [, partition_name]): 指定执行删除数据的分区名，如果表不存在此分区，则报错table_alias: 表的别名
使用限制
- 使用表模型 Aggregate 时，只能指定 Key 列上的条件。当选定的 Key 列不存在于某个 Rollup 中时，无法进行删除。
- 对于分区表，需要指定分区。如果不指定，Doris 会从条件中推断分区。
-两种情况下，Doris 无法从条件中推断分区：
a. 条件中不包含分区列
b. 分区列的 op 为 not in
-当分区表未指定分区，或无法从条件中推断分区时，需要设置会话变量 delete_without_partition 为 true，此时删除操作会应用到所有分区。
示例
- 删除
my_table分区p1中k1列值为 3 的数据行
Plain Text
1DELETE FROM my_table PARTITION p1
2 WHERE k1 = 3;- 删除
my_table分区p1中k1列值大于等于 3 且status列值为 "outdated" 的数据行
Plain Text
1DELETE FROM my_table PARTITION p1
2WHERE k1 >= 3 AND status = "outdated";- 删除
my_table分区p1,p2中 k1 列值大于等于 3 且dt列值位于 "2024-10-01" 和 "2024-10-31" 之间的数据行
Plain Text
1DELETE FROM my_table PARTITIONS (p1, p2)
2WHERE k1 >= 3 AND dt >= "2024-10-01" AND dt <= "2024-10-31";通过使用 USING 子句删除
在某些场景下，用户需要关联多张表才能精确确定要删除的数据，这种情况下 USING 子句非常有用，语法如下：
Plain Text
1DELETE FROM table_name [table_alias]
2 [PARTITION partition_name | PARTITIONS (partition_name [, partition_name])]
3 [USING additional_tables]
4 WHERE condition必须参数
table_name: 指定需要删除数据的表WHERE condition: 指定用于选择删除行的条件
可选参数
PARTITION partition_name | PARTITIONS (partition_name [, partition_name]): 指定执行删除数据的分区名，如果表不存在此分区，则报错table_alias: 表的别名
注意事项
- 此形式只能在 UNIQUE KEY 模型表上使用
示例
使用 t2和 t3 表连接的结果，删除 t1 中的数据，删除的表只支持 unique 模型。
Plain Text
1-- 创建 t1, t2, t3 三张表
2CREATE TABLE t1
3 (id INT, c1 BIGINT, c2 STRING, c3 DOUBLE, c4 DATE)
4UNIQUE KEY (id)
5DISTRIBUTED BY HASH (id)
6PROPERTIES('replication_num'='1', "function_column.sequence_col" = "c4");
7
8CREATE TABLE t2
9 (id INT, c1 BIGINT, c2 STRING, c3 DOUBLE, c4 DATE)
10DISTRIBUTED BY HASH (id)
11PROPERTIES('replication_num'='1');
12
13CREATE TABLE t3
14 (id INT)
15DISTRIBUTED BY HASH (id)
16PROPERTIES('replication_num'='1');
17
18-- 插入数据
19INSERT INTO t1 VALUES
20 (1, 1, '1', 1.0, '2000-01-01'),
21 (2, 2, '2', 2.0, '2000-01-02'),
22 (3, 3, '3', 3.0, '2000-01-03');
23
24INSERT INTO t2 VALUES
25 (1, 10, '10', 10.0, '2000-01-10'),
26 (2, 20, '20', 20.0, '2000-01-20'),
27 (3, 30, '30', 30.0, '2000-01-30'),
28 (4, 4, '4', 4.0, '2000-01-04'),
29 (5, 5, '5', 5.0, '2000-01-05');
30
31INSERT INTO t3 VALUES
32 (1),
33 (4),
34 (5);
35
36-- 删除 t1 中的数据
37DELETE FROM t1
38 USING t2 INNER JOIN t3 ON t2.id = t3.id
39 WHERE t1.id = t2.id;预期结果为，删除 t1 表中 id 为 1 的行。
Plain Text
1+----+----+----+--------+------------+
2| id | c1 | c2 | c3 | c4 |
3+----+----+----+--------+------------+
4| 2 | 2 | 2 | 2.0 | 2000-01-02 |
5| 3 | 3 | 3 | 3.0 | 2000-01-03 |
6+----+----+----+--------+------------+相关配置
超时配置
*insert_timeout: 因为删除操作是一个 SQL 命令且被视为一种特殊的导入，因此删除语句会受 Session 中的 insert_timeout值影响，可以通过 SET insert_timeout = xxx 来增加超时时间，单位为秒。
IN 谓词配置
max_allowed_in_element_num_of_delete: 如果用户在使用in谓词时需要占用的元素较多，可以通过此项调整允许携带的元素上限，默认值为 1024。
查看历史记录
用户可以通过 SHOW DELETE 语句查看历史上已执行完成的删除记录。
语法如下：
Plain Text
1SHOW DELETE [FROM db_name]示例：
Plain Text
1mysql> show delete from test_db;
2+-----------+---------------+---------------------+-----------------+----------+
3| TableName | PartitionName | CreateTime | DeleteCondition | State |
4+-----------+---------------+---------------------+-----------------+----------+
5| empty_tbl | p3 | 2020-04-15 23:09:35 | k1 EQ "1" | FINISHED |
6| test_tbl | p4 | 2020-04-15 23:09:53 | k1 GT "80" | FINISHED |
7+-----------+---------------+---------------------+-----------------+----------+
82 rows in set (0.00 sec)性能建议
- 在明细表（Duplicate Key）和聚合表（Aggregate Key）上，删除操作执行速度较快，但短时间内大量删除操作会影响查询性能。
- 在主键表（Unique Key）上，删除操作被转换成
INSERT INTO语句，涉及大范围删除时执行速度较慢，但短时间内大量删除不会对查询性能有较大影响。
语法
删除语法详见 DELETE 语法手册。