接口 API#
https://github.com/TryGhost/node-sqlite3/wiki/API
注意:代码内即使不使用 callback
也不会让 API 变成同步调用。
new sqlite3.Database(filename [, mode] [, callback])
#
返回一个新的 Database 对象并自动打开该 Database 对象。
filename
:有效值是文件名。
-
mode
(可选):可选一个或多个sqlite3.OPEN_READONLY
,sqlite3.OPEN_READWRITE
,sqlite3.OPEN_CREATE
,sqlite3.OPEN_FULLMUTEX
,sqlite3.OPEN_URI
,sqlite3.OPEN_SHAREDCACHE
,sqlite3.OPEN_PRIVATECACHE
。初始值是OPEN_READWRITE | OPEN_CREATE | OPEN_FULLMUTEX
。 -
callback
(可选):如果提供了这个回调 (函数),那么无论数据库打开成功与否,该回调都会被调用。它的第一个实参是一个错误对象 (an Error Object),当该对象是null
的时候,数据库打开成功。如果该回调没有被提供,又在打开数据库时发生了错误,那么在这个数据库对象上,一个error
事件就会被调用,而且该 error 事件唯一的参数是错误对象。如果成功打开数据库,那么无论是否提供回调,一个没有任何参数的open
事件就会被调用。
sqlite3.verbose()
#
将执行模式设置为啰嗦模式 (verbose) 以生成长堆栈跟踪。没有任何办法去重置它。有关的更多信息,请参阅有关debugging的 wiki 页面。
数据库 Database#
close([callback])
#
关闭数据库
callback
(可选):如果提供了callback
,则无论数据库成功关闭与否,该函数都会被调用。它的第一个实参是一个错误对象 (an Error Object),当该对象是null
的时候,数据库关闭成功。如果该回调没有被提供,又在关闭数据库时发生了错误,那么在这个数据库对象上,一个error
事件就会被调用。如果成功关闭数据库,一个没有任何参数的close
事件就会被调用。
configure(option, value)
#
为数据库设置一个配置选项。有效选项有:
Tracing & profiling
- trace:提供了一个回调函数作为值。在执行 SQL 语句时调用,并呈现语句文本。
- profile:提供了一个回调函数作为值。每次执行 SQL 语句时调用。
- busyTimeout: 提供一个整数 (integer) 作为值。设置忙超时。
run(sql [, param, ...] [, callback])
#
使用指定的参数运行 sql 语句,并在之后调用回调。它并不会返回任何的结果。该函数返回一整个数据库对象 (Database Object)。以用在该数据库对象被调用时进行函数链接。
sql
:要执行的 SQL 语句。如果 sql 查询无效并且回调