13.2.5 插入语句

INSERT [LOW_PRIORITY | DELAYED | HIGH_PRIORITY] [IGNORE]
    [INTO] tbl_name
    [PARTITION (partition_name [, partition_name] ...)]
    [(col_name [, col_name] ...)]
    {VALUES | VALUE} (value_list) [, (value_list)] ...
    [ON DUPLICATE KEY UPDATE assignment_list]

INSERT [LOW_PRIORITY | DELAYED | HIGH_PRIORITY] [IGNORE]
    [INTO] tbl_name
    [PARTITION (partition_name [, partition_name] ...)]
    SET assignment_list
    [ON DUPLICATE KEY UPDATE assignment_list]

INSERT [LOW_PRIORITY | HIGH_PRIORITY] [IGNORE]
    [INTO] tbl_name
    [PARTITION (partition_name [, partition_name] ...)]
    [(col_name [, col_name] ...)]
    SELECT ...
    [ON DUPLICATE KEY UPDATE assignment_list]

value:
    {expr | DEFAULT}

value_list:
    value [, value] ...

assignment:
    col_name = value

assignment_list:
    assignment [, assignment] ...

INSERT将新行插入到现有表中。语句的INSERT ... VALUESand INSERT ... SET 形式根据明确指定的值插入行。该INSERT ... SELECT表单插入从另一个表或多个表中选择的行。如果要插入的行会导致索引或中出现重复值, INSERTwith ON DUPLICATE KEY UPDATE子句可以更新现有行。 UNIQUEPRIMARY KEY

有关 INSERT ... SELECTand 的更多信息INSERT ... ON DUPLICATE KEY UPDATE,请参阅 第 13.2.5.1 节,“INSERT ... SELECT 语句”第 13.2.5.2 节,“INSERT ... ON DUPLICATE KEY UPDATE 语句”

在 MySQL 5.7 中,DELAYED关键字被服务器接受但被忽略。为此,请参阅第 13.2.5.3 节,“插入延迟语句”

插入表需要表的 INSERT权限。如果ON DUPLICATE KEY UPDATE使用该子句并且重复键导致UPDATE执行 an,则该语句需要 UPDATE更新列的权限。对于已读取但未修改的列,您只需要特权(例如,对于仅在 子句 中= 赋值SELECT的右侧引用的列 )。col_nameexprON DUPLICATE KEY UPDATE

插入分区表时,您可以控制哪些分区和子分区接受新行。该 PARTITION子句采用表的一个或多个分区或子分区(或两者)的逗号分隔名称列表。如果给定语句要插入的任何行与INSERT列出的分区之一不匹配,则 INSERT语句失败并显示错误Found a row not matching the given partition set。有关更多信息和示例,请参阅 第 22.5 节,“分区选择”

tbl_name是应该插入行的表。指定语句为其提供值的列,如下所示:

  • 在表名后提供一个用括号括起来的以逗号分隔的列名列表。在这种情况下,每个命名列的值必须由VALUES列表或SELECT语句提供。

  • 如果您没有为 INSERT ... VALUES或 指定列名列表INSERT ... SELECT,则表中每一列的值都必须由VALUES列表或 SELECT语句提供。如果您不知道表中列的顺序,请使用 查找。 DESCRIBE tbl_name

  • 子句通过SET名称显式指示列,以及分配给每个列的值。

