MariaDB 教程 / 用 INSERT 添加一行和多行数据

INSERT 用于向表中添加新行。明确列出目标列,并在 VALUES 后提供一个或多个带圆括号的值列表,再核对插入行数和实际保存的值。值按列列表的位置对应,执行成功并不能单独证明价格、库存等信息放进了正确的列。

让输入值与目标列逐一对应

每件商品是一行,编号、名称、分类、价格、库存和备注分别保存到不同列。INSERT 根据列列表的顺序匹配值,不会根据值看起来像什么来自动纠正。价格和库存都是数字,位置颠倒后也可能成为可保存但含义错误的记录。先按CREATE TABLE 结构检查方法确认目标,再考虑如何写入。

输入项目 例子 检查点
表 products_13_lab 当前数据库为 shopcourse
列列表 product_name, price 列数与顺序对应值列表
字符串 'Notebook' 使用单引号
数字 3500.00 不混入货币单位或千位分隔逗号
缺失值 NULL 不同于字符串 'NULL'

省略列列表,会让语句依赖整个表的列顺序;结构变化后也更难复核。字符串中的单引号可用两个单引号表示,例如 'O''Brien'。应用接收外部输入时,应使用参数化查询,而不是直接拼接 SQL 字符串。语法与条件见 INSERT 官方参考。

运行单行与多行插入的完整示例

用 course_user 连接学习服务器,选择 shopcourse。按照命令行与 UTF-8 文件教程保存完整代码,并使用 SOURCE 和文件的实际完整本机路径执行。SQL 应在 MariaDB 客户端中运行,不是在操作系统终端中运行。

建表前执行 SELECT VERSION(), DATABASE() 和 SHOW TABLES,检查服务器及已有对象。本篇仅使用独立的 products_13_lab。如果已存在,先查看定义和行,确认是否是可丢弃的练习对象;不要替换已有应用表。

先完成表定义,再进行写入。第一条 INSERT 添加一件商品,第二条添加其余五件。最初六个编号明确指定,方便复核结果;省略编号时的生成行为在后面单独观察。

