: 不输入: [DEPECATED] 节点- sqlite3
说明: 此寄存器目前尚未保存 。 我们将不更新其任何问题或撤回请求.
同步、无阻断 SQLite 3 请检查url=值 (帮助) 约束 节点.js。 。 。 .
特征
- 直向查询和参数绑定接口
- 全部缓冲/ Blob 支持
- 广泛 调试支持
- 查询序列化 API 密码
- 扩展支持,包括捆绑支持 json1 扩展
- 大测试套房
- 以现代 C++ 写并测试内存泄漏
- Bundles SQLite v3.51.3, 或者可以使用本地的 SQLite 构建
安装
你用得着 npm 或者说 yarn 要安装 sqlite3数字 :
- (建议)最新出版的套装:
npm install sqlite3
# or
yarn add sqlite3
- GitHub (英语)
master分支 :npm install https://github.com/tryghost/node-sqlite3/tarball/master
预建二进制
sqlite3 v5+ 被重写为使用 节点- API 因此,预建的二进制不需要为特定节点版本而构建. sqlite3 目前为节点-API v3和v6同时构建. 检查 节点- API 版本矩阵 以确保您的节点版本支持其中之一。 预建的二进制应在Node v20.17.0+上支持.
该模块使用 prebuild-install 以下载您平台的预建二进制,如果存在。 这些二进制在 GitHub Releases 为 sqlite3 超过5.0.2的版本,其主机为S3。 目前提供的目标如下:
darwin-arm64darwin-x64linux-arm64linux-x64linuxmusl-arm64linuxmusl-x64win32-x64
很遗憾, 预建 无法区分 armv6 财务报告和审定财务报表 armv7,转而使用 arm 作为 {arch}。在修复之前,您仍然需要安装 sqlite3 从 来源。 。 。 .
如果CI支持在其它平台和架构上更上一层楼,未来可能会增加对其他平台和架构的支持.
如果你的环境得不到支持,它就会用到 node-gyp 来构建 SQLite,但您需要安装 C++ 编译器和链接器.
其他安装方式
也有可能让自己的建筑 sqlite3 从源代码取出, 而不是它的 npm 包 (见下文.) (中文(简体) ).
这个 sqlite3 模块也与 节点- webkit 如果节点-webkit包含一个支持的Node.js引擎版本. (见下文)
SQLite 的游戏 SQLCipher 扩展名 也得到支持. (见下文)
API 密码
见 API 文档 在维基文库中.
使用量
说明: 模块必须是 已安装 在使用前使用.
const sqlite3 = require('sqlite3').verbose();
const db = new sqlite3.Database(':memory:');
db.serialize(() => {
db.run("CREATE TABLE lorem (info TEXT)");
const stmt = db.prepare("INSERT INTO lorem VALUES (?)");
for (let i = 0; i < 10; i++) {
stmt.run("Ipsum " + i);
}
stmt.finalize();
db.each("SELECT rowid AS id, info FROM lorem", (err, row) => {
console.log(row.id + ": " + row.info);
});
});
db.close();
源安装
跳过搜索预编译的二进制,并从源头强制构建,使用
npm install --build-from-source
Sqlite3模块仅依赖于libsqlite3. 然而,默认情况下,将构建一个内部/捆绑的sqlite副本并静态连接,因此不需要外部安装的sqlite3.
如果你想在外立方块上安装,则需要通过 --sqlite 参数到 npm 包装 :
npm install --build-from-source --sqlite=/usr/local
如果建筑物相对于外部的 sqlite 3 ,则确保开发标题可用. Mac OS X 的飞船,默认使用这些. 如果你没有安装,就安装 -dev 软件包与您的软件包管理器, 例如 . apt-get install libsqlite3-dev 为德比安/乌本图. 确定你至少拥有 libsqlite3 >= 3.6.
注意,如果在OS X上与土生土长安装的 sqlite 相对抗的建筑可以做到:
npm install --build-from-source --sqlite=/usr/local/opt/sqlite/
自定义文件头( magic)
默认 sqlite 文件头为"SQLite格式 3". 您可以指定一个不同的魔法, 虽然这将使标准的工具和库无法使用您的文件 .
npm install --build-from-source --sqlite_magic="MyCustomMagic15"
请注意,魔法 必须 字符长为15个(16个字节,包括无效的终止符).
节点-webkit大楼
因为ABI的不同, sqlite3 必须在习惯中构建,用于 节点- webkit。 。 。 .
要建设 sqlite3 节点- webkit :
-
安装
nw-gyp全球:npm install nw-gyp -g(除非已经安装) -
以自定义旗标构建模块
--runtime, (中文(简体) ),--target_arch,以及--target数字 :
NODE_WEBKIT_VERSION="0.8.6" # see latest version at https://github.com/rogerwang/node-webkit#downloads
npm install sqlite3 --build-from-source --runtime=node-webkit --target_arch=ia32 --target=$(NODE_WEBKIT_VERSION)
您也可以在内部运行此命令 sqlite3 退出 :
npm install --build-from-source --runtime=node-webkit --target_arch=ia32 --target=$(NODE_WEBKIT_VERSION)
请记住:
-
你必须提供权利
--target_arch旗帜.ia32需要瞄准32bit节点-webkit构建,同时x64将瞄准64bit节点-webkit构建(如果可供您的平台使用). -
之后
sqlite3为节点-webkit所建的软件包不能在vanilla Node.js中运行(反之亦然).- 譬如说,
npm test-webkit的软件包将失败.
- 譬如说,
访问“使用节点模块”节点-webkit的wiki中的文章,以了解更多细节.
SQLCipher大楼
关于建造SQLCipher的指示,见 用于节点的 SQLCipher 建筑或者,您可以用本地软件包管理器安装.
要对 SQLCipher 运行, 您需要编译 sqlite3 从源代码通过构建选项, 如:
npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/
node -e 'require("sqlite3")'
如果您的 SQLCipher 安装在一个自定义位置( 如果您自己编译并安装) , 您需要设置一些环境变量 :
在OS X与本乡人
设定位置 brew 安装它:
export LDFLAGS="-L`brew --prefix`/opt/sqlcipher/lib"
export CPPFLAGS="-I`brew --prefix`/opt/sqlcipher/include/sqlcipher"
npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=`brew --prefix`
node -e 'require("sqlite3")'
在大多数Linuxes上(包括Raspberry Pi)
设定位置 make 安装它:
export LDFLAGS="-L/usr/local/lib"
export CPPFLAGS="-I/usr/local/include -I/usr/local/include/sqlcipher"
export CXXFLAGS="$CPPFLAGS"
npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=/usr/local --verbose
node -e 'require("sqlite3")'
自定义构建与电子
运行 sqlite3 结束 电子重建 不保留 SQLCipher 扩展,所以需要一些额外的旗帜来使这种构建Electron兼容. npm install sqlite3 --build-from-source 命令需要这些额外的旗帜( 确保用您正在工作的当前电子版本替换目标版本 ):
--runtime=electron --target=18.2.1 --dist-url=https://electronjs.org/headers
对于与Homebrew的MacOS,命令应该看起来像如下:
npm install sqlite3 --build-from-source --sqlite_libname=sqlcipher --sqlite=`brew --prefix` --runtime=electron --target=18.2.1 --dist-url=https://electronjs.org/headers
测试
npm test
贡献者
- 丹尼尔·洛克尔
- 康斯坦丁·卡费尔
- 丹·斯普林迈尔
- 威尔怀特
- 奥兰多·巴斯克兹
- 阿尔泰姆·库斯蒂科夫
- 埃里克·弗雷德里克森
- 约翰·赖特
- 瑞安·达尔
- 汤姆·麦克赖特
- 卡特·塔克斯顿
- 奥德里乌斯·卡祖卡乌斯卡斯
- 约翰尼斯·绍尔
- 密斯高尔
- 邱德
承认
感谢 奥兰多·巴斯克兹, (中文(简体) ), 埃里克·弗雷德里克森 财务报告和审定财务报表 瑞安·达尔 他们的SQLite绑定节点, 和Meraleph 在Freenode的#v8 回答问题.
更改日志
我们用 GitHub 发布 关于最新版本的说明。 见 变动情况 有关旧版本的详细信息.
版权和许可证
版权 (c) 2013-2026 Mapbox & Ghost基金会
node-sqlite3 实值 BSD 许可。 。 。 .