// 免费工具

SQLite 连接字符串生成器

从文件路径为 Microsoft.Data.Sqlite、JDBC、SQLAlchemy、Python 和 Node 构建 SQLite 连接字符串;也可以粘贴 URI 文件名或数据源字符串,看看每个选项的作用。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。

在 SQLly 中打开此连接

打开 SQLly 的连接编辑器并自动填入内容。

从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。

SQLite 连接字符串格式

SQLite 的“连接字符串”基本就是一个文件路径,但每种封装的写法都不一样: Data Source=app.db 在 .NET 中, jdbc:sqlite:/path 在 Java 中, sqlite:////abs/path.db (四个斜杠) 在 SQLAlchemy 中。SQLite 自身的 URI 文件名(file:app.db?mode=ro)可以添加如只读模式之类的选项,但仅在调用方启用 URI 处理时生效。

文件路径 sqlite3 CLI、大多数驱动程序、SQLly

/var/data/app.db

URI 文件名(只读) SQLite URI 文件名

file:///var/data/app.db?mode=ro

ADO.NET Microsoft.Data.Sqlite、EF Core

Data Source=/var/data/app.db;Mode=ReadOnly

JDBC xerial sqlite-jdbc

jdbc:sqlite:/var/data/app.db

SQLAlchemy URL Python SQLAlchemy

sqlite:////var/data/app.db

占位符,例如 your_password 就是这样:用上面的表单自己拼一个连接字符串即可。更多关于将 SQLly 连接到 SQLite 的信息: SQLly 适用于 SQLite.

SQLite URI 文件名参数

方案是 file:;authority 必须为空或 localhost,因此 file:/abs/path, file:///abs/path 和 file://localhost/abs/path 都是同一个文件。在路径中编码 ? 作为 %3F 和 # 作为 %23 是在路径中进行的。URI 处理默认关闭:启用方式是 SQLITE_OPEN_URI, uri=True 在 Python 中,或你的封装库的等效选项。

关键字同义词默认作用
mode - rwc ro 只读, rw 读写(必须存在), rwc 读写创建, memory 内存中。
cache - 私有 shared 允许一个进程中的连接共享缓存。
immutable - 0 1 承诺文件永不改变:完全不加锁。一旦有人写入,读到的数据就可能损坏。
nolock - 0 1 禁用文件锁定。
vfs - 默认 VFS 要使用的 VFS 模块名称。
psow - build 默认值 断电安全覆盖。

Microsoft.Data.Sqlite 关键字

ADO.NET 风格。数据源也可以是 URI 文件名。

关键字同义词默认作用
Data Source DataSource,Filename 空(临时磁盘数据库) 文件路径, :memory:,或 URI 文件名。
Mode - ReadWriteCreate ReadWriteCreate, ReadWrite, ReadOnly, Memory.
Cache - 默认 Default, Private, Shared.
Password - - 发送 PRAGMA key;需要支持加密的构建,例如 SQLCipher。
Foreign Keys - 空(无 pragma) True 开启 PRAGMA foreign_keys.
Recursive Triggers - 假 PRAGMA recursive_triggers.
Default Timeout 命令超时 30 6.0+。秒数;也是数据库被锁定时的等待时长。
Pooling - 真 6.0+。连接池。

常见的 SQLite 连接错误

unable to open database file

原因: SQLITE_CANTOPEN: 目录不存在、进程无法写入该目录(SQLite 需要在数据库旁边创建日志文件)、相对路径解析到了意外的工作目录,或者 ~ 被使用(SQLite 不会展开它)。

修复: 请使用绝对路径,创建该目录,并为进程授予目录(而不仅是文件)的写权限。

database is locked

原因: SQLITE_BUSY:另一个连接持有写锁,而此连接等待时间不足。

修复: 设置繁忙超时(Default Timeout 在 Microsoft.Data.Sqlite 中, timeout 在 Python 中, busy_timeout pragma),保持写事务简短,并考虑 PRAGMA journal_mode=WAL 以便并发读取。

attempt to write a readonly database

原因: 此进程对该文件或其目录为只读,或者它是以 mode=ro / Mode=ReadOnly.

修复: 修复文件及其目录的权限,或以读写方式打开。

file is not a database

原因: SQLITE_NOTADB: 该文件不是 SQLite(例如是 DuckDB 文件)、用了你未提供的密钥加密,或者文件已损坏。

修复: 检查文件是什么类型(file app.db 在 macOS/Linux 上),并使用正确的引擎或密钥打开它。

SQLite 连接字符串常见问题解答

什么是 SQLite 连接字符串?

通常只是文件路径。在 .NET 中则是 Data Source=/path/app.db,在 Java 中 jdbc:sqlite:/path/app.db,在 SQLAlchemy 中 sqlite:////path/app.db 对于绝对路径 (sqlite:///app.db 则用于相对路径)。

如何以只读方式打开 SQLite 数据库?

使用 URI 文件名并搭配 mode=ro (file:/path/app.db?mode=ro,并启用了 URI 处理), Mode=ReadOnly 在 Microsoft.Data.Sqlite 中, open_mode=1 在 sqlite-jdbc 中,或者 readonly: true 在 better-sqlite3 中。

如何创建内存中的 SQLite 数据库?

使用 :memory: 作为路径。每个连接都会得到自己的私有数据库,除非你使用共享缓存 URI,例如 file::memory:?cache=shared.

为什么 SQLAlchemy 的 SQLite URL 里有四个斜杠?

sqlite:// 是协议和空主机名,第三个斜杠结束主机部分,其余是路径。绝对路径以自己的斜杠开头,所以 /var/data/app.db 变为 sqlite:////var/data/app.db.

// 完全跳过这些字符串

连接一次。之后只管写 SQL。

SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 SQLite 等引擎上获得模式感知的 IntelliSense。