如何修改SQLite3临时文件存储目录？解决大表索引创建空间不足问题

这个问题我太熟悉了——处理十亿级别的SQLite表时，临时B-tree的体积经常会超出预期，默认用系统SSD的临时目录确实容易爆盘。给你几个实用的解决办法，按灵活度排序：

1. 连接会话中临时指定临时目录（最推荐） #

在打开数据库后、创建索引前，执行PRAGMA命令指定临时文件的存储路径，这个设置只对当前连接生效，非常灵活：

-- 先打开数据库
sqlite3 your_large_db.db
-- 设置临时目录为你的大容量磁盘路径（必须是绝对路径）
sqlite> PRAGMA temp_store_directory = '/mnt/your_1tb_disk/sqlite_temp';
-- 然后创建索引
sqlite> CREATE INDEX idx_target_column ON your_big_table(target_column);

注意：SQLite 3.28.0之后，temp_store_directory被标记为过时，但大部分现有版本依然支持。如果你的版本较新，优先用下面的环境变量方法。

2. 通过环境变量全局指定临时目录 #

SQLite会优先读取SQLITE_TMPDIR环境变量来确定临时文件位置，无需修改SQL语句，适合脚本自动化场景：

• Linux/macOS：

# 先设置环境变量
export SQLITE_TMPDIR="/mnt/your_1tb_disk/sqlite_temp"
# 再启动SQLite并执行操作
sqlite3 your_large_db.db <<EOF
CREATE INDEX idx_target_column ON your_big_table(target_column);
EOF

• Windows：

set SQLITE_TMPDIR=D:\your_1tb_disk\sqlite_temp
sqlite3.exe your_large_db.db

3. 编译SQLite时固定临时目录（适合定制部署） #

如果你是自己编译SQLite库，可以在编译阶段直接指定默认临时目录，这样所有使用该版本的程序都会自动使用这个路径：

# 编译时添加编译选项
gcc -DSQLITE_TEMP_DIRECTORY="/mnt/your_1tb_disk/sqlite_temp" sqlite3.c -o sqlite3

关键注意事项 #

• 目标临时目录必须提前创建，并且SQLite进程拥有该目录的读写权限，否则会自动 fallback 到系统临时目录。
• 临时文件的体积可能和最终索引相当甚至更大（B-tree构建的中间文件），确保目标磁盘预留足够空间（建议比预估索引大小多20%余量）。
• 如果是通过编程语言的SQLite API操作（比如Python的sqlite3模块），同样可以先执行PRAGMA temp_store_directory语句，或者在启动程序前设置环境变量。

内容的提问来源于stack exchange，提问作者Haitham Fallatah