HTML5 Web SQL 資料庫

Web SQL 資料庫 API 並不是 HTML5 規範的一部分,但是它是一個獨立的規範,引入了一組使用 SQL 操作客戶端資料庫的 APIs。

如果你是一個 Web 後端程式員,應該很容易理解 SQL 的操作。

你也可以參考我們的 SQL 教學,瞭解更多數據庫操作知識。

Web SQL 資料庫可以在最新版的 Safari, Chrome 和 Opera 流覽器中工作。


核心方法

以下是規範中定義的三個核心方法:

  1. openDatabase:這個方法使用現有的資料庫或者新建的資料庫創建一個資料庫對象。
  2. transaction:這個方法讓我們能夠控制一個事務,以及基於這種情況執行提交或者回滾。
  3. executeSql:這個方法用於執行實際的 SQL 查詢。

打開資料庫

我們可以使用 openDatabase() 方法來打開已存在的資料庫,如果資料庫不存在,則會創建一個新的資料庫,使用代碼如下:

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);

openDatabase() 方法對應的五個參數說明:

  1. 資料庫名稱
  2. 版本號
  3. 描述文本
  4. 資料庫大小
  5. 創建回調

第五個參數,創建回調會在創建資料庫後被調用。


執行查詢操作

執行操作使用 database.transaction() 函數:

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); });

上面的語句執行後會在 'mydb' 資料庫中創建一個名為 LOGS 的表。


插入數據

在執行上面的創建表語句後,我們可以插入一些數據:

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "IT研修")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "www.xuhuhu.com")'); });

我們也可以使用動態值來插入數據:

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id,log) VALUES (?, ?)', [e_id, e_log]); });

實例中的 e_id 和 e_log 是外部變數,executeSql 會映射數組參數中的每個條目給 "?"。


讀取數據

以下實例演示了如何讀取資料庫中已經存在的數據:

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "IT研修")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "www.xuhuhu.com")'); }); db.transaction(function (tx) { tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) { var len = results.rows.length, i; msg = "<p>查詢記錄條數: " + len + "</p>"; document.querySelector('#status').innerHTML += msg; for (i = 0; i < len; i++){ alert(results.rows.item(i).log ); } }, null); });

完整實例

實例

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); var msg; db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "IT研修")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "www.xuhuhu.com")'); msg = '<p>數據表已創建,且插入了兩條數據。</p>'; document.querySelector('#status').innerHTML = msg; }); db.transaction(function (tx) { tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) { var len = results.rows.length, i; msg = "<p>查詢記錄條數: " + len + "</p>"; document.querySelector('#status').innerHTML += msg; for (i = 0; i < len; i++){ msg = "<p><b>" + results.rows.item(i).log + "</b></p>"; document.querySelector('#status').innerHTML += msg; } }, null); });

以上實例運行結果如下圖所示:


刪除記錄

刪除記錄使用的格式如下:

db.transaction(function (tx) {
    tx.executeSql('DELETE FROM LOGS  WHERE id=1');
});

刪除指定的數據id也可以是動態的:

db.transaction(function(tx) {
    tx.executeSql('DELETE FROM LOGS WHERE id=?', [id]);
});

更新記錄

更新記錄使用的格式如下:

db.transaction(function (tx) {
    tx.executeSql('UPDATE LOGS SET log=\'www.xuhuhu.com\' WHERE id=2');
});

更新指定的數據id也可以是動態的:

db.transaction(function(tx) {
    tx.executeSql('UPDATE LOGS SET log=\'www.xuhuhu.com\' WHERE id=?', [id]);
});

完整實例

實例

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); var msg; db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "IT研修")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "www.xuhuhu.com")'); msg = '<p>數據表已創建,且插入了兩條數據。</p>'; document.querySelector('#status').innerHTML = msg; }); db.transaction(function (tx) { tx.executeSql('DELETE FROM LOGS WHERE id=1'); msg = '<p>刪除 id 為 1 的記錄。</p>'; document.querySelector('#status').innerHTML = msg; }); db.transaction(function (tx) { tx.executeSql('UPDATE LOGS SET log=\'www.xuhuhu.com\' WHERE id=2'); msg = '<p>更新 id 為 2 的記錄。</p>'; document.querySelector('#status').innerHTML = msg; }); db.transaction(function (tx) { tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) { var len = results.rows.length, i; msg = "<p>查詢記錄條數: " + len + "</p>"; document.querySelector('#status').innerHTML += msg; for (i = 0; i < len; i++){ msg = "<p><b>" + results.rows.item(i).log + "</b></p>"; document.querySelector('#status').innerHTML += msg; } }, null); });

以上實例運行結果如下圖所示: