Node.js_node.js で JavaScript を使用して MySQL を操作するための一般的な方法

1. データベース接続を確立します: createConnection(Object) メソッド
このメソッドはオブジェクトをパラメータとして受け取ります。オブジェクトには、ホスト、ユーザー、パスワード、データベースという 4 つの一般的に使用される属性があります。 phpのデータベースリンクと同じパラメータ。属性リストは次のとおりです:

• host: データベースが接続されているホスト名 (デフォルト: localhost)
• ポート: 接続ポート (デフォルト: 3306)
• localAddress: TCP 接続に使用される IP アドレス (オプション)
• socketPath: UNIX ドメインへのパス。ホストとポートを使用する場合、このパラメータは無視されます。
user: MySQL ユーザー
• のユーザー名。
パスワード: MySQL ユーザーのパスワード
• 。
database: リンク先のデータベースの名前 (オプション)。
• charset: 接続の文字セット (デフォルト: 'UTF8_GENERAL_CI'。この値を設定する場合は大文字を使用してください。)
• timezone: 現地時間が保存されるタイムゾーン (デフォルト: 'local')
• stringifyObjects: オブジェクトをシリアル化するかどうか。問題 #501 を参照してください (デフォルト: 'false')
• insecureAuth: 古い認証方法によるデータベース インスタンスへの接続を許可するかどうか (デフォルト: false)
• typeCast: 列値をネイティブ JavaScript 型の列値に変換するかどうかを決定します (デフォルト: true)
。
• queryFormat: カスタムクエリステートメントの書式設定関数
• supportBigNumbers: データベースが大きな数値 (長整数と小数) を処理する場合、これを有効にする必要があります (デフォルト: false)。
bigNumberStrings: supportBigNumbers と bigNumberStrings を有効にし、これらの数値が文字列として返されるようにします (デフォルト: false)。
• dateStrings: 日付タイプ (TIMESTAMP、DATETIME、DATE) を JavaScript Date オブジェクトではなく文字列として強制的に返します (デフォルト: false)
。
• debug: デバッグを有効にするかどうか (デフォルト: false)
• multipleStatements: 1 つのクエリで複数のクエリ ステートメントを渡すことを許可するかどうか (デフォルト: false)
• フラグ:
をリンクします。
文字列を使用してデータベースに接続することもできます。例:

コードをコピーします

コードは次のとおりです: var connection = mysql.createConnection('mysql://user:pass@host/db?debug=true&charset=BIG5_CHINESE_CI&timezone=-0700');

2. データベース接続を終了します end() および destroy()

end() はコールバック関数を受け入れ、クエリの終了後にトリガーされます。クエリにエラーがある場合でも、リンクは終了し、エラーは処理のためにコールバック関数に渡されます。
destroy() は、クエリが完了していない場合でも、データベース接続を即座に終了します。後続のコールバック関数はトリガーされません。
3. 接続プールを作成します createPool(Object)

Object パラメーターと createConnection パラメーターは同じです。 接続イベントをリッスンしてセッション値を設定できます

connection.release() は、接続プールへの接続を解放します。接続を閉じて削除する必要がある場合は、connection.destroy()

を使用する必要があります。 接続と同じパラメータを受け入れることに加えて、プールはいくつかの拡張パラメータも受け入れます

pool.on('connection', function(connection) { 
    connection.query('SET SESSION auto_increment_increment=1') 
  }); 

createConnection: リンクの作成に使用される関数 (デフォルト: mysql.createConnection)

WaitForConnections: 接続プールがない場合、または接続数が最大に達した場合のプールの動作を決定します。 true の場合、接続はキューに入れられ、利用可能なときに呼び出されます。 false の場合、エラーが発生します。すぐに返されます (デフォルト: true)
ConnectionLimit: 最大接続数 (デフォルト: 10)

QueueLimit: 接続プール内の接続リクエストの最大長。値が 0 の場合、制限はありません。

4. 接続プールクラスター

異なるホストリンクを許可する

クラスターをリンクするためのオプションのパラメーター

