跳转到主要内容

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
一条 INSERT 可以携带任意多行。用逗号分隔每一行的括号。这比每行 1 条语句少打字,而且只需往返服务器 1 次而不是许多次。 这些示例使用 INSERT 中的 sakila_practice 数据库。开始之前,请再运行一次那里的设置代码块,然后用 mysql -u root -p sakila_practice 打开客户端。

多行 INSERT 的工作原理

把 TABLE_NAME 替换为表,COLUMN_LIST 替换为您提供的列,FIRST_ROW_VALUES 和 SECOND_ROW_VALUES 各替换为对应这些列的值,每列 1 个。 列清单只写一次,并约束每一行。每一组括号按该顺序提供值。

示例

  1. 1 条语句插入 3 行

只要一条语句可能写入超过 1 行,第二行就会出现,这包括多行 VALUES 列表和任何 INSERT SELECT。Records 统计您发送的行数,Duplicates 统计与已存储行冲突的行数,Warnings 统计服务器不得不调整的内容。这 3 个数字都与您发送的内容一致,就是没有任何东西被悄悄改动的标志。
id 按照各行写入的顺序接续下去。

一个坏行会让整条语句作废

下面的语句携带 3 行。中间那行重复使用了 Mary Smith 的地址,而 email 上的 UNIQUE 索引拒绝了它。
另外 2 行也没有写入。
一条语句要么全部成功,要么全部失败,所以一批 10,000 行中只要有 1 个坏值,就什么都不会写入。全有或全无也意味着大批数据在发送前需要先检查,因为服务器只会指出 1 个违规行,然后停下。

INSERT IGNORE 把错误变成警告

INSERT IGNORE 保留它能保留的行,跳过其余的行。
Records: 2 Duplicates: 1 准确报告了发生的事:提供了 2 行,拒绝了 1 行。SHOW WARNINGS 随后指出了它,同样的 ERROR 1062 文本以警告而不是失败的形式出现。
当重复确实表示”已经有了”时,使用 IGNORE。在其他情况下,它是一件钝器,因为它也会把其他错误降级,包括对列来说过长的值,以及必填列没有值的行。每次 INSERT IGNORE 之后都要运行 SHOW WARNINGS,否则您不会知道它丢弃了什么。当正确的做法是更新已存储的行时,请改用 upsert。

小结

  • 用逗号分隔每一行的括号,列清单只写一次。
  • 读取 Records、Duplicates 和 Warnings,确认没有任何东西被调整。
  • 1 个被拒绝的行会中止整条语句,什么都不写入。
  • 用 INSERT IGNORE 保留好的行,之后读取 SHOW WARNINGS。
  • 优先使用 1 条多行语句,而不是许多条单行语句。

另请参阅