Wondering what’s next for npm?Check out our public roadmap! »

    tedious-connection-pool2

    2.0.0 • Public • Published

    tedious-connection-pool2

    Forked from https://github.com/tediousjs/tedious-connection-pool/pull/45 which never got merged to upstream master.

    A connection pool for tedious.

    Installation

    npm install tedious-connection-pool2
    

    Description

    The only difference from the regular tedious API is how the connection is obtained and released. Rather than creating a connection and then closing it when finished, acquire a connection from the pool and release it when finished. Releasing resets the connection and makes in available for another use.

    Once the Tedious Connection object has been acquired, the tedious API can be used with the connection as normal.

    Example

    var ConnectionPool = require('tedious-connection-pool');
    ConnectionPool.overrideTedious(require('tedious'));
    var Request = require('tedious').Request;
    
    var poolConfig = {
        min: 2,
        max: 4,
        log: true
    };
    
    var connectionConfig = {
        userName: 'login',
        password: 'password',
        server: 'localhost'
    };
    
    //create the pool
    var pool = new ConnectionPool(poolConfig, connectionConfig);
    
    pool.on('error', function(err) {
        console.error(err);
    });
    
    //acquire a connection
    pool.acquire(function (err, connection) {
        if (err) {
            console.error(err);
            return;
        }
    
        //use the connection as normal
        var request = new Request('select 42', function(err, rowCount) {
            if (err) {
                console.error(err);
                return;
            }
    
            console.log('rowCount: ' + rowCount);
    
            //release the connection back to the pool when finished
            connection.release();
        });
    
        request.on('row', function(columns) {
            console.log('value: ' + columns[0].value);
        });
    
        connection.execSql(request);
    });

    When you are finished with the pool, you can drain it (close all connections).

    pool.drain();

    Class: ConnectionPool

    ConnectionPool.overrideTedious(tedious)

    Create connections using specified tedious module rather than ConnectionPool's default version of tedious.

    new ConnectionPool(poolConfig, connectionConfig)

    • poolConfig {Object} the pool configuration object

      • min {Number} The minimum of connections there can be in the pool. Default = 10
      • max {Number} The maximum number of connections there can be in the pool. Default = 50
      • idleTimeout {Number} The number of milliseconds before closing an unused connection. Default = 300000
      • retryDelay {Number} The number of milliseconds to wait after a connection fails, before trying again. Default = 5000
      • acquireTimeout {Number} The number of milliseconds to wait for a connection, before returning an error. Default = 60000
      • log {Boolean|Function} Set to true to have debug log written to the console or pass a function to receive the log messages. Default = undefined
    • connectionConfig {Object} The same configuration that would be used to create a tedious Connection.

    connectionPool.acquire(callback)

    Acquire a Tedious Connection object from the pool.

    • callback(err, connection) {Function} Callback function
    • err {Object} An Error object is an error occurred trying to acquire a connection, otherwise null.
    • connection {Object} A Connection

    connectionPool.drain(callback)

    Close all pooled connections and stop making new ones. The pool should be discarded after it has been drained.

    • callback() {Function} Callback function

    connectionPool.error {event}

    The 'error' event is emitted when a connection fails to connect to the SQL Server. The pool will simply retry indefinitely. The application may want to handle errors in a more nuanced way.

    Class: Connection

    The following method is added to the Tedious Connection object.

    Connection.release()

    Release the connect back to the pool to be used again

    Install

    npm i tedious-connection-pool2

    DownloadsWeekly Downloads

    2

    Version

    2.0.0

    License

    MIT

    Unpacked Size

    42.9 kB

    Total Files

    11

    Last publish

    Collaborators

    • avatar