nodejs中mysql用法

超、凢脫俗 2022-07-28 09:58 208阅读 0赞

1、建立数据库连接：createConnection(Object)方法  
      该方法接受一个对象作为参数，该对象有四个常用的属性host，user，password，database。与php中链接数据库的参数相同。属性列表如下：

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.         host: 连接数据库所在的主机名. (默认: localhost)  
2.  port: 连接端口. (默认: 3306)  
3.  localAddress: 用于TCP连接的IP地址. (可选)  
4.  socketPath: 链接到unix域的路径。在使用host和port时该参数会被忽略.  
5.  user: MySQL用户的用户名.  
6.  password: MySQL用户的密码.  
7.  database: 链接到的数据库名称 (可选).  
8.  charset: 连接的字符集. (默认: 'UTF8\_GENERAL\_CI'.设置该值要使用大写!)  
9.  timezone: 储存本地时间的时区. (默认: 'local')  
10. stringifyObjects: 是否序列化对象. See issue \#501. (默认: 'false')  
11. insecureAuth: 是否允许旧的身份验证方法连接到数据库实例. (默认: **false**)  
12. typeCast: 确定是否讲column值转换为本地JavaScript类型列值. (默认: **true**)  
13. queryFormat: 自定义的查询语句格式化函数.  
14. supportBigNumbers: 数据库处理大数字(长整型和含小数),时应该启用 (默认: **false**).  
15. bigNumberStrings: 启用 supportBigNumbers和bigNumberStrings 并强制这些数字以字符串的方式返回(默认: **false**).   
16. dateStrings: 强制日期类型(TIMESTAMP, DATETIME, DATE)以字符串返回，而不是一javascript Date对象返回. (默认: **false**)  
17. debug: 是否开启调试. (默认: **false**)  
18. multipleStatements: 是否允许在一个query中传递多个查询语句. (Default: **false**)  
19. flags: 链接标志.

还可以使用字符串连接数据库例如：

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **var** connection = mysql.createConnection('mysql://user:pass@host/db?debug=true&charset=BIG5\_CHINESE\_CI&timezone=-0700');

2、结束数据库连接end()和destroy()  
 end()接受一个回调函数，并且会在query结束之后才触发，如果query出错，仍然会终止链接，错误会传递到回调函数中处理。

destroy()立即终止数据库连接，即使还有query没有完成，之后的回调函数也不会在触发。

3、创建连接池 createPool(Object)  Object和createConnection参数相同。  
可以监听connection事件，并设置session值

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  pool.on('connection', **function**(connection) \{  
2.          connection.query('SET SESSION auto\_increment\_increment=1')  
3.      \});

connection.release()释放链接到连接池。如果需要关闭连接并且删除，需要使用connection.destroy()  
 pool除了接受和connection相同的参数外，还接受几个扩展的参数

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  createConnection: 用于创建链接的函数. (Default: mysql.createConnection)  
2.      waitForConnections: 决定当没有连接池或者链接数打到最大值时pool的行为. 为**true**时链接会被放入队列中在可用是调用，为**false**时会立即返回error. (Default: **true**)  
3.      connectionLimit: 最大连接数. (Default: 10)  
4.      queueLimit: 连接池中连接请求的烈的最大长度，超过这个长度就会报错，值为0时没有限制. (Default: 0)

4、连接池集群  
 允许不同的host链接

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  // create  
2.      **var** poolCluster = mysql.createPoolCluster();  
3.    
4.      poolCluster.add(config); // anonymous group  
5.      poolCluster.add('MASTER', masterConfig);  
6.      poolCluster.add('SLAVE1', slave1Config);  
7.      poolCluster.add('SLAVE2', slave2Config);  
8.    
9.      // Target Group : ALL(anonymous, MASTER, SLAVE1-2), Selector : round-robin(default)  
10.     poolCluster.getConnection(**function** (err, connection) \{\});  
11.   
12.     // Target Group : MASTER, Selector : round-robin  
13.     poolCluster.getConnection('MASTER', **function** (err, connection) \{\});  
14.   
15.     // Target Group : SLAVE1-2, Selector : order  
16.     // If can't connect to SLAVE1, return SLAVE2. (remove SLAVE1 in the cluster)  
17.     poolCluster.on('remove', **function** (nodeId) \{  
18.       console.log('REMOVED NODE : ' + nodeId); // nodeId = SLAVE1   
19.     \});  
20.   
21.     poolCluster.getConnection('SLAVE\*', 'ORDER', **function** (err, connection) \{\});  
22.   
23.     // of namespace : of(pattern, selector)  
24.     poolCluster.of('\*').getConnection(**function** (err, connection) \{\});  
25.   
26.     **var** pool = poolCluster.of('SLAVE\*', 'RANDOM');  
27.     pool.getConnection(**function** (err, connection) \{\});  
28.     pool.getConnection(**function** (err, connection) \{\});  
29.   
30.     // destroy  
31.     poolCluster.end();

链接集群的可选参数

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  canRetry: 值为**true**时，允许连接失败时重试(Default: **true**)  
2.      removeNodeErrorCount: 当连接失败时 errorCount 值会增加. 当errorCount 值大于 removeNodeErrorCount 将会从PoolCluster中删除一个节点. (Default: 5)  
3.      defaultSelector: 默认选择器. (Default: RR)  
4.          RR: 循环. (Round-Robin)  
5.          RANDOM: 通过随机函数选择节点.  
6.          ORDER: 无条件地选择第一个可用节点.