USE shopcourse;
CREATE TABLE products_13_lab (
  product_id INT NOT NULL AUTO_INCREMENT,
  product_name VARCHAR(100) NOT NULL,
  category VARCHAR(30) NOT NULL,
  price DECIMAL(10,2) NOT NULL,
  stock INT NOT NULL DEFAULT 0,
  note VARCHAR(100) NULL DEFAULT NULL,
  PRIMARY KEY (product_id),
  CONSTRAINT ck_p13_price CHECK (price >= 0),
  CONSTRAINT ck_p13_stock CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_13_lab
  (product_id, product_name, category, price, stock, note)
VALUES (1, '노트', '문구', 3500.00, 20, NULL);
SELECT ROW_COUNT() AS inserted_rows;
INSERT INTO products_13_lab
  (product_id, product_name, category, price, stock, note)
VALUES
  (2, '볼펜', '문구', 1500.00, 0, ''),
  (3, '머그컵', '생활', 8000.00, 12, '선물 포장'),
  (4, '스탠드', '생활', 25000.00, 5, NULL),
  (5, '파일', '문구', 1500.00, 50, ''),
  (6, '케이블', '전자', 8000.00, 0, '호환 확인');
SELECT ROW_COUNT() AS inserted_rows;

SQL 保留原始韩文练习字符串,以便与原文使用相同输入检查 UTF-8。编号 1 至 6 分别是笔记本、圆珠笔、马克杯、台灯、文件夹和线缆;分类文具、家居、电子在代码中分别写为 문구、생활、전자。请原样输入字符串,并用编号对照结果,不要在尚未核对编码时反复插入。

两次紧接 INSERT 的 ROW_COUNT() 应分别返回 1 和 5。它反映前一条语句的影响,插入后夹入另一条查询就可能改变其含义,详见 ROW_COUNT 官方说明。autocommit 启用时,两条 INSERT 可以分别提交,第二条失败不会自动撤销第一条已成功的写入。

读取并核对已保存的六行

SELECT product_id, product_name, category, price, stock, note FROM products_13_lab ORDER BY product_id;
ID 商品含义 price stock 备注状态或含义
1 笔记本 3500.00 20 NULL
2 圆珠笔 1500.00 0 空字符串
3 马克杯 8000.00 12 礼品包装
4 台灯 25000.00 5 NULL
5 文件夹 1500.00 50 空字符串
6 线缆 8000.00 0 检查兼容性

上表的商品与备注文字是原始韩文字符串的中文解释,不表示 SQL 已把它们翻译后保存。逐列核对编号、分类、价格、库存和备注,而不是仅查看成功提示。如果客户端让 NULL 与空备注看起来类似,可用 note IS NULL 区分。文字乱码时,先检查源文件是否 UTF-8、连接是否 utf8mb4,避免把同样有问题的内容再次写入。

该查询通过 ORDER BY product_id 固定结果顺序。这里的价格都是同一示例单位的数值,不能直接理解为真实商品售价或货币兑换结果。核对最终行数可以使用 SELECT COUNT(*) FROM products_13_lab,正常示例后应为六行。

观察自动编号和省略列的默认值

下面的整个块在同一个连接执行。它省略编号、库存与备注,查看新增行后回滚。在未进行其他写入尝试的全新示例中,默认自增配置下 generated_id 为 7;有过其他尝试时,应读取实际生成值,不强求仍是同一个编号。

START TRANSACTION;
INSERT INTO products_13_lab (product_name, category, price)
VALUES ('연습 상품', '문구', 2000.00);
SELECT LAST_INSERT_ID() AS generated_id;
SELECT product_id, stock, note IS NULL AS note_is_null
FROM products_13_lab WHERE product_id = LAST_INSERT_ID();
ROLLBACK;
SELECT COUNT(*) AS remaining_rows FROM products_13_lab;

省略 stock 使用 DEFAULT 0,省略 note 使用 DEFAULT NULL。显式向 NOT NULL 列传入 NULL 与省略列不同,NULL 和默认值教程解释了这些条件。ROLLBACK 将记录数恢复为六,但不保证下一次生成的编号重新使用 7;自动编号与主键教程展示了编号空缺的原因。

先确认 INSERT 成功,再在同一连接立即使用 LAST_INSERT_ID。若中途断开或换到其他连接,不能把用户看到的某个编号自动视为刚才那次写入的结果。回滚后核对行数和原六行数据,才能确认新增练习行确实未保留。

将无效输入逐条单独测试

正常六行保存后,逐条执行下面的预期失败语句。它们依次重复主键 1、为两列只提供一个值,以及为必填商品名提供 NULL:

INSERT INTO products_13_lab (product_id, product_name, category, price)
VALUES (1, '중복 상품', '문구', 1000);

INSERT INTO products_13_lab (product_name, price) VALUES ('값 부족');

INSERT INTO products_13_lab (product_name, category, price)
VALUES (NULL, '문구', 1000);

应分别出现重复键、列值数量不匹配、不能为 NULL 的错误。每次之后都执行 SELECT COUNT(*) FROM products_13_lab,结果应仍为六。原代码块中的语句应一条条执行,不要把预期报错混进正常初始化文件,以免错误中断后面的检查。

修复实际原因,不要只为隐藏错误而改成 INSERT IGNORE 或 REPLACE。它们具有不同的数据处理效果,不能当作“本来这条 INSERT 就已正确完成”。如果文件只执行了一部分,先检查已存在的对象与行,决定从哪里重试,避免重复写入。

检查警告并限定重做对象

SQL 模式影响无效输入和越界值。本例的价格和库存都在声明范围内,表中也定义了非负 CHECK;如果出现警告,立即在相关语句后运行 SHOW WARNINGS。不要把值被调整后仍成功的情况误认为原值已准确保存。

多行 INSERT 可以减少逐行发送的网络往返,但仍受语句大小等限制,不能据此保证某个环境下的具体速度。大规模文件导入还需格式和数据验证,应按专门流程处理。

重做前检查当前数据库、实际表定义及现有行,备份所有要保留的数据。确认 products_13_lab 只是本文可丢弃的练习对象后,仅删除它:

DROP TABLE shopcourse.products_13_lab;

DROP TABLE 同时删除结构和行,普通 ROLLBACK 不能恢复。把清理与事务实验分开;重新执行完整正常文件后,再核对行数与每列的值。其他练习表及业务数据不属于本次清理范围。