// create 
  var poolCluster = mysql.createPoolCluster(); 
 
  poolCluster.add(config); // anonymous group 
  poolCluster.add('MASTER', masterConfig); 
  poolCluster.add('SLAVE1', slave1Config); 
  poolCluster.add('SLAVE2', slave2Config); 
 
  // Target Group : ALL(anonymous, MASTER, SLAVE1-2), Selector : round-robin(default) 
  poolCluster.getConnection(function (err, connection) {}); 
 
  // Target Group : MASTER, Selector : round-robin 
  poolCluster.getConnection('MASTER', function (err, connection) {}); 
 
  // Target Group : SLAVE1-2, Selector : order 
  // If can't connect to SLAVE1, return SLAVE2. (remove SLAVE1 in the cluster) 
  poolCluster.on('remove', function (nodeId) { 
   console.log('REMOVED NODE : ' + nodeId); // nodeId = SLAVE1  
  }); 
 
  poolCluster.getConnection('SLAVE*', 'ORDER', function (err, connection) {}); 
 
  // of namespace : of(pattern, selector) 
  poolCluster.of('*').getConnection(function (err, connection) {}); 
 
  var pool = poolCluster.of('SLAVE*', 'RANDOM'); 
  pool.getConnection(function (err, connection) {}); 
  pool.getConnection(function (err, connection) {}); 
 
  // destroy 
  poolCluster.end(); 

canRetry: 値が true の場合、接続が失敗した場合に再試行が許可されます (デフォルト: true)

deleteNodeErrorCount: 接続が失敗すると、errorCount 値が増加します。errorCount 値がremoveNodeErrorCount より大きい場合、ノードは PoolCluster から削除されます (デフォルト: 5)。

defaultSelector: デフォルトのセレクター (デフォルト: RR)

RR: ループ (ラウンドロビン)

ランダム: ランダム関数を通じてノードを選択します。
ORDER: 最初の使用可能なノードを無条件に選択します。
• 5. ユーザーの切り替え/接続状態の変更
Mysql では切断せずにユーザーを切り替えることができます

参数  

•     user: 新的用户 (默认为早前的一个). 
•     password: 新用户的新密码 (默认为早前的一个). 
•     charset: 新字符集 (默认为早前的一个). 
•     database: 新数据库名称 (默认为早前的一个). 

六、处理服务器连接断开

var db_config = { 
    host: 'localhost', 
    user: 'root', 
    password: '', 
    database: 'example' 
  }; 
 
  var connection; 
 
  function handleDisconnect() { 
   connection = mysql.createConnection(db_config); // Recreate the connection, since 
                           // the old one cannot be reused. 
 
   connection.connect(function(err) {       // The server is either down 
    if(err) {                   // or restarting (takes a while sometimes). 
     console.log('error when connecting to db:', err); 
     setTimeout(handleDisconnect, 2000); // We introduce a delay before attempting to reconnect, 
    }                   // to avoid a hot loop, and to allow our node script to 
   });                   // process asynchronous requests in the meantime. 
                       // If you're also serving http, display a 503 error. 
   connection.on('error', function(err) { 
    console.log('db error', err); 
    if(err.code === 'PROTOCOL_CONNECTION_LOST') { // Connection to the MySQL server is usually 
     handleDisconnect();             // lost due to either server restart, or a 
    } else {                   // connnection idle timeout (the wait_timeout 
     throw err;                 // server variable configures this) 
    } 
   }); 
  } 
 
  handleDisconnect(); 

七、转义查询值
为了避免SQL注入攻击，需要转义用户提交的数据。可以使用connection.escape() 或者 pool.escape()
例如：

