mssql-multi-pool


A simple way to manage connections to multiple SQL Server databases using the Node.js Tedious package (node-mssql).

- 💪 Fully typed. Exports all types from node-mssql as well.
- 🧠 Automatically uses the MSNodeSQLv8 driver
on Windows (when available) to support Windows authentication,
and the Tedious driver on other operating systems.
- 🧹 Automatically cleans up all pools on exit.

Why?

The fantastic node-mssql package
provides an easy and reliable way to connect to _one_ SQL Server instance.

Connecting to multiple SQL Server instances is where things get trickier.
Not too tricky, but it is more involved as you can't rely on the global pool.
There is some sample code in the node-mssql README that shows how to do it.

This project implements that sample code. 👌

Installation

``sh
npm install @cityssm/mssql-multi-pool
`

💡 If you want to use msnodesqlv8, it must be installed separately.

Usage

Replace the connect(config) command from the mssql package
with the connect(config) command from the @cityssm/mssql-multi-pool package.

If the configuration object describes an unseen database, a new pool is made.
Otherwise, the previously made pool is used.

`typescript
import mssqlMultiPool, { type mssql } from '@cityssm/mssql-multi-pool'

const pool = await mssqlMultiPool.connect(config)

// Use the mssql package like before.

const results = (await pool
.request()
.input('workOrderNumber', '2024-01234')
.query(
'select * from WorkOrders where workOrderNumber = @workOrderNumber'
)) as mssql.IResult
``