执行计划算子 - INSERT - 《OceanBase v3.1.1 官方教程》

INSERT
MULTI PARTITION INSERT

INSERT 算子用于将指定的数据插入数据表，数据来源包括直接指定的值和子查询的结果。

OceanBase 数据库支持的 INSERT 算子包括 INSERT 和 MULTI PARTITION INSERT。

INSERT

INSERT 算子用于向数据表的单个分区中插入数据。

如下例所示，Q1 查询将值 (1, ‘100’) 插入到非分区表 t1 中。其中 1 号算子 EXPRESSION 用来生成常量表达式的值。

obclient>CREATE TABLE t1 (c1 INT PRIMARY KEY, c2 VARCHAR2(10));
Query OK, 0 rows affected (0.12 sec)
obclient>CREATE TABLE t2 (c1 INT PRIMARY KEY, c2 VARCHAR2(10)) PARTITION BY 
             HASH(c1) PARTITIONS 10;
Query OK, 0 rows affected (0.12 sec)
obclient>CREATE TABLE t3 (c1 INT PRIMARY KEY, c2 VARCHAR2(10));
Query OK, 0 rows affected (0.12 sec)
obclient>CREATE INDEX IDX_t3_c2 ON t3 (c2) PARTITION BY HASH(c2) PARTITIONS 3;
Query OK, 0 rows affected (0.12 sec)
Q1: 
obclient>EXPLAIN INSERT INTO t1 VALUES (1, '100')\G;
*************************** 1. row ***************************
Query Plan:
====================================
|ID|OPERATOR   |NAME|EST. ROWS|COST|
------------------------------------
|0 |INSERT     |    |1        |1   |
|1 | EXPRESSION|    |1        |1   |
====================================
Outputs & filters:
-------------------------------------
  0 - output([__values.C1], [__values.C2]), filter(nil),
      columns([{T1: ({T1: (T1.C1, T1.C2)})}]), partitions(p0)
  1 - output([__values.C1], [__values.C2]), filter(nil)
      values({1, '100'})

上述示例中，执行计划展示中的 outputs & filters 详细列出了 INSERT 算子的输出信息如下：

信息名称	含义
output	该算子输出的表达式。
filter	该算子上的过滤条件。由于示例中 INSERT 算子没有设置 filter，所以为 nil。
columns	插入操作涉及的数据表的列。
partitions	插入操作涉及到的数据表的分区（非分区表可以认为是一个只有一个分区的分区表）。

更多 INSERT 算子的示例如下：

Q2 查询将值（2, ‘200’）、（3, ‘300’）插入到表 t1 中。

Q2: 
obclient>EXPLAIN INSERT INTO t1 VALUES (2, '200'),(3, '300')\G;
*************************** 1. row ***************************
Query Plan:
====================================
|ID|OPERATOR   |NAME|EST. ROWS|COST|
------------------------------------
|0 |INSERT     |    |2        |1   |
|1 | EXPRESSION|    |2        |1   |
====================================
Outputs & filters:
-------------------------------------
  0 - output([__values.C1], [__values.C2]), filter(nil),
      columns([{T1: ({T1: (T1.C1, T1.C2)})}]), partitions(p0)
  1 - output([__values.C1], [__values.C2]), filter(nil)
      values({2, '200'}, {3, '300'})

Q3 查询将子查询 SELECT * FROM t3 的结果插入到表 t1 中。

Q3: 
obclient>EXPLAIN INSERT INTO t1 SELECT * FROM t3\G;
*************************** 1. row ***************************
Query Plan:
====================================
|0 |INSERT              |     |100000   |117862|
|1 | EXCHANGE IN DISTR  |     |100000   |104060|
|2 |  EXCHANGE OUT DISTR|     |100000   |75662 |
|3 |   SUBPLAN SCAN     |VIEW1|100000   |75662 |
|4 |    TABLE SCAN      |T3   |100000   |61860 |
================================================
Outputs & filters:
-------------------------------------
  0 - output([VIEW1.C1], [VIEW1.C2]), filter(nil),
      columns([{T1: ({T1: (T1.C1, T1.C2)})}]), partitions(p0)
  1 - output([VIEW1.C1], [VIEW1.C2]), filter(nil)
  2 - output([VIEW1.C1], [VIEW1.C2]), filter(nil)
  3 - output([VIEW1.C1], [VIEW1.C2]), filter(nil),
      access([VIEW1.C1], [VIEW1.C2])
  4 - output([T3.C1], [T3.C2]), filter(nil),
      access([T3.C2], [T3.C1]), partitions(p0)

Q4 查询将值（1, ‘100’）插入到分区表 t2 中，通过 partitions 参数可以看出，该值会被插入到 t2 的 p5 分区。

