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