var userId = 'some user provided value'; 
  var sql  = 'SELECT * FROM users WHERE id = ' + connection.escape(userId); 
  connection.query(sql, function(err, results) { 
   // ... 
  }); 
  或者使用？作为占位符 
  connection.query('SELECT * FROM users WHERE id = ?', [userId], function(err, results) { 
   // ... 
  }); 
  不同类型值的转换结果 
  Numbers 不变 
  Booleans 转换为字符串 'true' / 'false'  
  Date 对象转换为字符串 'YYYY-mm-dd HH:ii:ss' 
  Buffers 转换为是6进制字符串 
  Strings 不变 
  Arrays => ['a', 'b'] 转换为 'a', 'b' 
  嵌套数组 [['a', 'b'], ['c', 'd']] 转换为 ('a', 'b'), ('c', 'd') 
  Objects 转换为 key = 'val' pairs. 嵌套对象转换为字符串. 
  undefined / null ===> NULL 
  NaN / Infinity 不变. MySQL 不支持这些值, 除非有工具支持，否则插入这些值会引起错误. 
  转换实例： 
  var post = {id: 1, title: 'Hello MySQL'}; 
  var query = connection.query('INSERT INTO posts SET ?', post, function(err, result) { 
   // Neat! 
  }); 
  console.log(query.sql); // INSERT INTO posts SET `id` = 1, `title` = 'Hello MySQL' 

    或者手动转换  

  var query = "SELECT * FROM posts WHERE title=" + mysql.escape("Hello MySQL"); 
 
  console.log(query); // SELECT * FROM posts WHERE title='Hello MySQL' 

八、转换查询标识符
如果不能信任SQL标识符(数据库名、表名、列名)，可以使用转换方法mysql.escapeId(identifier)；

var sorter = 'date'; 
  var query = 'SELECT * FROM posts ORDER BY ' + mysql.escapeId(sorter); 
 
  console.log(query); // SELECT * FROM posts ORDER BY `date` 
  支持转义多个 
  var sorter = 'date'; 
  var query = 'SELECT * FROM posts ORDER BY ' + mysql.escapeId('posts.' + sorter); 
 
  console.log(query); // SELECT * FROM posts ORDER BY `posts`.`date` 
  可以使用??作为标识符的占位符 
  var userId = 1; 
  var columns = ['username', 'email']; 
  var query = connection.query('SELECT ?? FROM ?? WHERE id = ?', [columns, 'users', userId], function(err, results) { 
   // ... 
  }); 
 
  console.log(query.sql); // SELECT `username`, `email` FROM `users` WHERE id = 1 

九、准备查询
可以使用mysql.format来准备查询语句，该函数会自动的选择合适的方法转义参数。

var sql = "SELECT * FROM ?? WHERE ?? = ?"; 
  var inserts = ['users', 'id', userId]; 
  sql = mysql.format(sql, inserts); 
  10、自定义格式化函数 
  connection.config.queryFormat = function (query, values) { 
   if (!values) return query; 
   return query.replace(/\:(\w+)/g, function (txt, key) { 
    if (values.hasOwnProperty(key)) { 
     return this.escape(values[key]); 
    } 
    return txt; 
   }.bind(this)); 
  }; 
 
  connection.query("UPDATE posts SET title = :title", { title: "Hello MySQL" }); 

十、获取插入行的id
当使用自增主键时获取插入行id，如：

connection.query('INSERT INTO posts SET ?', {title: 'test'}, function(err, result) { 
   if (err) throw err; 
 
   console.log(result.insertId); 
  }); 

十一、流处理
有时你希望选择大量的行并且希望在数据到达时就处理他们，你就可以使用这个方法

var query = connection.query('SELECT * FROM posts'); 
  query 
   .on('error', function(err) { 
    // Handle error, an 'end' event will be emitted after this as well 
   }) 
   .on('fields', function(fields) { 
    // the field packets for the rows to follow 
   }) 
   .on('result', function(row) { 
    // Pausing the connnection is useful if your processing involves I/O 
    connection.pause(); 
 
    processRow(row, function() { 
     connection.resume(); 
    }); 
   }) 
   .on('end', function() { 
    // all rows have been received 
   }); 

十二、混合查询语句（多语句查询）
 因为混合查询容易被SQL注入攻击，默认是不允许的，可以使用var connection = mysql.createConnection({multipleStatements: true});开启该功能。
 混合查询实例：