5、切换用户/改变连接状态

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  Mysql允许在比断开连接的的情况下切换用户  
2.      connection.changeUser(\{user : 'john'\}, **function**(err) \{  
3.          **if** (err) **throw** err;  
4.      \});

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

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

6、处理服务器连接断开

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **var** db\_config = \{  
2.          host: 'localhost',  
3.          user: 'root',  
4.          password: '',  
5.          database: 'example'  
6.      \};  
7.    
8.      **var** connection;  
9.    
10.     **function** handleDisconnect() \{  
11.       connection = mysql.createConnection(db\_config); // Recreate the connection, since  
12.                                                       // the old one cannot be reused.  
13.   
14.       connection.connect(**function**(err) \{              // The server is either down  
15.         **if**(err) \{                                     // or restarting (takes a while sometimes).  
16.           console.log('error when connecting to db:', err);  
17.           setTimeout(handleDisconnect, 2000); // We introduce a delay before attempting to reconnect,  
18.         \}                                     // to avoid a hot loop, and to allow our node script to  
19.       \});                                     // process asynchronous requests in the meantime.  
20.                                               // If you're also serving http, display a 503 error.  
21.       connection.on('error', **function**(err) \{  
22.         console.log('db error', err);  
23.         **if**(err.code === 'PROTOCOL\_CONNECTION\_LOST') \{ // Connection to the MySQL server is usually  
24.           handleDisconnect();                         // lost due to either server restart, or a  
25.         \} **else** \{                                      // connnection idle timeout (the wait\_timeout  
26.           **throw** err;                                  // server variable configures this)  
27.         \}  
28.       \});  
29.     \}  
30.   
31.     handleDisconnect();

7、转义查询值

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

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

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **var** sorter = 'date';  
2.      **var** query = 'SELECT \* FROM posts ORDER BY ' + mysql.escapeId(sorter);  
3.    
4.      console.log(query); // SELECT \* FROM posts ORDER BY \`date\`  
5.      支持转义多个  
6.      **var** sorter = 'date';  
7.      **var** query = 'SELECT \* FROM posts ORDER BY ' + mysql.escapeId('posts.' + sorter);  
8.    
9.      console.log(query); // SELECT \* FROM posts ORDER BY \`posts\`.\`date\`  
10.     可以使用??作为标识符的占位符  
11.     **var** userId = 1;  
12.     **var** columns = \['username', 'email'\];  
13.     **var** query = connection.query('SELECT ?? FROM ?? WHERE id = ?', \[columns, 'users', userId\], **function**(err, results) \{  
14.       // ...  
15.     \});  
16.   
17.     console.log(query.sql); // SELECT \`username\`, \`email\` FROM \`users\` WHERE id = 1

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

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

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  connection.query('INSERT INTO posts SET ?', \{title: 'test'\}, **function**(err, result) \{  
2.        **if** (err) **throw** err;  
3.    
4.        console.log(result.insertId);  
5.      \});

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **var** query = connection.query('SELECT \* FROM posts');  
2.      query  
3.        .on('error', **function**(err) \{  
4.          // Handle error, an 'end' event will be emitted after this as well  
5.        \})  
6.        .on('fields', **function**(fields) \{  
7.          // the field packets for the rows to follow  
8.        \})  
9.        .on('result', **function**(row) \{  
10.         // Pausing the connnection is useful if your processing involves I/O  
11.         connection.pause();  
12.   
13.         processRow(row, **function**() \{  
14.           connection.resume();  
15.         \});  
16.       \})  
17.       .on('end', **function**() \{  
18.         // all rows have been received  
19.       \});

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

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

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **var** query = connection.query('SELECT 1; SELECT 2');  
2.    
3.      query  
4.        .on('fields', **function**(fields, index) \{  
5.          // the fields for the result rows that follow  
6.        \})  
7.        .on('result', **function**(row, index) \{  
8.          // index refers to the statement this result belongs to (starts at 0)  
9.        \});

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

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  connection.beginTransaction(**function**(err) \{  
2.        **if** (err) \{ **throw** err; \}  
3.        connection.query('INSERT INTO posts SET title=?', title, **function**(err, result) \{  
4.          **if** (err) \{   
5.            connection.rollback(**function**() \{  
6.              **throw** err;  
7.            \});  
8.          \}  
9.    
10.         **var** log = 'Post ' + result.insertId + ' added';  
11.   
12.         connection.query('INSERT INTO log SET data=?', log, **function**(err, result) \{  
13.           **if** (err) \{   
14.             connection.rollback(**function**() \{  
15.               **throw** err;  
16.             \});  
17.           \}    
18.           connection.commit(**function**(err) \{  
19.             **if** (err) \{   
20.               connection.rollback(**function**() \{  
21.                 **throw** err;  
22.               \});  
23.             \}  
24.             console.log('success!');  
25.           \});  
26.         \});  
27.       \});  
28.     \});

15、错误处理

**\[javascript\]**  [view plain][]  [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  err.code = string  
2.  err.fatal => **boolean**

更详细的说明请查看： [https://github.com/felixge/node-mysql][https_github.com_felixge_node-mysql]

[view plain]: http://blog.csdn.net/zxsrendong/article/details/17006185#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/91931
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/91931/fork
[https_github.com_felixge_node-mysql]: https://github.com/felixge/node-mysql