可以通过多种方式给出列值:

  • 如果未启用严格 SQL 模式,则任何未显式指定值的列都将设置为其默认(显式或隐式)值。例如,如果您指定的列列表未命名表中的所有列,则未命名的列将设置为其默认值。默认值分配在 第 11.6 节,“数据类型默认值”中描述。另见 第 1.7.3.3 节,“对无效数据的约束”

    如果启用了严格的 SQL 模式,如果 INSERT语句没有为没有默认值的每个列指定显式值,则会生成错误。请参阅 第 5.1.10 节,“服务器 SQL 模式”

  • 如果列列表和VALUES列表都为空,则INSERT创建一行并将每一列设置为其默认值:

    INSERT INTO tbl_name () VALUES();

    如果未启用严格模式,则 MySQL 对没有显式定义默认值的任何列使用隐式默认值。如果启用了严格模式,则如果任何列没有默认值,则会发生错误。

  • 使用关键字DEFAULT将列显式设置为其默认值。这使得编写 INSERT为除少数列之外的所有列赋值的语句变得更加容易,因为它使您能够避免编写VALUES不包含表中每一列的值的不完整列表。否则,您必须提供与列表中每个值对应的列名VALUES 列表。

  • 如果显式插入生成的列,则唯一允许的值为DEFAULT. 有关生成的列的信息,请参阅 第 13.1.18.7 节,“CREATE TABLE 和生成的列”

  • 在表达式中,您可以使用 来生成列的默认值 。 DEFAULT(col_name)col_name

  • expr如果表达式数据类型与列数据类型不匹配,则可能会发生提供列值 的表达式的类型转换 。根据列类型的不同,给定值的转换可能会导致不同的插入值。例如,将字符串'1999.0e-2' 插入INTFLOATDECIMAL(10,6)YEAR列会分别插入值 199919.992119.9921001999INTYEAR列中 存储的 值为1999因为字符串到数字的转换只查看字符串的初始部分,因为它可能被认为是有效的整数或年份。对于 FLOATDECIMAL列,字符串到数字的转换将整个字符串视为有效数值。

  • 表达式expr可以引用先前在值列表中设置的任何列。例如,您可以这样做,因为 for 的值col2 引用了col1之前已分配的值:

    INSERT INTO tbl_name (col1,col2) VALUES(15,col1*2);

    但是下面是不合法的,因为 for 的值是 col1col2,它是在 之后赋值的col1

    INSERT INTO tbl_name (col1,col2) VALUES(col2*2,15);

    AUTO_INCREMENT包含值 的列发生异常 。因为 AUTO_INCREMENT值是在其他赋值之后生成的,所以 AUTO_INCREMENT对赋值中列的任何引用都会返回一个0.

INSERT使用 VALUES语法的语句可以插入多行。为此,包括多个以逗号分隔的列值列表,列表用括号括起来并以逗号分隔。例子:

INSERT INTO tbl_name (a,b,c) VALUES(1,2,3),(4,5,6),(7,8,9);

每个值列表必须包含与每行要插入的值一样多的值。以下语句无效,因为它包含一个包含九个值的列表,而不是三个包含三个值的列表:

INSERT INTO tbl_name (a,b,c) VALUES(1,2,3,4,5,6,7,8,9);

VALUEVALUES在这种情况下是同义词 。既不暗示值列表的数量,也不暗示每个列表的值的数量。无论是单个值列表还是多个列表,并且无论每个列表的值数量如何,都可以使用两者之一。

INSERT可以使用 ROW_COUNT()SQL 函数或 mysql_affected_rows()C API 函数获取 an 的 affected-rows 值 。请参阅第 12.16 节,“信息函数”mysql_affected_rows()

如果您使用INSERT ... VALUES包含多个值列表 or INSERT ... SELECT的语句,该语句将返回以下格式的信息字符串:

Records: N1 Duplicates: N2 Warnings: N3

如果您使用的是 C API,则可以通过调用该mysql_info() 函数来获取信息字符串。请参阅mysql_info()

Records指示语句处理的行数。(这不一定是实际插入的行数,因为Duplicates可以为非零。)Duplicates表示无法插入的行数,因为它们会复制某些现有的唯一索引值。Warnings指示尝试插入以某种方式出现问题的列值的次数。在以下任何情况下都可能出现警告:

  • 插入NULL到已声明的列中NOT NULL。对于多行 INSERT语句或 INSERT INTO ... SELECT语句,列设置为列数据类型的隐式默认值。这适用 0于数字类型,空字符串 ( '') 适用于字符串类型, 值适用于日期和时间类型。 INSERT INTO ... SELECT语句的处理方式与多行插入相同,因为服务器不会检查结果集SELECT以查看它是否返回单行。(对于单行 INSERT,当 NULL插入到NOT NULL柱子。相反,该语句因错误而失败。)

  • 将数字列设置为位于列范围之外的值。该值被裁剪到范围的最近端点。

  • '10.34 a'为数字列 分配一个值,例如。尾随的非数字文本被剥离,剩余的数字部分被插入。如果字符串值没有前导数字部分,则该列设置为 0

  • 将字符串插入超过列最大长度的字符串列( CHARVARCHARTEXT或 )。BLOB该值被截断为列的最大长度。

  • 向日期或时间列中插入对于数据类型非法的值。该列被设置为适合该类型的零值。

  • 有关列值 的INSERT示例 ,请参阅第 3.6.9 节,“使用 AUTO_INCREMENT”AUTO_INCREMENT

    如果INSERT将一行插入到具有一列的表中,您可以使用SQL 函数或C API 函数 AUTO_INCREMENT找到用于该列的值 。LAST_INSERT_ID()mysql_insert_id()

    笔记

    这两个函数的行为并不总是相同。INSERT语句关于AUTO_INCREMENT列 的行为在第 12.16 节,“信息函数”mysql_insert_id()中进一步讨论。

