Node.js 因為事件驅動、非同步的特性,很適合拿來做輕量級的資料查詢服務。要讓它跟 MySQL 對話,第一步是安裝驅動模組。
$ npm install mysql
接著建立一支名為 mysqlTest.js 的腳本,把連線資訊、建庫建表、寫入與查詢一次跑過。
// mysqlTest.js
// 載入 mysql Module
var Client = require('mysql').Client,
client = new Client(),
TEST_DATABASE = 'nodejs_mysql_test', // 要建立的資料庫名
TEST_TABLE = 'test'; // 要建立的表名
client.user = 'root'; // 使用者名稱
client.password = 'root'; // 密碼
client.connect(); // 建立連線
client.query('CREATE DATABASE ' + TEST_DATABASE, function(err) {
if (err && err.number != Client.ERROR_DB_CREATE_EXISTS) {
throw err;
}
});
// 若未提供 callback,錯誤會以 'error' 事件形式由 client 拋出
client.query('USE ' + TEST_DATABASE);
這裡的 ERROR_DB_CREATE_EXISTS 判斷很重要:資料庫已存在不該被視為致命錯誤,否則第二次執行腳本就會直接中斷。
client.query( 'CREATE TABLE ' + TEST_TABLE + '(id INT(11) AUTO_INCREMENT, ' + 'title VARCHAR(255), ' + 'text TEXT, ' + 'created DATETIME, ' + 'PRIMARY KEY (id))' ); client.query( 'INSERT INTO ' + TEST_TABLE + ' ' + 'SET title = ?, text = ?, created = ?', ['super cool', 'this is a nice text', '2010-08-16 10:00:23'] ); var query = client.query( 'INSERT INTO ' + TEST_TABLE + ' ' + 'SET title = ?, text = ?, created = ?', ['another entry', 'because 2 entries make a better test', '2010-08-16 12:42:15'] );
注意每一段 SQL 中的 ? 佔位符:值透過陣列傳入,由驅動程式負責跳脫處理,這是防止 SQL Injection 的標準做法,不要用字串相加的方式拼 SQL。
client.query(
'SELECT * FROM ' + TEST_TABLE,
function selectCb(err, results, fields) {
if (err) {
throw err;
}
console.log(results); // 查詢結果的資料列
console.log(fields); // 欄位的中繼資料
client.end(); // 關閉連線
}
);
非同步的 callback 裡同時拿到了 results(資料)與 fields(欄位資訊),最後務必呼叫 client.end(),否則 Node 行程不會結束。
root@sammor-desktop:/var/iapps/nodejs/work# node mysqlTest.js
這支腳本示範的是最原始的 callback 寫法,容易陷入巢狀地獄。實務上可以改用 Promise 包裝,或採用 mysql2/promise 搭配 async/await,程式會扁平很多。此外,連線資訊應放在環境變數而非寫死在原始碼中,並建議使用連線池(createPool)以降低頻繁建連線的負擔。