DIV CSS 佈局教程網

Node.js 連線 MySQL:從安裝模組到建立資料庫的完整示例
編輯:關於JavaScript     

Node.js 因為事件驅動、非同步的特性,很適合拿來做輕量級的資料查詢服務。要讓它跟 MySQL 對話,第一步是安裝驅動模組。

安裝 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)以降低頻繁建連線的負擔。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved