Nodejs使用mysql2操作数据库【完整讲解】

mysql2 相比于 mysql 的优势

mysql2 是一个基于 Node.js 的 MySQL 客户端库，相比于 mysql 库，它具有以下几个优势：

性能更好：mysql2 库在性能方面进行了优化，使用了更高效的底层实现。它使用了更快的连接池管理和查询执行机制，可以处理更高的并发请求，提供更好的性能表现。

支持 Promise 和 async/await：mysql2 库原生支持 Promise 和 async/await，使得编写异步代码更加方便和直观。您可以使用 promise().query() 方法执行查询，并使用 await 关键字等待查询结果。

支持流式查询：mysql2 库支持流式查询，可以通过创建可读流来处理大型查询结果集。这对于处理大量数据或需要逐行处理结果的情况非常有用，可以减少内存占用并提高性能。

更好的错误处理：mysql2 库提供了更好的错误处理机制，可以更详细地捕获和处理数据库操作中的错误。它返回的错误对象包含更多有用的信息，如 SQL 语句、错误代码和错误堆栈等，有助于更好地调试和排查问题。

支持预处理语句：mysql2 库支持预处理语句，可以使用占位符来安全地构建和执行 SQL 查询。这可以防止 SQL 注入攻击，并提高应用程序的安全性。

安装

npm install mysql2

连接数据库

要使用 mysql2 连接到 MySQL 数据库，您需要安装 mysql2 包，并使用适当的连接参数来创建连接。以下是一个示例，展示了如何使用 mysql2 连接到 MySQL 数据库：

const mysql = require("mysql2");// 创建数据库连接const connection = mysql.createConnection({  host: "localhost", // 主机地址  user: "root", // 用户名  password: "password", // 密码  port: 3306, // 端口号，默认为 3306  database: "mydatabase", // 数据库名称  charset: "UTF8_GENERAL_CI", // 连接字符集，默认为 UTF8_GENERAL_CI  connectTimeout: 10000, // 连接超时时间，单位为毫秒  multipleStatements: false // 是否允许一个 query 中有多个 MySQL 语句，默认为 false});// 连接到数据库connection.connect((err) => {  if (err) {    console.error("Error connecting to database:", err);    return;  }  console.log("Connected to database");    // 在这里执行数据库操作});// 在数据库连接关闭时触发connection.on("end", () => {  console.log("Database connection closed");});// 在发生错误时触发connection.on("error", (err) => {  console.error("Database error:", err);});// 关闭数据库连接connection.end();

在这个示例中，我们使用 mysql.createConnection() 方法创建了一个数据库连接，并传递了连接参数（主机名、用户名、密码和数据库名称）。然后，我们使用 connection.connect() 方法来连接到数据库。

在连接成功后，您可以在回调函数中执行数据库操作。在这个示例中，我们只是简单地输出连接成功的消息，但您可以在这里执行任何数据库操作，如查询、插入、更新等。

请注意，为了确保数据库连接的正确关闭，我们监听了 end 事件，并在事件处理程序中关闭了连接。此外，我们还监听了 error 事件，以处理可能发生的数据库错误。

最后，我们使用 connection.end() 方法来关闭数据库连接。

请根据您的实际情况修改连接参数，以适应您的 MySQL 数据库的配置。

通过 query() 方法执行SQL语句

连接数据库之后，可以使用query()方法对数据库进行增删改查操作。

具体的语法格式：connection.query(sql,params,callback),以下是对 query() 方法的参数进行详细说明：

sql：要执行的 SQL 查询语句，可以是 SELECT、INSERT、UPDATE、DELETE 等。params（可选）：一个数组，包含要传递给 SQL 查询的参数。这些参数可以用于预处理语句中的占位符。callback：一个回调函数，用于处理查询结果或错误。回调函数接收两个参数：err 和 results。err 是一个错误对象（如果有错误发生），results 是查询结果。

以下是一个示例，展示了如何使用 query() 方法执行 SQL 查询并处理结果：

const mysql = require("mysql2");// 创建数据库连接const connection = mysql.createConnection({  host: "localhost",  user: "root",  password: "password",  database: "mydatabase"});// 连接到数据库connection.connect((err) => {  if (err) {    console.error("Error connecting to database:", err);    return;  }  console.log("Connected to database");  // 执行 SQL 查询,可以用??代替表名、字段、索引名；用?代替数据。  const sql = "SELECT * FROM users WHERE age > ?";  const params = [18];  connection.query(sql, params, (err, results) => {    if (err) {      console.error("Error executing query:", err);      return;    }    console.log("Query results:", results);  });});// 在数据库连接关闭时触发connection.on("end", () => {  console.log("Database connection closed");});// 在发生错误时触发connection.on("error", (err) => {  console.error("Database error:", err);});// 关闭数据库连接connection.end();

在这个示例中，我们执行了一个 SELECT 查询，查找年龄大于 18 的用户。我们使用了预处理语句，并将参数 [18] 传递给 query() 方法。

在回调函数中，我们处理了查询结果或错误。如果查询成功，我们打印出查询结果 results。

请根据您的实际需求修改 SQL 查询语句、参数和处理逻辑。您可以执行任何有效的 SQL 查询，并根据需要处理查询结果或错误。

通过 execute() 方法执行SQL语句

以下是一个使用mysql2模块执行SQL查询的示例：

const mysql = require('mysql2');// 创建数据库连接const connection = mysql.createConnection({  host: 'localhost',  user: 'root',  password: 'password',  database: 'mydatabase'});// 执行SQL查询connection.execute(  'SELECT * FROM users WHERE age > ?',  [18],  function(err, results, fields) {    if (err) {      console.log('[SELECT ERROR] - ', err.message);      return;    }    console.log(results);    // console.log(fields);  });// 关闭数据库连接connection.end();

在这个例子中，我们创建了一个名为mydatabase的数据库连接，并执行了一个查询语句，查找年龄大于18岁的用户。如果查询成功，结果将会在控制台打印出来。你可以取消注释掉console.log(fields)这行代码来查看字段信息。

请确保将localhost、root、password和mydatabase替换为你自己的数据库连接信息。

execute()和query()之间的区别：

下面是execute()和query()之间的区别：

参数化查询：execute()方法支持参数化查询，可以使用占位符（例如?）来代替查询中的参数，而query()方法不支持参数化查询，需要通过字符串拼接来传递参数。回调函数：execute()和query()方法都接受一个回调函数作为参数，用于处理查询结果。但是，execute()方法的回调函数有三个参数（err, results, fields），分别表示错误信息、查询结果和字段信息；而query()方法的回调函数有两个参数（err, results），只表示错误信息和查询结果。错误处理：在execute()方法中，需要手动处理错误，通过判断err参数是否存在来确定是否有错误发生。而query()方法会自动处理错误，如果发生错误，会将错误信息传递给回调函数的err参数。返回结果：无论是execute()还是query()方法，都会返回一个结果集对象。但是，execute()方法返回的结果集对象中包含更多的信息，如受影响的行数等。预编译：execute()方法支持预编译，可以提前编译SQL语句，以提高执行效率。而query()方法不支持预编译。

连接池

通过重新使用以前的连接，连接池可以保持打开状态，从而减少连接到MySQL服务器的时间。在Node.js中，可以使用mysql.createPool()方法来创建连接池。它的语法格式如下：

const mysql = require('mysql2');// 创建连接池const pool = mysql.createPool({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase',    connectionLimit: 10, // 最大连接数    queueLimit: 0, // 排队等待连接的最大请求数，0表示无限制    waitForConnections: true // 当连接池达到最大连接数时，是否等待可用连接});

使用连接池进行数据库操作可以使用pool.query()和pool.execute()方法，也可以手动获取连接进行操作。下面是使用连接池进行数据库操作的示例代码：

使用pool.query()方法：

const mysql = require('mysql2');// 创建连接池const pool = mysql.createPool({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase',    connectionLimit: 10});// 使用pool.query()方法执行查询pool.query('SELECT * FROM users', function(err, results, fields) {    if (err) {        console.log('[QUERY ERROR] - ', err.message);        return;    }    console.log(results);});// 关闭连接池pool.end();

使用pool.execute()方法：

const mysql = require('mysql2');// 创建连接池const pool = mysql.createPool({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase',    connectionLimit: 10});// 使用pool.execute()方法执行查询pool.execute('SELECT * FROM users', function(err, results, fields) {    if (err) {        console.log('[EXECUTE ERROR] - ', err.message);        return;    }    console.log(results);});// 关闭连接池pool.end();

手动获取连接进行数据库操作：

const mysql = require('mysql2');// 创建连接池const pool = mysql.createPool({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase',    connectionLimit: 10});// 从连接池中获取连接pool.getConnection(function(err, connection) {    if (err) {        console.log('[CONNECTION ERROR] - ', err.message);        return;    }    // 执行查询操作    connection.query('SELECT * FROM users', function(err, results, fields) {        connection.release(); // 释放连接回连接池        if (err) {            console.log('[QUERY ERROR] - ', err.message);            return;        }        console.log(results);    });});// 关闭连接池pool.end();

使用 Promise

在之前通过query()和execute()操作数据库时都是通过回调函数的形式获取放返回的数据。而我们可以使用Promise将异步转化为同步使用Promise来实现异步操作可以通过async/await和promise()函数两种方式。

一种是通过 async\await 来实现，种是通过 promise() 函数来实现。

下面是使用async/await和createConnection()、createPool()的方式创建数据库操作的示例代码：

使用async/await和createConnection()的方式：

const mysql = require('mysql2');// 创建连接const connection = mysql.createConnection({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase'});// 封装查询函数function query(sql) {    return new Promise((resolve, reject) => {        connection.query(sql, function(err, results, fields) {            if (err) {                reject(err);            } else {                resolve(results);            }        });    });}// 使用async/await进行数据库操作async function fetchData() {    try {        const results = await query('SELECT * FROM users');        console.log(results);    } catch (err) {        console.log('[QUERY ERROR] - ', err.message);    } finally {        connection.end();    }}fetchData();

使用async/await和createPool()的方式：

const mysql = require('mysql2');// 创建连接池const pool = mysql.createPool({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase',    connectionLimit: 10});// 封装查询函数function query(sql) {    return new Promise((resolve, reject) => {        pool.query(sql, function(err, results, fields) {            if (err) {                reject(err);            } else {                resolve(results);            }        });    });}// 使用async/await进行数据库操作async function fetchData() {    let connection;    try {        connection = await pool.promise().getConnection();        const results = await connection.query('SELECT * FROM users');        console.log(results);    } catch (err) {        console.log('[QUERY ERROR] - ', err.message);    } finally {        if (connection) {            connection.release();        }        pool.end();    }}fetchData();

使用promise()函数和createConnection()的方式：

const mysql = require('mysql2');// 创建连接const connection = mysql.createConnection({    host: 'localhost',    user: 'root',    password: 'password',    database: 'mydatabase'});// 封装查询函数function query(sql) {    return new Promise((resolve, reject) => {        connection.query(sql, function(err, results, fields) {            if (err) {                reject(err);            } else {                resolve(results);            }        });    });}// 使用promise()函数进行数据库操作query('SELECT * FROM users')    .then(results => {        console.log(results);    })    .catch(err => {        console.log('[QUERY ERROR] - ', err.message);    })    .finally(() => {        connection.end();    });

无论是使用async/await还是promise()函数，都可以将异步操作转化为同步的方式来完成对数据库的操作。根据个人的喜好和项目需求，选择适合的方式来使用Promise。