sqlite3 命令行工具详细介绍

一、启动与退出

启动数据库连接

bash 复制代码

sqlite3 [database_file]  # 打开/创建数据库文件（如 test.db）
sqlite3                  # 启动临时内存数据库 (:memory:)
sqlite3 :memory:         # 显式启动内存数据库

文件不存在时自动创建
不指定文件名则使用临时内存数据库（关闭后消失）

退出 CLI

sqlite 复制代码

.exit
.quit
Ctrl + D (Linux/macOS)
Ctrl + C (Windows)

二、数据库与文件操作

命令	说明	示例
`.open [FILENAME]`	打开/切换数据库	`.open backup.db`
`.backup ?DB? FILE`	在线备份数据库	`.backup main backup_2023.db`
`.restore ?DB? FILE`	从文件恢复数据库	`.restore main backup_2023.db`
`.dump ?TABLE?`	导出数据库为 SQL 脚本	`.dump > full.sql` `.dump users > users.sql`
`.read FILENAME`	执行 SQL 脚本文件	`.read import_data.sql`
`.save FILE`	保存内存数据库到文件	`.save mem_backup.db`

三、元数据查询

命令	说明
`.databases`	显示所有附加数据库
`.tables ?PATTERN?`	列出表（支持通配符）
`.schema ?TABLE?`	显示表结构（CREATE语句）
`.indexes ?TABLE?`	列出索引
`.fullschema`	显示完整 schema（包括隐藏信息）

四、数据操作与导入导出

CSV 导入导出

sqlite 复制代码

-- 设置 CSV 模式
.mode csv
.headers on   -- 导出时包含列名

-- 导入 CSV
.import users.csv users  -- 文件 → 表

-- 导出 CSV
.output users_export.csv
SELECT * FROM users;
.output stdout           -- 恢复输出到终端

其他格式

sqlite 复制代码

.mode list       -- 自定义分隔符 (默认 '|')
.mode insert     -- 生成 INSERT 语句
.mode json       -- JSON 格式输出
.separator ","   -- 设置分隔符（如 CSV）
.nullvalue NULL  -- 指定 NULL 的显示值

五、查询输出格式化

命令	效果	示例输出
`.mode list`	竖线分隔	`1
`.mode csv`	CSV 格式	`"1","Alice","30"`
`.mode column`	表格对齐	`1 Alice 30`
`.mode box`	表格+边框	`┌──┬───────┬──┐` `│1 │ Alice │30│`
`.mode json`	JSON 数组	`[{"id":1,"name":"Alice","age":30}]`
`.headers on/off`	显示/隐藏列名
`.width NUM1 NUM2`	设置列宽	`.width 5 10 4`
`.timer on/off`	显示查询耗时	`Run Time: real 0.002 user 0.000000 sys 0.000000`

六、实用功能

命令	说明
`.show`	显示当前所有设置
`.stats on/off`	开关性能统计
`.timefmt FORMAT`	设置日期格式
`.shell CMD`	执行系统命令
`.system CMD`	同上（别名）
`.prompt MAIN CONTINUE`	自定义提示符

七、高级操作

附加多个数据库

sqlite 复制代码

ATTACH DATABASE 'aux.db' AS aux;
SELECT * FROM main.users JOIN aux.orders ...;
.databases  -- 查看附加数据库

执行 PRAGMA 配置

sqlite 复制代码

PRAGMA journal_mode=WAL;    -- 启用 WAL 模式
PRAGMA synchronous=NORMAL;  -- 平衡性能与安全
PRAGMA foreign_keys=ON;     -- 启用外键约束

事务控制

sqlite 复制代码

BEGIN TRANSACTION;
UPDATE accounts SET balance = balance - 100 WHERE id=1;
UPDATE accounts SET balance = balance + 100 WHERE id=2;
COMMIT;  -- 或 ROLLBACK

八、快捷示例场景

场景 1：从 CSV 创建新表并导入

bash 复制代码

sqlite3 finance.db  # 创建数据库

sqlite 复制代码

-- 创建表
CREATE TABLE transactions (
    id INTEGER PRIMARY KEY,
    date TEXT,
    amount REAL,
    description TEXT
);

-- 导入 CSV
.mode csv
.import transactions.csv transactions

-- 验证数据
SELECT count(*) FROM transactions;

场景 2：备份与恢复

bash 复制代码

# 完整备份
sqlite3 production.db ".backup main backup_20231001.db"

# 恢复数据库
sqlite3 restored.db ".restore main backup_20231001.db"

九、注意事项

命令分类
- 点命令 (.) ：以 . 开头（如 .tables），不需分号结尾
- SQL 语句 ：标准 SQL（SELECT, CREATE 等），必须用分号 ; 结尾
特殊字符转义

在字符串中使用单引号时需转义：
sql 复制代码
```
INSERT INTO logs (message) VALUES ('It''s a test');
```
资源限制

查看限制：PRAGMA compile_options;

常见限制：SQLITE_MAX_LENGTH=1,000,000,000 (字符串/Blob最大长度)

掌握这些命令后，您可通过 sqlite3 CLI 高效完成日常数据库管理任务！