> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MySQL INSERT

> MySQL INSERT 语句如何添加一行，服务器在您省略的列中放入什么，以及第一次 INSERT 最常遇到的 2 个错误。

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

到目前为止，每一课都在读取数据。`INSERT` 写入数据。从这里开始，语句会改变表中的内容，所以教程的其余部分在一个独立的数据库中进行，而不是在示例数据中。

## 一个练习数据库

Sakila 是每一节读取课所描述的参照，所以不要动它。改为在它旁边建一个小数据库，每当您想重新开始时，就再运行一次这段代码。

```sql theme={null}
DROP DATABASE IF EXISTS sakila_practice;
CREATE DATABASE sakila_practice;
USE sakila_practice;

CREATE TABLE member (
  member_id  INT UNSIGNED NOT NULL AUTO_INCREMENT,
  first_name VARCHAR(45) NOT NULL,
  last_name  VARCHAR(45) NOT NULL,
  email      VARCHAR(100) DEFAULT NULL,
  joined     DATE NOT NULL,
  active     TINYINT NOT NULL DEFAULT 1,
  PRIMARY KEY (member_id),
  UNIQUE KEY uq_member_email (email)
);

INSERT INTO member (first_name, last_name, email, joined, active) VALUES
  ('Mary',     'Smith',    'mary.smith@example.com',       '2026-01-04', 1),
  ('Patricia', 'Johnson',  'patricia.johnson@example.com', '2026-02-11', 1),
  ('Linda',    'Williams', 'linda.williams@example.com',   '2026-03-02', 0);

CREATE TABLE rating_count (
  rating VARCHAR(10) NOT NULL,
  films  INT UNSIGNED NOT NULL,
  PRIMARY KEY (rating)
);

CREATE TABLE account (
  account_id INT UNSIGNED NOT NULL AUTO_INCREMENT,
  owner      VARCHAR(45) NOT NULL,
  balance    DECIMAL(10,2) NOT NULL,
  PRIMARY KEY (account_id)
);

INSERT INTO account (owner, balance) VALUES
  ('Mary Smith',       500.00),
  ('Patricia Johnson', 250.00);
```

本节的每一课都从那个状态开始。开始之前，请用 `mysql -u root -p sakila_practice` 打开客户端，并在课与课之间再运行一次这段代码块。

## INSERT 的工作原理

```sql theme={null}
INSERT INTO TABLE_NAME (COLUMN_LIST)
VALUES (VALUE_LIST);
```

把 `TABLE_NAME` 替换为您要写入的表，`COLUMN_LIST` 替换为您提供的列，`VALUE_LIST` 替换为对应这些列的值，每列 1 个，顺序相同。

服务器添加一行，并报告它写入了多少行。它不会把行打印回来，所以之后用 `SELECT` 才能看到结果。

## 示例

### 添加一行

```sql theme={null}
INSERT INTO member (first_name, last_name, email, joined)
VALUES ('Jennifer', 'Davis', 'jennifer.davis@example.com', '2026-03-18');
```

```text theme={null}
Query OK, 1 row affected (0.00 sec)
```

`Query OK` 和 `1 row affected` 就是全部报告。查询这个表，看看写入了什么。

```sql theme={null}
SELECT * FROM member;
```

```text theme={null}
+-----------+------------+-----------+------------------------------+------------+--------+
| member_id | first_name | last_name | email                        | joined     | active |
+-----------+------------+-----------+------------------------------+------------+--------+
|         1 | Mary       | Smith     | mary.smith@example.com       | 2026-01-04 |      1 |
|         2 | Patricia   | Johnson   | patricia.johnson@example.com | 2026-02-11 |      1 |
|         3 | Linda      | Williams  | linda.williams@example.com   | 2026-03-02 |      0 |
|         4 | Jennifer   | Davis     | jennifer.davis@example.com   | 2026-03-18 |      1 |
+-----------+------------+-----------+------------------------------+------------+--------+
4 rows in set (0.00 sec)
```

语句指定了 4 列，而这一行有 6 列。`member_id` 自己计数递增，因为该列是 `AUTO_INCREMENT`；`active` 取了表声明的 `DEFAULT 1`。

### 读回服务器选定的 id

`AUTO_INCREMENT` 的值在插入期间决定，所以了解它的唯一方法是去问。请在执行插入的同一个会话中问。