Q4: 
obclient>EXPLAIN INSERT INTO t2 VALUES (1, '100')\G;
*************************** 1. row ***************************
Query Plan:
====================================
|ID|OPERATOR   |NAME|EST. ROWS|COST|
------------------------------------
|0 |INSERT     |    |1        |1   |
|1 | EXPRESSION|    |1        |1   |
====================================
Outputs & filters:
-------------------------------------
  0 - output([__values.C1], [__values.C2]), filter(nil),
      columns([{T2: ({T2: (T2.C1, T2.C2)})}]), partitions(p5)
  1 - output([__values.C1], [__values.C2]), filter(nil)
      values({1, '100'})

MULTI PARTITION INSERT

MULTI PARTITION INSERT 算子用于向数据表的多个分区中插入数据。

如下例所示，Q5 查询将值（2, ‘200’）、（3, ‘300’）插入到分区表 t2 中，通过 partitions 可以看出，这些值会被插入到 t2 的 p0 和 p6 分区。

Q5: 
obclient>EXPLAIN INSERT INTO t2 VALUES (2, '200'),(3, '300')\G;
*************************** 1. row ***************************
Query Plan:
===============================================
|ID|OPERATOR              |NAME|EST. ROWS|COST|
-----------------------------------------------
|0 |MULTI PARTITION INSERT|    |2        |1   |
|1 | EXPRESSION           |    |2        |1   |
===============================================
Outputs & filters:
-------------------------------------
  0 - output([__values.C1], [__values.C2]), filter(nil),
      columns([{T2: ({T2: (T2.C1, T2.C2)})}]), partitions(p0, p6)
  1 - output([__values.C1], [__values.C2]), filter(nil)
      values({2, '200'}, {3, '300'})

上述示例的执行计划展示中的 outputs & filters 详细列出了 MULTI PARTITION INSERT 算子的信息，字段的含义与 INSERT 算子相同。

更多 MULTI PARTITION INSERT 算子的示例如下：

Q6 查询将子查询 SELECT * FROM t3 的结果插入到分区表 t2 中，因为无法确定子查询的结果集，因此数据可能插入到 t2 的 p0 到 p9 的任何一个分区中。从1 号算子可以看到，这里的 SELECT * FROM t3 会被放在一个子查询中，并将子查询命名为 VIEW1。当 OceanBase 数据库内部改写 SQL 产生了子查询时，会自动为子查询命名，并按照子查询生成的顺序命名为 VIEW1、VIEW2、VIEW3…

Q6: 
obclient>EXPLAIN INSERT INTO t2 SELECT * FROM t3\G;
*************************** 1. row ***************************
Query Plan:
==============================================
|ID|OPERATOR             |NAME|EST. ROWS|COST|
--------------------------------------------------
|0 |MULTI PARTITION INSERT|     |100000   |117862|
|1 | EXCHANGE IN DISTR    |     |100000   |104060|
|2 |  EXCHANGE OUT DISTR  |     |100000   |75662 |
|3 |   SUBPLAN SCAN       |VIEW1|100000   |75662 |
|4 |    TABLE SCAN        |T3   |100000   |61860 |
==================================================
Outputs & filters:
-------------------------------------
  0 - output([VIEW1.C1], [VIEW1.C2]), filter(nil),
      columns([{T2: ({T2: (T2.C1, T2.C2)})}]), partitions(p[0-9])
  1 - output([VIEW1.C1], [VIEW1.C2]), filter(nil)
  2 - output([VIEW1.C1], [VIEW1.C2]), filter(nil)
  3 - output([VIEW1.C1], [VIEW1.C2]), filter(nil),
      access([VIEW1.C1], [VIEW1.C2])
  4 - output([T3.C1], [T3.C2]), filter(nil),
      access([T3.C2], [T3.C1]), partitions(p0)

Q7 查询将值（1, ‘100’）插入到非分区表 t3 中。虽然 t3 本身是一个非分区表，但因为 t3 上存在全局索引 idx_t3_c2，因此本次插入也涉及到了多个分区。

Q7: 
obclient>EXPLAIN INSERT INTO t3 VALUES (1, '100')\G;
*************************** 1. row ***************************
Query Plan:
==============================================
|ID|OPERATOR              |NAME|EST. ROWS|COST|
-----------------------------------------------
|0 |MULTI PARTITION INSERT|    |1        |1   |
|1 | EXPRESSION           |    |1        |1   |
===============================================
Outputs & filters:
-------------------------------------
  0 - output([__values.C1], [__values.C2]), filter(nil),
      columns([{T3: ({T3: (T3.C1, T3.C2)}, {IDX_T3_C2: (T3.C2, T3.C1)})}]), partitions(p0)
  1 - output([__values.C1], [__values.C2]), filter(nil)
      values({1, '100'})