接口 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 查詢無效並且回調