```sql theme={null}
INSERT INTO member (first_name, last_name, email, joined)
VALUES ('Barbara', 'Jones', 'barbara.jones@example.com', '2026-03-20');
SELECT LAST_INSERT_ID() AS new_id;
```

```text theme={null}
Query OK, 1 row affected (0.00 sec)

+--------+
| new_id |
+--------+
|      5 |
+--------+
1 row in set (0.00 sec)
```

`LAST_INSERT_ID()` 只回答您自己的连接，所以繁忙的服务器不会把另一个会话的 id 交给您。新建的连接没有答案可给，返回 0。

## ERROR 1062 表示该行已经存在

`UNIQUE` 列拒绝携带它已持有的值的第二行。这里 `email` 是唯一的，而 Mary Smith 的地址已被占用。

```sql theme={null}
INSERT INTO member (first_name, last_name, email, joined)
VALUES ('Mary', 'Smith', 'mary.smith@example.com', '2026-05-01');
```

```text theme={null}
ERROR 1062 (23000): Duplicate entry 'mary.smith@example.com' for key 'member.uq_member_email'
```

该消息指出了值和拒绝它的索引，这通常足以区分真正的重复和一个您本想设为唯一却没有设的列。[Upsert](https://villagesql.com/docs/zh/tutorial/upsert.md) 是预期到这种情况并改为更新现有行的语句。

## ERROR 1364 表示缺少必填列

省略一个 `NOT NULL` 且没有默认值的列，服务器就没有东西可写。

```sql theme={null}
INSERT INTO member (first_name) VALUES ('Sam');
```

```text theme={null}
ERROR 1364 (HY000): Field 'last_name' doesn't have a default value
```

它每次只指出 1 列，所以缺少 3 列的语句需要 3 次尝试。用 `DESCRIBE member;` 读取该表，提供所有在 `Null` 列下标记为 `NO` 且没有默认值的列。

接受 NULL 的列是另一种情况。省略它，该行就得到 NULL。

```sql theme={null}
INSERT INTO member (first_name, last_name, joined)
VALUES ('George', 'Miller', '2026-04-01');
```

```text theme={null}
Query OK, 1 row affected (0.00 sec)
```

## 重复键仍然会用掉一个 id

现在查询 id，6 不见了。

```sql theme={null}
SELECT member_id, first_name, last_name, email, active FROM member;
```

```text theme={null}
+-----------+------------+-----------+------------------------------+--------+
| member_id | first_name | last_name | email                        | active |
+-----------+------------+-----------+------------------------------+--------+
|         1 | Mary       | Smith     | mary.smith@example.com       |      1 |
|         2 | Patricia   | Johnson   | patricia.johnson@example.com |      1 |
|         3 | Linda      | Williams  | linda.williams@example.com   |      0 |
|         4 | Jennifer   | Davis     | jennifer.davis@example.com   |      1 |
|         5 | Barbara    | Jones     | barbara.jones@example.com    |      1 |
|         7 | George     | Miller    | NULL                         |      1 |
+-----------+------------+-----------+------------------------------+--------+
6 rows in set (0.00 sec)
```

那次重复键尝试在失败前取走了 6，而 InnoDB 不会把号码交回。那次 `ERROR 1364` 尝试什么都没取走，因为它在到达表之前就被拒绝了。这样的空缺是正常的，不表示有任何东西丢失。把这一列当作标识符，而不要当作行数的计数，也不要当作数字连续不断的承诺。

## 小结

* 写 `INSERT INTO table (columns) VALUES (values)` 来添加一行。
* 返回的是写入行数，而不是行本身。
* 省略有默认值或 `AUTO_INCREMENT` 的列，让服务器填充它。
* 把 `ERROR 1062` 理解为 `UNIQUE` 列已经持有的值。
* 把 `ERROR 1364` 理解为您没有提供的必填列。
* `AUTO_INCREMENT` 列中会有空缺，因为重复键失败会保留它的号码。

## 另请参阅

* [插入多行](https://villagesql.com/docs/zh/tutorial/insert-multiple-rows.md) — 1 条语句，多行
* [INSERT SELECT](https://villagesql.com/docs/zh/tutorial/insert-select.md) — 来自查询的行，而不是逐个输入
* [Upsert](https://villagesql.com/docs/zh/tutorial/upsert.md) — 插入，或更新挡在路上的那一行
* [UPDATE](https://villagesql.com/docs/zh/tutorial/update.md) — 修改已经存在的行


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.