{"position":0,"title":"介绍","layout":"doc-fullscreen","text":"## 介绍nn在本实验中，你将学习如何在 SQLite 数据库中更高效地处理错误与约束冲突。核心内容是通过 `ON CONFLICT` 子句，在执行 `INSERT` 插入操作时管理约束违规（constraint violations）。nn你将先创建一个数据库，以及一张包含 `UNIQUE` 唯一约束的表。随后，你会了解当发生冲突时 SQLite 可采用的不同处理方式，包括 `ROLLBACK`、`ABORT`、`FAIL`、`IGNORE` 和 `REPLACE`。其中，本实验会重点演示 `ON CONFLICT IGNORE` 的用法，帮助你在出现唯一约束冲突时避免插入失败。整个过程将通过实际示例，引导你完成数据插入、冲突处理和错误控制。n","need_verify":false,"has_solution":false},{"position":1,"title":"创建一个带有 UNIQUE 约束的 SQLite 数据库和表","layout":"doc-workbench-split","text":"## 创建一个带有 UNIQUE 约束的 SQLite 数据库和表nn在这一步中，你将创建一个 SQLite 数据库，并新建一张带有 `UNIQUE` 唯一约束的表。这个约束可以帮助你理解，当插入重复数据时，SQLite 是如何进行错误处理和约束检查的。nn首先，在 LabEx VM 中打开终端。默认工作目录是 `/home/labex/project`。nn现在，创建一个名为 `my_database.db` 的 SQLite 数据库。运行以下命令来创建数据库文件，并进入 SQLite 命令行工具：nn```bashnsqlite3 my_database.dbn```nn执行后，你会看到类似下面的提示，表示当前已经进入 SQLite shell：nn```nSQLite version 3.x.xnEnter \".help\" for usage hints.nsqlite>n```nn接下来，创建一张名为 `users` 的表，用于保存用户信息。该表包含三列：`id`、`username` 和 `email`。其中，`username` 列设置了 `UNIQUE` 约束，这表示表中的每个用户名都必须保持唯一。在 `sqlite>` 提示符下输入以下 SQL 命令，然后按 Enter：nn```sqlnCREATE TABLE users (n id INTEGER PRIMARY KEY AUTOINCREMENT,n username TEXT UNIQUE NOT NULL,n email TEXT NOT NULLn);n```nn这条 SQL 语句创建了 `users` 表，具体含义如下：nn- `id` 是整数字段，每插入一条新记录都会自动递增。`PRIMARY KEY` 约束保证每个 `id` 唯一，而 `AUTOINCREMENT` 用于自动生成递增编号。n- `username` 是文本字段，不能为空（`NOT NULL`），并且必须唯一（`UNIQUE`）。n- `email` 同样是文本字段，且不能为空（`NOT NULL`）。nn如果命令执行成功，终端通常不会显示任何输出。n","need_verify":true,"has_solution":false},{"position":2,"title":"向表中插入数据","layout":"doc-workbench-split","text":"## 向表中插入数据nn现在你已经成功创建了 `users` 表，接下来可以向其中插入测试数据。这里我们先添加一条用户记录。nn在 `sqlite>` 提示符下运行下面这条命令，将一条用户信息插入到 `users` 表：nn```sqlnINSERT INTO users (username, email) VALUES ('Alice', 'alice@example.com');n```nn这条命令会向 `users` 表新增一行数据。nn- `INSERT INTO users (username, email)` 表示要向 `users` 表的 `username` 和 `email` 两个字段插入值。n- `VALUES ('Alice', 'alice@example.com')` 指定了本次插入的实际内容。nn为了确认数据是否已经成功写入，可以执行以下查询命令，查看表中的所有记录：nn```sqlnSELECT * FROM users;n```nn**预期输出：**nn```n1|Alice|alice@example.comn```nn该输出依次显示了记录的 `id`、`username` 和 `email`。其中，`SELECT *` 语句用于查询指定数据表中的全部列。n","need_verify":true,"has_solution":false},{"position":3,"title":"尝试插入重复数据","layout":"doc-workbench-split","text":"## 尝试插入重复数据nn在这一步中，你将尝试插入一条用户名重复的记录。由于 `username` 字段带有 `UNIQUE` 约束，这次操作会触发唯一约束冲突并返回错误。nn在 `sqlite>` 提示符下执行以下命令：nn```sqlnINSERT INTO users (username, email) VALUES ('Alice', 'alice2@example.com');n```nn执行后，你会看到类似下面的错误信息：nn```nError: UNIQUE constraint failed: users.usernamen```nn这条错误信息说明 `username` 列上的 `UNIQUE` 唯一约束被违反了。为了保证数据一致性和完整性，SQLite 会阻止重复用户名被插入到表中。n","need_verify":true,"has_solution":false},{"position":4,"title":"使用 ON CONFLICT IGNORE 处理约束冲突","layout":"doc-workbench-split","text":"## 使用 ON CONFLICT IGNORE 处理约束冲突nn在这一步中，你将学习如何使用 `ON CONFLICT IGNORE` 子句来处理约束冲突。当插入操作可能违反约束时，这个子句会告诉 SQLite 直接忽略当前插入，而不是抛出错误。nn在 `sqlite>` 提示符下运行以下命令：nn```sqlnINSERT OR IGNORE INTO users (username, email) VALUES ('Alice', 'alice2@example.com');n```nn这条语句会尝试插入一条用户名为 'Alice' 的新记录。但由于使用了 `ON CONFLICT IGNORE`，当检测到唯一约束冲突时，SQLite 会跳过这次插入，不会报错，也不会写入重复数据。nn为了确认重复记录确实没有被插入，请执行下面的查询命令：nn```sqlnSELECT * FROM users;n```nn**预期输出：**nn```n1|Alice|alice@example.comn```nn结果表明，表中仍然只保留原来的那条用户名为 'Alice' 的记录，重复数据已经被忽略。nn`INSERT OR IGNORE` 是 SQLite 中处理插入冲突的常用方式之一，适用于需要避免报错、同时保持数据完整性的场景。n","need_verify":true,"has_solution":false},{"position":5,"title":"使用 ON CONFLICT REPL使用 ON CONFLICT REPLACE 处理约束冲突\n\n这一节主要讲的是，遇到约束冲突时，怎样借助 `ON CONFLICT REPLACE` 子句来处理。它的意思很直接：如果插入操作会触发约束冲突，SQLite 就不会简单报错，而是用新记录把原有记录替换掉。\n\n在 `sqlite>` 提示符下执行下面这条命令：\n\n```sql\nINSERT OR REPLACE INTO users (id, username, email) VALUES (1, 'Alice', 'alice3@example.com');\n```\n\n这条语句会尝试插入一条用户名为 `'Alice'` 的新记录。因为这里用了 `ON CONFLICT REPLACE` 子句，所以一旦发生约束冲突，SQLite 会直接用新记录替换原来的记录。需要特别注意的是，这种情况下必须显式指定 `id`，因为 `REPLACE` 的实际处理方式是先删除旧行，再插入新行。\n\n如果想确认记录是否已经被替换，可以继续执行：\n\n```sql\nSELECT * FROM users;\n```\n\n预期输出如下：\n\n```sql\n1|Alice|alice3@example.com\n```\n\n从结果可以看到，用户名为 `'Alice'` 的这条记录，电子邮件地址已经更新成了 `alice3@example.com`。\n\n`INSERT OR REPLACE` 提供了一种比较直接的方式：既能处理冲突，又能在保持数据完整性的前提下更新已有记录。\n\n最后，退出 SQLite shell：\n\n```sql\n.exit\n```\n\n这样就会关闭数据库连接，并返回终端。\n\n总结通过这个实验，你已经掌握了在 SQLite 数据库里更稳妥地处理错误的方法，重点放在 `INSERT` 操作时出现的约束冲突上。整个过程里，先创建了数据库，以及一张带有 `UNIQUE` 约束的表；接着插入数据，再故意插入重复内容来触发报错。随后，又进一步了解了如何借助 `ON CONFLICT IGNORE` 和 `ON CONFLICT REPLACE` 这两个子句来应对这类约束冲突，从而更灵活地决定 SQLite 在潜在错误发生时该如何处理，同时保证数据完整性。"}