【亲测免费】 `node-mssql` 教程

本教程将引导您了解并使用基于 Tedious 的 node-mssql 库来连接和操作 Microsoft SQL Server。

1. 项目目录结构及介绍

以下是 node-mssql 的基本目录结构：

node-mssql/
|-- package.json
|-- README.md
|-- src/             # 主要源代码
|   |-- config.ts    # 配置处理模块
|   |-- connection.ts # 连接管理模块
|   |-- request.ts    # 查询请求模块
|   |-- stream.ts     # 数据流处理模块
|   |-- pool.ts       # 连接池模块
|-- test/            # 测试代码
|-- examples/        # 示例应用

• package.json: 项目元数据和依赖项列表。
• README.md: 项目说明文件。
• src/: 源代码目录，包含了核心功能实现。
  • config.ts: 处理和解析数据库配置。
  • connection.ts: 管理与SQL Server的连接。
  • request.ts: 实现查询和命令执行。
  • stream.ts: 支持数据结果的流式处理。
  • pool.ts: 连接池管理，优化资源利用。
• test/: 单元测试和集成测试代码。
• examples/: 包含了一些简单的示例应用，展示如何使用库的基本功能。

2. 项目的启动文件介绍

在 node-mssql 中，没有特定的启动文件，因为它是一个库，而不是一个独立的应用程序。通常情况下，您会在自己的Node.js项目中安装这个库，然后导入它以创建连接并执行SQL语句。例如：

const sql = require('mssql');

// 创建连接配置
const config = {
  user: 'username',
  password: 'password',
  server: 'localhost', 
  database: 'myDatabase'
};

sql.connect(config).then(conn => {
  // 执行查询
  conn.query('SELECT * FROM myTable').then(result => {
    console.log(result);
    conn.close();
  }).catch(err => console.error(err));
}).catch(err => console.error(err));

这段代码首先导入了 mssql 模块，定义了数据库连接的配置，接着尝试建立连接并执行SQL查询。

3. 项目的配置文件介绍

node-mssql 不强制要求使用配置文件，但您可以创建一个JSON或JavaScript文件来存储数据库连接配置，这有助于保持代码整洁。例如，您可以创建一个名为 config.js 的文件：

module.exports = {
  user: 'username',
  password: 'password',
  server: 'localhost', 
  database: 'myDatabase',
  options: {
    encrypt: true // 可选：用于连接到加密的SQL服务器
  }
};

之后，在您的应用程序中导入此配置：

const sql = require('mssql');
const config = require('./config'); // 导入配置文件

sql.connect(config).then(...);

请注意，具体的配置选项可能因环境而异，如连接字符串、端口、身份验证模式等。查阅官方文档以获取完整的配置选项和详细信息。

完成以上步骤后，您应该能够成功地在Node.js中使用 node-mssql 连接到Microsoft SQL Server并进行数据库操作。有关更多高级特性和最佳实践，请参考 项目文档。