toolkitbox/sqlite

SQLite3客户端

https://img.shields.io/github/stars/pabpereza/toolkitbox?style=flat&logo=github](https://github.com/pabpereza/toolkitbox) https://img.shields.io/github/issues/pabpereza/toolkitbox?style=flat&logo=github](https://github.com/pabpereza/toolkitbox/issues) https://img.shields.io/docker/pulls/toolkitbox/sqlite?logo=docker](https://hub.docker.com/r/toolkitbox/sqlite)

📢 发现问题或需请求新工具？ https://github.com/pabpereza/toolkitbox/issues

SQLite3的官方命令行界面，用于与SQLite数据库交互。

快速开始

Docker

bash
# 交互模式操作数据库文件
docker run -it --rm \
  -v $(pwd):/data \
  ghcr.io/pabpereza/toolkitbox/sqlite:latest \
  sqlite3 /data/mydatabase.db

# 执行单条查询
docker run --rm \
  -v $(pwd):/data \
  ghcr.io/pabpereza/toolkitbox/sqlite:latest \
  sqlite3 /data/mydatabase.db "SELECT * FROM users;"

# 创建内存数据库用于测试
docker run -it --rm \
  ghcr.io/pabpereza/toolkitbox/sqlite:latest \
  sqlite3 :memory:

Kubernetes

yaml
apiVersion: v1
kind: Pod
metadata:
  name: sqlite-client
spec:
  containers:
  - name: sqlite-client
    image: ghcr.io/pabpereza/toolkitbox/sqlite:latest
    command: ["sleep", "infinity"]
    volumeMounts:
    - name: data
      mountPath: /data
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: sqlite-data

镜像概述

SQLite3 (sqlite3) 是SQLite数据库的官方命令行工具，支持创建、查询、管理SQLite数据库文件，执行SQL命令，以及数据导入/导出等操作，是DevOps场景下轻量级数据库管理的常用工具。

核心功能

1. 创建、打开或删除SQLite数据库
2. 执行SQL语句（增删改查）
3. 数据导入（CSV等格式）与导出（CSV、SQL dump等）
4. 数据库 schema 检查与管理
5. 支持内存数据库用于快速测试
6. 多种输出模式（CSV、JSON、列格式等）

使用场景

• 本地开发与测试：快速创建和操作SQLite数据库
• 数据备份与恢复：生成SQL dump文件或从dump恢复数据库
• K8s环境：在容器化环境中临时连接或管理SQLite数据库
• 数据转换：将SQLite数据导出为CSV或JSON格式

配置说明

数据卷挂载

通过-v $(pwd):/data将本地目录挂载到容器内的/data路径，便于操作本地数据库文件。

命令参数

• -readonly：以只读模式打开数据库
• -header：显示列头
• -csv：以CSV格式输出结果
• -json：以JSON格式输出结果
• -cmd：执行命令后读取标准输入

基本用法

打开或创建数据库

bash
sqlite3 mydatabase.db

只读模式打开数据库

bash
sqlite3 -readonly mydatabase.db

执行命令后退出

bash
sqlite3 mydatabase.db "SELECT * FROM users;"

执行SQL文件

bash
sqlite3 mydatabase.db < script.sql

使用内存数据库

bash
sqlite3 :memory:

常用命令

表操作

sql
-- 创建表
CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT UNIQUE
);

-- 插入数据
INSERT INTO users (name, email) VALUES ('John', 'john@example.com');

-- 查询数据
SELECT * FROM users;

-- 更新数据
UPDATE users SET name = 'Jane' WHERE id = 1;

-- 删除数据
DELETE FROM users WHERE id = 1;

Schema检查

sql
-- 显示所有表
.tables

-- 显示表结构
.schema users

-- 查看表信息
PRAGMA table_info(users);

-- 显示所有索引
.indexes

数据导入/导出

bash
# 导出为CSV
sqlite3 -header -csv mydatabase.db "SELECT * FROM users;" > users.csv

# 从CSV导入
sqlite3 mydatabase.db
.mode csv
.import users.csv users

# 导出数据库为SQL dump
sqlite3 mydatabase.db .dump > backup.sql

# 从SQL dump恢复
sqlite3 newdatabase.db < backup.sql

常用选项

Dot命令

bash
# 显示帮助
.help

# 显示表
.tables

# 显示schema
.schema

# 切换输出模式
.mode csv
.mode json
.mode column
.mode line

# 启用列头
.headers on

# 打开另一个数据库
.open another.db

# 附加数据库
ATTACH DATABASE 'other.db' AS other;

# 显示当前设置
.show

# 退出
.exit

输出模式

bash
# CSV格式
.mode csv
SELECT * FROM users;

# JSON格式
.mode json
SELECT * FROM users;

# 列格式（美观表格）
.mode column
.headers on
SELECT * FROM users;

# 行格式（每行一个值）
.mode line
SELECT * FROM users;

官方文档

• https://www.sqlite.org/cli.html
• https://www.sqlite.org/lang.html