-- 设置值
PRAGMA name = value;

-- 查询值
PRAGMA name;

-- 列表形式（部分 PRAGMA 支持）
PRAGMA pragma_list;

-- 查看当前模式
PRAGMA journal_mode;

-- 设置模式
PRAGMA journal_mode = DELETE;     -- 默认：事务后删除 journal
PRAGMA journal_mode = WAL;        -- 推荐：写前日志
PRAGMA journal_mode = MEMORY;     -- journal 保存在内存（不安全）
PRAGMA journal_mode = OFF;        -- 无 journal（不安全）
PRAGMA journal_mode = TRUNCATE;   -- 事务后截断 journal
PRAGMA journal_mode = PERSIST;    -- 事务后保留 journal（标记为无效）

PRAGMA synchronous;
PRAGMA synchronous = FULL;     -- 默认：每次提交都 fsync
PRAGMA synchronous = NORMAL;   -- WAL 模式下推荐
PRAGMA synchronous = OFF;      -- 最快，但崩溃可能丢数据
PRAGMA synchronous = EXTRA;    -- 比 FULL 更严格

-- ⚡ 高性能配置（WAL + NORMAL）
PRAGMA journal_mode = WAL;
PRAGMA synchronous = NORMAL;

-- 查看当前缓存大小
PRAGMA cache_size;

-- 设置缓存大小（单位：页）
PRAGMA cache_size = 10000;    -- 10000 页 × 4KB = ~40MB

-- 负值表示 KB
PRAGMA cache_size = -2000;    -- 约 2MB 缓存

-- 查看
PRAGMA mmap_size;

-- 设置（单位：字节）
PRAGMA mmap_size = 268435456;  -- 256MB

-- 关闭内存映射
PRAGMA mmap_size = 0;

-- 开启外键约束（默认关闭！）
PRAGMA foreign_keys = ON;

-- 查看状态
PRAGMA foreign_keys;  -- 0=关闭, 1=开启

-- 设置超时（毫秒）
PRAGMA busy_timeout = 5000;  -- 等待 5 秒

-- 查看
PRAGMA busy_timeout;

-- 表信息
PRAGMA table_info(users);
-- cid | name    | type    | notnull | dflt_value | pk
-- 0   | id      | INTEGER | 0       | NULL       | 1
-- 1   | name    | TEXT    | 1       | NULL       | 0
-- 2   | email   | TEXT    | 1       | NULL       | 0

-- 完整表信息（包含外键、CHECK 约束等）
PRAGMA table_xinfo(users);

-- 索引列表
PRAGMA index_list(users);
-- seq | name           | unique | origin | partial
-- 0   | sqlite_autoindex_users_1 | 1 | u | 0

-- 索引列信息
PRAGMA index_info(idx_users_email);

-- 外键信息
PRAGMA foreign_key_list(orders);
-- id | seq | table | from     | to   | on_update | on_delete | match
-- 0  | 0   | users | user_id  | id   | NO ACTION | CASCADE   | NONE

-- 页面大小
PRAGMA page_size;

-- 页面数量
PRAGMA page_count;

-- 空闲页面数量
PRAGMA freelist_count;

-- 数据库大小计算
SELECT
    page_count * page_size / 1024.0 AS size_kb,
    freelist_count * page_size / 1024.0 AS free_kb,
    (page_count - freelist_count) * page_size / 1024.0 AS used_kb
FROM pragma_page_count(), pragma_page_size(), pragma_freelist_count();

-- 数据库文件列表
PRAGMA database_list;
-- seq | name  | file
-- 0   | main  | /path/to/mydb.db
-- 2   | temp  |

-- 编译选项
PRAGMA compile_options;

-- 表的行数估算（快速）
PRAGMA stats;

-- B-Tree 深度和单元格信息
PRAGMA btree_info;  -- 需要特定编译选项

-- ⚡ 生产环境推荐配置
PRAGMA journal_mode = WAL;           -- WAL 模式
PRAGMA synchronous = NORMAL;          -- WAL 配合 NORMAL
PRAGMA cache_size = -2000;            -- 2MB 缓存
PRAGMA foreign_keys = ON;             -- 开启外键
PRAGMA busy_timeout = 5000;           -- 5 秒忙等待
PRAGMA wal_autocheckpoint = 1000;     -- WAL 自动 checkpoint
PRAGMA temp_store = MEMORY;           -- 临时表存内存
PRAGMA mmap_size = 268435456;         -- 256MB 内存映射

-- ⚡ 大量数据导入时的优化配置
PRAGMA journal_mode = WAL;
PRAGMA synchronous = OFF;            -- 临时关闭同步
PRAGMA cache_size = 100000;           -- 大缓存
PRAGMA temp_store = MEMORY;
PRAGMA locking_mode = EXCLUSIVE;      -- 独占锁
PRAGMA mmap_size = 536870912;         -- 512MB

BEGIN;
-- ... 大量 INSERT ...
COMMIT;

-- 恢复安全设置
PRAGMA synchronous = NORMAL;
PRAGMA locking_mode = NORMAL;

PRAGMA temp_store;       -- 0=DEFAULT, 1=FILE, 2=MEMORY
PRAGMA temp_store = MEMORY;  -- 临时表存内存（推荐）

PRAGMA locking_mode;        -- NORMAL（默认）
PRAGMA locking_mode = EXCLUSIVE;  -- 独占模式

-- 加密（仅 SQLCipher / SEE）
PRAGMA key = 'my-secret-key';
PRAGMA rekey = 'new-secret-key';

-- 忽略 CHECK 约束（危险！）
PRAGMA ignore_check_constraints = ON;

-- 信任外键约束的声明（不实际检查）
PRAGMA trusted_schema = ON;  -- 默认 ON

-- 快速检查（遇到第一个错误就停止）
PRAGMA quick_check;

-- 完整检查（检查所有页面）
PRAGMA integrity_check;

-- 只检查指定表
PRAGMA integrity_check(users);

-- 输出示例（正常）：
-- ok

-- 输出示例（异常）：
-- Page 123: invalid page type at offset 456

PRAGMA journal_mode = WAL;
PRAGMA synchronous = NORMAL;
PRAGMA cache_size = -4000;
PRAGMA foreign_keys = ON;
PRAGMA busy_timeout = 3000;
PRAGMA temp_store = MEMORY;

PRAGMA journal_mode = WAL;
PRAGMA synchronous = OFF;
PRAGMA locking_mode = EXCLUSIVE;
PRAGMA cache_size = 100000;

BEGIN;
-- ... 大量 INSERT ...
COMMIT;

PRAGMA synchronous = NORMAL;
PRAGMA locking_mode = NORMAL;