connection.query('SELECT 1; SELECT 2', function(err, results) { 
   if (err) throw err; 
 
   // `results` is an array with one element for every statement in the query: 
   console.log(results[0]); // [{1: 1}] 
   console.log(results[1]); // [{2: 2}] 
  }); 

同样可以使用流处理混合查询结果：

var query = connection.query('SELECT 1; SELECT 2'); 
 
  query 
   .on('fields', function(fields, index) { 
    // the fields for the result rows that follow 
   }) 
   .on('result', function(row, index) { 
    // index refers to the statement this result belongs to (starts at 0) 
   }); 

如果其中一个查询语句出错，Error对象会包含err.index指示错误语句的id，整个查询也会终止。
混合查询结果的流处理方式是做实验性的，不稳定。

十三、事务处理
connection级别的简单事务处理

connection.beginTransaction(function(err) { 
   if (err) { throw err; } 
   connection.query('INSERT INTO posts SET title=?', title, function(err, result) { 
    if (err) {  
     connection.rollback(function() { 
      throw err; 
     }); 
    } 
 
    var log = 'Post ' + result.insertId + ' added'; 
 
    connection.query('INSERT INTO log SET data=?', log, function(err, result) { 
     if (err) {  
      connection.rollback(function() { 
       throw err; 
      }); 
     }  
     connection.commit(function(err) { 
      if (err) {  
       connection.rollback(function() { 
        throw err; 
       }); 
      } 
      console.log('success!'); 
     }); 
    }); 
   }); 
  }); 

十四、错误处理

err.code = string 
err.fatal => boolean 

PS：使用mysql模块时遇到的坑
之前写了个小程序Node News，用到了MySQL数据库，在本地测试均没神马问题。放上服务器运行一段时间后，偶然发现打开页面的时候页面一直处于等待状态，直到Nginx返回超时错误。于是上服务器检查了遍，发现程序仍然在运行，且能正确记录每次的请求，再修改代码跟踪调试，原来是在查询数据库的时候，回调一直没有被执行，程序就挂在那里了。

想了很久也想不明白为神马mysql模块没有执行回调，最后突然想起来去看了下错误日志，才发现有个“No reconnection after connection lost”错误没有被捕捉到，原来是连接丢失了，上github上看了下文档和issues，上面说到连接丢失后不会自动重新连接，会触发error事件。我赶紧给程序添加了断线后自动重连功能，现在已正常运行了10多天。

MySQL中有一个名叫wait_timeout的变量，表示操作超时时间，当连接超过一定时间没有活动后，会自动关闭该连接，这个值默认为28800（即8小时）。

自动重连数据库的代码：

function handleError (err) {
 if (err) {
  // 如果是连接断开，自动重新连接
  if (err.code === 'PROTOCOL_CONNECTION_LOST') {
   connect();
  } else {
   console.error(err.stack || err);
  }
 }
}

// 连接数据库
function connect () {
 db = mysql.createConnection(config);
 db.connect(handleError);
 db.on('error', handleError);
}

var db;
connect();

网上流传的大多数使用mysql模块的代码，往往忽略了这个问题，一不小心就让一拨又一拨的人往坑里踩了。
有童鞋回复问使用pool又会怎样，于是去看了下mysql模块的源码：目前可在npm中安装到的最新版本为2.0.0-alpha7，使用mysql.createPool()来创建的pool没办法自动处理连接被关闭的问题，但是在github上的版本已经修复了（应该还没发布到npm上），当触发了connection的error事件时，会把该connection对象从连接池中移除。（源码：https://github.com/felixge/node-mysql/blob/master/lib/Pool.js#L119 ）
使用pool的代码：

var mysql = require('mysql');
var pool = mysql.createPool(config);

pool.getConnection(function(err, connection) {
 // Use the connection
 connection.query( 'SELECT something FROM sometable', function(err, rows) {
  // And done with the connection.
  connection.end();

  // Don't use the connection here, it has been returned to the pool.
 });
});