INSERT语句支持以下修饰符:

  • 如果您使用LOW_PRIORITY修饰符,则执行INSERT会延迟,直到没有其他客户端从表中读取。这包括在现有客户正在阅读和INSERT LOW_PRIORITY声明正在等待时开始阅读的其他客户。因此,发出INSERT LOW_PRIORITY声明的客户端可能会等待很长时间。

    LOW_PRIORITY仅影响仅使用表级锁定的存储引擎(例如 MyISAMMEMORYMERGE)。

    笔记

    LOW_PRIORITY通常不应与MyISAM表一起使用,因为这样做会禁用并发插入。请参阅 第 8.11.3 节,“并发插入”

  • 如果您指定HIGH_PRIORITY,如果服务器是使用该选项启动的,它将覆盖该选项的效果 --low-priority-updates。它还会导致不使用并发插入。请参阅 第 8.11.3 节,“并发插入”

    HIGH_PRIORITY仅影响仅使用表级锁定的存储引擎(例如 MyISAMMEMORYMERGE)。

  • 如果使用IGNORE修饰符,则忽略执行 INSERT语句时发生的可忽略错误。例如,如果没有IGNORE,复制表中现有UNIQUE索引或 PRIMARY KEY值的行会导致重复键错误并且语句被中止。使用 IGNORE,该行被丢弃并且不会发生错误。忽略的错误会生成警告。

    IGNORE对于未找到与给定值匹配的分区的分区表的插入具有类似的效果。如果没有IGNORE,此类 INSERT语句将因错误而中止。使用时 INSERT IGNORE,对于包含不匹配值的行,插入操作会静默失败,但会插入匹配的行。有关示例,请参阅 第 22.2.2 节,“LIST 分区”

    IGNORE如果未指定 ,将触发错误的数据转换将中止语句。使用 IGNORE,将无效值调整为最接近的值并插入;产生警告但语句不会中止。您可以使用 mysql_info()C API 函数确定实际插入表中的行数。

    有关详细信息,请参阅 IGNORE 对语句执行的影响

    您可以使用REPLACEinstead of INSERT来覆盖旧行。 REPLACE对应 INSERT IGNORE于处理包含重复旧行的唯一键值的新行:新行替换旧行而不是被丢弃。请参阅 第 13.2.8 节,“REPLACE 语句”

  • 如果您指定ON DUPLICATE KEY UPDATE,并且插入的行会导致 UNIQUE索引或中出现重复值PRIMARY KEYUPDATE则会出现旧行。如果该行作为新行插入,则每行的 affected-rows 值为 1;如果更新现有行,则为 2;如果现有行设置为其当前值,则为 0。如果在连接到mysqldCLIENT_FOUND_ROWS时将标志指定给 mysql_real_connect()C API 函数,并且将现有行设置为其当前值,则受影响的行值为 1(而不是 0)。参见第 13.2.5.2 节,“INSERT ... ON DUPLICATE KEY UPDATE 语句”

  • INSERT DELAYED在 MySQL 5.6 中已弃用,并计划最终删除。在 MySQL 5.7 中,DELAYED修饰符被接受但被忽略。使用INSERT(without DELAYED) 代替。请参阅 第 13.2.5.3 节,“插入延迟语句”

影响使用存储引擎的分区表的INSERT语句(例如 MyISAM采用表级锁的语句)仅锁定实际插入行的那些分区。(对于诸如InnoDB 使用行级锁定的存储引擎,不会发生分区锁定。)有关更多信息,请参阅 第 22.6.4 节,“分区和锁定”