nodejs中mysql用法

時間 2019-12-14

標籤 nodejs mysql 用法欄目 MySQL 简体版

原文原文鏈接

一、創建數據庫鏈接：createConnection(Object)方法
該方法接受一個對象做爲參數，該對象有四個經常使用的屬性host，user，password，database。與php中連接數據庫的參數相同。屬性列表以下：javascript

    host:　　　　　　 鏈接數據庫所在的主機名. (默認: localhost)
    port: 　　　　　　鏈接端口. (默認: 3306)
    localAddress: 　　用於TCP鏈接的IP地址. (可選)
    socketPath: 　　　　連接到unix域的路徑。在使用host和port時該參數會被忽略.
    user: 　　　　　　　　MySQL用戶的用戶名.
    password:　　　　 　　MySQL用戶的密碼.
    database: 　　　　　　連接到的數據庫名稱 (可選).
    charset: 　　　　　　鏈接的字符集. (默認: 'UTF8_GENERAL_CI'.設置該值要使用大寫!)
    timezone: 　　　　　　儲存本地時間的時區. (默認: 'local')
    stringifyObjects: 　　是否序列化對象. See issue #501. (默認: 'false')
    insecureAuth: 　　　　是否容許舊的身份驗證方法鏈接到數據庫實例. (默認: false)
    typeCast: 　　　　　　肯定是否講column值轉換爲本地JavaScript類型列值. (默認: true)
    queryFormat: 　　　　自定義的查詢語句格式化函數.
    supportBigNumbers: 數據庫處理大數字(長整型和含小數),時應該啓用 (默認: false).
    bigNumberStrings: 啓用 supportBigNumbers和bigNumberStrings 並強制這些數字以字符串的方式返回(默認: false). 
    dateStrings: 強制日期類型(TIMESTAMP, DATETIME, DATE)以字符串返回，而不是一javascript Date對象返回. (默認: false)
    debug: 是否開啓調試. (默認: false)
    multipleStatements: 是否容許在一個query中傳遞多個查詢語句. (Default: false)
    flags: 連接標誌.

還可使用字符串鏈接數據庫例如：php

var connection = mysql.createConnection('mysql://user:pass@host/db?debug=true&charset=BIG5_CHINESE_CI&timezone=-0700');

二、結束數據庫鏈接end()和destroy()
end()接受一個回調函數，而且會在query結束以後才觸發，若是query出錯，仍然會終止連接，錯誤會傳遞到回調函數中處理。java

destroy()當即終止數據庫鏈接，即便還有query沒有完成，以後的回調函數也不會在觸發。node

三、建立鏈接池 createPool(Object) Object和createConnection參數相同。
能夠監聽connection事件，並設置session值mysql

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

connection.release()釋放連接到鏈接池。若是須要關閉鏈接而且刪除，須要使用connection.destroy()
pool除了接受和connection相同的參數外，還接受幾個擴展的參數git

createConnection: 用於建立連接的函數. (Default: mysql.createConnection)
waitForConnections: 決定當沒有鏈接池或者連接數打到最大值時pool的行爲. 爲true時連接會被放入隊列中在可用是調用，爲false時會當即返回error. (Default: true)
connectionLimit: 最大鏈接數. (Default: 10)
queueLimit: 鏈接池中鏈接請求的烈的最大長度，超過這個長度就會報錯，值爲0時沒有限制. (Default: 0)

四、鏈接池集羣
容許不一樣的host連接github

// 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();

連接集羣的可選參數sql

canRetry: 值爲true時，容許鏈接失敗時重試(Default: true)
    removeNodeErrorCount: 當鏈接失敗時 errorCount 值會增長. 當errorCount 值大於 removeNodeErrorCount 將會從PoolCluster中刪除一個節點. (Default: 5)
    defaultSelector: 默認選擇器. (Default: RR)
        RR: 循環. (Round-Robin)
        RANDOM: 經過隨機函數選擇節點.
        ORDER: 無條件地選擇第一個可用節點.

五、切換用戶/改變鏈接狀態數據庫

Mysql容許在比斷開鏈接的的狀況下切換用戶
    connection.changeUser({user : 'john'}, function(err) {
          if (err) throw err;
    });

參數  
    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
      });

1三、混合查詢語句（多語句查詢）
由於混合查詢容易被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，整個查詢也會終止。
混合查詢結果的流處理方式是作實驗性的，不穩定。

1四、事務處理
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!');
          });
        });
      });
    });