[TOC] # INSERT ## 描述 该语句用于添加一个或多个记录到表中。 ## 格式 ~~~ INSERT [IGNORE] [INTO] single_table_insert [ON DUPLICATE KEY UPDATE update_asgn_list] single_table_insert: {dml_table_name values_clause | dml_table_name '(' ')' values_clause | dml_table_name '(' column_list ')' values_clause | dml_table_name SET update_asgn_list} dml_table_name: tbl_name [PARTITION (partition_name,...)] values_clause: {{VALUES | VALUE} ({expr | DEFAULT},...) [, ...] | select_stmt} column_list column_name [, ...] update_asgn_list: column_name = expr [, ...] ~~~ ## 参数解释 **INSERT…ON DUPLICATE KEY UPDATE…****语句执行,affect row的计算:** * 在没有设置client\_capabilities中CLIENT\_FOUND\_ROWS的情况下: * 作为新行插入的话,affected\_row= 1; * 存在冲突行的情况下,如果更新前后数据相同的话, affected\_row = 0; 否则affectd\_row = 2; * 如果设置了CLIENT\_FOUND\_ROWS: * 作为新行插入的话,affected\_row=1; * 如果更新前后数据相同的话,affectd\_row=1; * 如果更新前后数据不相同的话,affected\_row=2; * CLIENT\_FOUND\_ROWS的影响在于:不设置CLIENT\_FOUND\_ROWS的情况下,计算affected\_row的值,只计算实际更新了行数,而设置了CLIENT\_FOUND\_ROWS的话,会把所有touched行数(满足冲突条件的行)都记上,而不管其是否发生了真正的数据修改。 <table data-tag="table" id="table-ky4-mlo-1pt" class="table"><colgroup width="360" span="1" data-tag="col" id="col-o55-lxx-smv" colwidth="1*" colnum="1" colname="col1" style="width:50%" class="col"></colgroup><colgroup width="360" span="1" data-tag="col" id="col-y8r-idv-08n" colwidth="1*" colnum="2" colname="col2" style="width:50%" class="col"></colgroup><thead id="thead-teb-2s2-9qe" class="thead"><tr id="tr-j61-527-n8v"><th id="td-298-4md-db8"><p id="p-1s8-lbb-ytt"><b>参数</b></p></th><th id="td-2u3-01q-mn4"><p id="p-4z1-kte-ilx"><b>描述</b></p></th></tr></thead><tbody data-tag="tbody" id="tbody-cia-l5o-aqa" class="tbody"><tr data-tag="tr" id="tr-zn2-u95-yll" class="tr"><td data-tag="td" id="td-ri5-8sp-fdd" class="td"><p id="p-mhp-j5m-bzg">IGNORE</p></td><td data-tag="td" id="td-52y-bsh-8dh" class="td"><p id="p-dn8-jlw-y8e">在INSERT语句执行过程中发生的错误将会被忽略。</p></td></tr><tr data-tag="tr" id="tr-vz8-15l-4w6" class="tr"><td data-tag="td" id="td-izs-zxk-7g3" class="td"><p id="p-ceg-iij-d1q">column_list</p></td><td data-tag="td" id="td-eqm-b59-4k5" class="td"><p id="p-mlq-ade-ia2">用于指定插入数据的列,同时插入多列时,用“,”隔开。</p></td></tr><tr data-tag="tr" id="tr-33y-dkt-s12" class="tr"><td data-tag="td" id="td-72k-g4e-bld" class="td"><p id="p-n70-uru-vb2">tbl_name</p></td><td data-tag="td" id="td-t5g-mw2-lvj" class="td"><p id="p-621-s1k-zb0">指定要插入的表名。</p></td></tr><tr data-tag="tr" id="tr-fxn-w5l-tv7" class="tr"><td data-tag="td" id="td-ogs-gyj-daa" class="td"><p id="p-icw-a00-f4a">partition_name</p></td><td data-tag="td" id="td-ska-v0k-xpu" class="td"><p id="p-s6x-wbc-ku6">插入表指定的分区名。</p></td></tr><tr data-tag="tr" id="tr-7bv-6me-mu4" class="tr"><td data-tag="td" id="td-un2-0qv-4ym" class="td"><p id="p-g2q-goi-y59">update_asgn_list</p></td><td data-tag="td" id="td-hat-kpa-0sv" class="td"><p data-tag="p" id="p-1k2-x94-rll" class="p">赋值语句,例如:“c1 = 2”</p></td></tr><tr data-tag="tr" id="tr-xga-kyq-s15" class="tr"><td data-tag="td" id="td-0mo-chm-b9g" class="td"><p id="p-0xx-t33-ftb">ON DUPLICATE KEY UPDATE</p></td><td data-tag="td" id="td-qav-ipc-ez7" class="td"><p data-tag="p" id="p-95u-0ev-7rg" class="p">指定对重复主键或唯一键的处理。如果指定了ON DUPLICATE KEY UPDATE,当要插入的主键或唯一键有重复时,会用配置值替换待插入的值;如果不指定ON DUPLICATE KEY UPDATE,当要插入的主键或唯一键有重复时,插入报错。</p></td></tr></tbody></table> ## 示例 示例表及数据基于以下定义: ~~~ OceanBase(admin@test)>create table t1(c1 int primary key, c2 int) partition by key(c1) partitions 4; Query OK, 0 rows affected (0.16 sec) OceanBase(admin@test)>create table t2(c1 int primary key, c2 int); Query OK, 0 rows affected (0.16 sec) OceanBase(admin@test)>select * from t2; +----+------+ | c1 | c2 | +----+------+ | 1 | 1 | | 2 | 2 | | 3 | 3 | | 4 | 4 | +----+------+ 4 rows in set (0.06 sec) ~~~ * 向表 t1 中插入一行数数据。 ~~~ OceanBase(admin@test)>insert into t1 values(1,1); Query OK, 1 row affected (0.01 sec) OceanBase(admin@test)>select * from t1; +----+------+ | c1 | c2 | +----+------+ | 1 | 1 | +----+------+ 1 row in set (0.04 sec) ~~~ * 向表 t1 中插入多行数据。 ~~~ OceanBase(admin@test)>insert t1 values(1,1),(2,default),(2+2,3*4); Query OK, 3 rows affected (0.02 sec) Records: 3 Duplicates: 0 Warnings: 0 OceanBase(admin@test)>select * from t1; +----+------+ | c1 | c2 | +----+------+ | 1 | 1 | | 2 | NULL | | 4 | 12 | +----+------+ 3 rows in set (0.02 sec) ~~~ * 向表 t1 指定的 p0 分区插入单行数据。 ~~~ OceanBase(admin@test)>insert into t1 partition(p0) (c1) values(5); Query OK, 1 row affected (0.02 sec) OceanBase(admin@test)>select * from t1 partition(p0); +----+------+ | c1 | c2 | +----+------+ | 5 | NULL | +----+------+ 1 row in set (0.01 sec) ~~~ * 将表 t2 的查询结果作为数据插入表 t1。 ~~~ OceanBase(admin@test)>insert into t1 select * from t2; Query OK, 4 rows affected (0.02 sec) Records: 4 Duplicates: 0 Warnings: 0 OceanBase(admin@test)>select * from t1; +----+------+ | c1 | c2 | +----+------+ | 1 | 1 | | 2 | 2 | | 3 | 3 | | 4 | 4 | +----+------+ 4 rows in set (0.01 sec) ~~~ * 向表 t1 中插入重复主键值时利用 ON DUPLICATE KEY UPDATE 功能进行值更新 ~~~ OceanBase(admin@test)>insert into t1 values(1,1),(1,2) ON DUPLICATE KEY UPDATE c1=100; Query OK, 3 rows affected (0.01 sec) Records: 2 Duplicates: 1 Warnings: 0 OceanBase(admin@test)>select * from t1; +-----+------+ | c1 | c2 | +-----+------+ | 100 | 1 | +-----+------+ 1 row in set (0.02 sec) ~~~ * 对可更新视图v的插入值 ~~~ OceanBase(admin@test)>create view v as select * from t1; Query OK, 0 rows affected (0.07 sec) OceanBase(admin@test)>insert into v values(1,1); Query OK, 1 row affected (0.01 sec) OceanBase(admin@test)>select * from v; +----+------+ | c1 | c2 | +----+------+ | 1 | 1 | +----+------+ 1 row in set (0.02 sec) ~~~ ## 注意事项 INSERT语句不支持直接对子查询进行插入操作,比如: `insert into (select * from t1) values(1, 1);`