mssql 3.1.1 → 3.3.0

package/README.md

@@ -1,6 +1,6 @@
 # node-mssql
 
-An easy-to-use MSSQL database connector for Node.js.
+Microsoft SQL Server client for Node.js
 
 [![NPM Version][npm-image]][npm-url] [![NPM Downloads][downloads-image]][downloads-url] [![Package Quality][quality-image]][quality-url] [![Travis CI][travis-image]][travis-url] [![Appveyor CI][appveyor-image]][appveyor-url] [![Join the chat at https://gitter.im/patriksimek/node-mssql](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/patriksimek/node-mssql?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
@@ -12,6 +12,7 @@ An easy-to-use MSSQL database connector for Node.js.
 - Supports serialization of Geography and Geometry CLR types.
 - Has smart JS data type to SQL data type mapper.
 - Supports Promises, Streams and standard callbacks.
+- Supports ES6 tagged template literals.
 - Is stable and tested in production environment.
 - Is well documented.
 
@@ -54,88 +55,96 @@ sql.connect("mssql://username:password@localhost/database").then(function() {
 	}).catch(function(err) {
 		// ... execute error checks
 	});
+	
+	// ES6 Tagged template literals (experimental)
+	
+	sql.query`select * from mytable where id = ${value}`.then(function(recordset) {
+		console.dir(recordset);
+	}).catch(function(err) {
+		// ... query error checks
+	});
 }).catch(function(err) {
 	// ... connect error checks
 });
 ```
 
-If you're on Windows Azure, add `?encrypt=true` to your connection string. See [docs](#cfg) to learn more.
+If you're on Windows Azure, add `?encrypt=true` to your connection string. See [docs](#configuration) to learn more.
 
 ## Documentation
 
-* [2.x to 3.x changes](#twotothree)
+* [2.x to 3.x changes](#2x-to-3x-changes)
 
 ### Examples
 
 * [Promises](#promises)
-* [Nested callbacks](#callbacks)
+* [Nested callbacks](#nested-callbacks)
 * [Streaming](#streaming)
 * [Multiple Connections](#multiple-connections)
 
 ### Configuration
 
-* [General](#cfg-general)
-* [Formats](#cfg-formats)
+* [General](#general-same-for-all-drivers)
+* [Formats](#formats)
 
 ### Drivers
 
-* [Tedious](#cfg-tedious)
-* [Microsoft / Contributors Node V8 Driver for Node.js for SQL Server](#cfg-msnodesqlv8)
-* [Microsoft Driver for Node.js for SQL Server](#cfg-msnodesql)
-* [node-tds](#cfg-node-tds)
+* [Tedious](#tedious)
+* [Microsoft / Contributors Node V8 Driver for Node.js for SQL Server](#microsoft--contributors-node-v8-driver-for-nodejs-for-sql-server)
+* [Microsoft Driver for Node.js for SQL Server](#microsoft-driver-for-nodejs-for-sql-server)
+* [node-tds](#node-tds)
 
 ### Connections
 
 * [Connection](#connection)
-* [connect](#connect)
+* [connect](#connect-callback)
 * [close](#close)
 
 ### Requests
 
 * [Request](#request)
-* [execute](#execute)
-* [input](#input)
-* [output](#output)
-* [pipe](#pipe)
-* [query](#query)
-* [batch](#batch)
-* [bulk](#bulk)
+* [execute](#execute-procedure-callback)
+* [input](#input-name-type-value)
+* [output](#output-name-type-value)
+* [pipe](#pipe-stream)
+* [query](#query-command-callback)
+* [batch](#batch-batch-callback)
+* [bulk](#bulk-table-callback)
 * [cancel](#cancel)
 
 ### Transactions
 
 * [Transaction](#transaction)
-* [begin](#begin)
-* [commit](#commit)
-* [rollback](#rollback)
+* [begin](#begin-isolationlevel-callback)
+* [commit](#commit-callback)
+* [rollback](#rollback-callback)
 
 ### Prepared Statements
 
 * [PreparedStatement](#prepared-statement)
-* [input](#prepared-statement-input)
-* [output](#prepared-statement-output)
-* [prepare](#prepare)
-* [execute](#prepared-statement-execute)
-* [unprepare](#unprepare)
+* [input](#input-name-type)
+* [output](#output-name-type)
+* [prepare](#prepare-statement-callback)
+* [execute](#execute-values-callback)
+* [unprepare](#unprepare-callback)
 
 ### Other
 
 * [CLI](#cli)
-* [Geography and Geometry](#geography)
-* [Table-Valued Parameter](#tvp)
+* [Geography and Geometry](#geography-and-geometry)
+* [Table-Valued Parameter](#table-valued-parameter-tvp)
 * [Affected Rows](#affected-rows)
-* [JSON support](#json)
+* [JSON support](#json-support)
 * [Errors](#errors)
-* [Metadata](#meta)
+* [Informational messages](#informational-messages)
+* [Metadata](#metadata)
 * [Data Types](#data-types)
-* [SQL injection](#injection)
-* [Verbose Mode](#verbose)
-* [Known Issues](#issues)
+* [SQL injection](#sql-injection)
+* [Verbose Mode](#verbose-mode)
+* [Known Issues](#known-issues)
 * [Contributing](https://github.com/patriksimek/node-mssql/wiki/Contributing)
 
 ## Examples
 
-<a name="promises" />
 ### Promises
 
 ```javascript
@@ -155,8 +164,9 @@ var config = {
 sql.connect(config).then(function() {
 	// Query
 	
-	var request = new sql.Request();
-	request.query('select * from mytable').then(function(recordset) {
+	new sql.Request();
+	.input('input_parameter', sql.Int, value);
+	.query('select * from mytable where id = @input_parameter').then(function(recordset) {
 		console.dir(recordset);
 	}).catch(function(err) {
 		// ... error checks
@@ -164,10 +174,10 @@ sql.connect(config).then(function() {
 
     // Stored Procedure
 	
-	var request = new sql.Request();
-	request.input('input_parameter', sql.Int, value);
-    request.output('output_parameter', sql.VarChar(50));
-	request.execute('procedure_name').then(function(recordsets) {
+	new sql.Request();
+	.input('input_parameter', sql.Int, value);
+    .output('output_parameter', sql.VarChar(50));
+	.execute('procedure_name').then(function(recordsets) {
 		console.dir(recordsets);
 	}).catch(function(err) {
 		// ... error checks
@@ -179,7 +189,22 @@ sql.connect(config).then(function() {
 
 Native Promise is used by default. You can easily change this with `sql.Promise = require('myownpromisepackage')`.
 
-<a name="callbacks" />
+**ES6 Tagged template literals (experimental)**
+
+```javascript
+sql.connect(config).then(function() {
+	sql.query`select * from mytable where id = ${value}`.then(function(recordset) {
+		console.dir(recordset);
+	}).catch(function(err) {
+		// ... error checks
+	});
+}).catch(function(err) {
+	// ... error checks
+});
+```
+
+All values are automatically sanitized against sql injection.
+
 ### Nested callbacks
 
 ```javascript
@@ -201,8 +226,7 @@ sql.connect(config, function(err) {
 
     // Query
 
-    var request = new sql.Request();
-    request.query('select 1 as number', function(err, recordset) {
+    new sql.Request().query('select 1 as number', function(err, recordset) {
         // ... error checks
 
         console.dir(recordset);
@@ -210,10 +234,10 @@ sql.connect(config, function(err) {
 
     // Stored Procedure
 
-    var request = new sql.Request();
-    request.input('input_parameter', sql.Int, value);
-    request.output('output_parameter', sql.VarChar(50));
-    request.execute('procedure_name', function(err, recordsets, returnValue) {
+    new sql.Request()
+    .input('input_parameter', sql.Int, value)
+    .output('output_parameter', sql.VarChar(50))
+    .execute('procedure_name', function(err, recordsets, returnValue) {
         // ... error checks
 
         console.dir(recordsets);
@@ -225,7 +249,6 @@ sql.on('error', function(err) {
 });
 ```
 
-<a name="streaming" />
 ### Streaming
 
 If you plan to work with large amount of rows, you should always use streaming. Once you enable this, you must listen for events to receive data.
@@ -274,7 +297,6 @@ sql.on('error', function(err) {
 });
 ```
 
-<a name="multiple-connections" />
 ## Multiple Connections
 
 ```javascript
@@ -329,7 +351,22 @@ connection2.on('error', function(err) {
 });
 ```
 
-<a name="cfg" />
+**ES6 Tagged template literals (experimental)**
+
+```javascript
+new sql.Connection(config).connect().then(function(conn) {
+	conn.query`select * from mytable where id = ${value}`.then(function(recordset) {
+		console.dir(recordset);
+	}).catch(function(err) {
+		// ... error checks
+	});
+}).catch(function(err) {
+	// ... error checks
+});
+```
+
+All values are automatically sanitized against sql injection.
+
 ## Configuration
 
 ```javascript
@@ -346,7 +383,6 @@ var config = {
 }
 ```
 
-<a name="cfg-general" />
 ### General (same for all drivers)
 
 - **driver** - Driver to use (default: `tedious`). Possible values: `tedious`, `msnodesqlv8` or `msnodesql` or `tds`.
@@ -359,12 +395,11 @@ var config = {
 - **connectionTimeout** - Connection timeout in ms (default: `15000`).
 - **requestTimeout** - Request timeout in ms (default: `15000`).
 - **stream** - Stream recordsets/rows instead of returning them all at once as an argument of callback (default: `false`). You can also enable streaming for each request independently (`request.stream = true`). Always set to `true` if you plan to work with large amount of rows.
-- **parseJSON** - Parse JSON recordsets to JS objects (default: `false`). For more information please see section [JSON support](#json).
+- **parseJSON** - Parse JSON recordsets to JS objects (default: `false`). For more information please see section [JSON support](#json-support).
 - **pool.max** - The maximum number of connections there can be in the pool (default: `10`).
 - **pool.min** - The minimum of connections there can be in the pool (default: `0`).
 - **pool.idleTimeoutMillis** - The Number of milliseconds before closing an unused connection (default: `30000`).
 
-<a name="cfg-formats" />
 ### Formats
 
 In addition to configuration object there is an option to pass config as a connection string. Two formats of connection string are supported.
@@ -389,7 +424,6 @@ __Version__
 
 ## Drivers
 
-<a name="cfg-tedious" />
 ### Tedious
 
 Default driver, actively maintained and production ready. Platform independent, runs everywhere Node.js runs.
@@ -405,7 +439,6 @@ Default driver, actively maintained and production ready. Platform independent,
 
 More information about Tedious specific options: http://pekim.github.io/tedious/api-connection.html
 
-<a name="cfg-msnodesqlv8" />
 ### Microsoft / Contributors Node V8 Driver for Node.js for SQL Server
 
 **Requires Node.js 0.12.x/4.2.0. Windows only.** This driver is not part of the default package and must be installed separately by `npm install msnodesqlv8`.
@@ -427,7 +460,6 @@ Default connection string when connecting to named instance:
 Driver={SQL Server Native Client 11.0};Server={#{server}\\#{instance}};Database={#{database}};Uid={#{user}};Pwd={#{password}};Trusted_Connection={#{trusted}};
 ```
 
-<a name="cfg-msnodesql" />
 ### Microsoft Driver for Node.js for SQL Server
 
 **Requires Node.js 0.6.x/0.8.x/0.10.x. Windows only.** This driver is not part of the default package and must be installed separately by `npm install msnodesql`. If you are looking for compiled binaries, see [node-sqlserver-binary](https://github.com/jorgeazevedo/node-sqlserver-unofficial).
@@ -449,15 +481,13 @@ Default connection string when connecting to named instance:
 Driver={SQL Server Native Client 11.0};Server={#{server}\\#{instance}};Database={#{database}};Uid={#{user}};Pwd={#{password}};Trusted_Connection={#{trusted}};
 ```
 
-<a name="cfg-node-tds" />
 ### node-tds
 
 **Legacy support, don't use this driver for new projects.** This driver is not part of the default package and must be installed separately by `npm install tds`.
 
 _node-mssql updates this driver with extra features and bug fixes by overriding some of its internal functions. If you want to disable this, require module with `var sql = require('mssql/nofix')`._
 
-<a name="connection" />
-## Connections
+## Connection
 
 Internally, each `Connection` instance is a separate pool of TDS connections. Once you create a new `Request`/`Transaction`/`Prepared Statement`, a new TDS connection is acquired from the pool and reserved for desired action. Once the action is complete, connection is released back to the pool. Connection health check is built-in so once the dead connection is discovered, it is immediately replaced with a new one.
 
@@ -478,8 +508,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="connect" />
-### connect([callback])
+### connect ([callback])
 
 Create a new connection pool with one active connection. This one initial connection serves as a probe to find out whether the configuration is valid.
 
@@ -512,7 +541,6 @@ __Errors__
 
 ---------------------------------------
 
-<a name="close" />
 ### close()
 
 Close all active connections in the pool.
@@ -523,8 +551,7 @@ __Example__
 connection.close();
 ```
 
-<a name="request" />
-## Requests
+## Request
 
 ```javascript
 var request = new sql.Request(/* [connection] */);
@@ -538,11 +565,11 @@ If you omit connection argument, global connection is used instead.
 - **row(row)** - Dispatched when new row is parsed.
 - **done(returnValue)** - Dispatched when request is complete.
 - **error(err)** - Dispatched on error.
+- **info(message)** - Dispatched on informational message.
 
 ---------------------------------------
 
-<a name="execute" />
-### execute(procedure, [callback])
+### execute (procedure, [callback])
 
 Call a stored procedure.
 
@@ -585,8 +612,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="input" />
-### input(name, [type], value)
+### input (name, [type], value)
 
 Add an input parameter to the request.
 
@@ -632,8 +658,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="output" />
-### output(name, type, [value])
+### output (name, type, [value])
 
 Add an output parameter to the request.
 
@@ -656,8 +681,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="pipe" />
-### pipe(stream)
+### pipe (stream)
 
 Sets request to `stream` mode and pulls all rows from all recordsets to a given stream.
 
@@ -685,10 +709,9 @@ __Version__
 
 ---------------------------------------
 
-<a name="query" />
-### query(command, [callback])
+### query (command, [callback])
 
-Execute the SQL command. To execute commands like `create procedure` or if you plan to work with local temporary tables, use [batch](#batch) instead.
+Execute the SQL command. To execute commands like `create procedure` or if you plan to work with local temporary tables, use [batch](#batch-batch-callback) instead.
 
 __Arguments__
 
@@ -736,10 +759,9 @@ request.query('select 1 as number; select 2 as number', function(err, recordsets
 
 ---------------------------------------
 
-<a name="batch" />
-### batch(batch, [callback])
+### batch (batch, [callback])
 
-Execute the SQL command. Unlike [query](#query), it doesn't use `sp_executesql`, so is not likely that SQL Server will reuse the execution plan it generates for the SQL. Use this only in special cases, for example when you need to execute commands like `create procedure` which can't be executed with [query](#query) or if you're executing statements longer than 4000 chars on SQL Server 2000. Also you should use this if you're plan to work with local temporary tables ([more information here](http://weblogs.sqlteam.com/mladenp/archive/2006/11/03/17197.aspx)).
+Execute the SQL command. Unlike [query](#query-command-callback), it doesn't use `sp_executesql`, so is not likely that SQL Server will reuse the execution plan it generates for the SQL. Use this only in special cases, for example when you need to execute commands like `create procedure` which can't be executed with [query](#query-command-callback) or if you're executing statements longer than 4000 chars on SQL Server 2000. Also you should use this if you're plan to work with local temporary tables ([more information here](http://weblogs.sqlteam.com/mladenp/archive/2006/11/03/17197.aspx)).
 
 NOTE: Table-Valued Parameter (TVP) is not supported in batch.
 
@@ -771,7 +793,6 @@ You can enable multiple recordsets in queries with the `request.multiple = true`
 
 ---------------------------------------
 
-<a name="bulk" />
 ### bulk(table, [callback])
 
 Perform a bulk insert.
@@ -815,7 +836,6 @@ __Errors__
 
 ---------------------------------------
 
-<a name="cancel" />
 ### cancel()
 
 Cancel currently executing request. Return `true` if cancellation packet was send successfully.
@@ -835,8 +855,7 @@ request.query('waitfor delay \'00:00:05\'; select 1 as number', function(err, re
 request.cancel();
 ```
 
-<a name="transaction" />
-## Transactions
+## Transaction
 
 **IMPORTANT:** always use `Transaction` class to create transactions - it ensures that all your requests are executed on one connection. Once you call `begin`, a single connection is acquired from the connection pool and all subsequent requests (initialized with the `Transaction` object) are executed exclusively on this connection. Transaction also contains a queue to make sure your requests are executed in series. After you call `commit` or `rollback`, connection is then released back to the connection pool.
 
@@ -912,8 +931,7 @@ transaction.begin(function(err) {
 
 ---------------------------------------
 
-<a name="begin" />
-### begin([isolationLevel], [callback])
+### begin ([isolationLevel], [callback])
 
 Begin a transaction.
 
@@ -937,8 +955,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="commit" />
-### commit([callback])
+### commit ([callback])
 
 Commit a transaction.
 
@@ -965,8 +982,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="rollback" />
-### rollback([callback])
+### rollback ([callback])
 
 Rollback a transaction. If the queue isn't empty, all queued requests will be Cancelled and the transaction will be marked as aborted.
 
@@ -991,8 +1007,7 @@ __Errors__
 - ENOTBEGUN (`TransactionError`) - Transaction has not begun.
 - EREQINPROG (`TransactionError`) - Can't rollback transaction. There is a request in progress.
 
-<a name="prepared-statement" />
-## PreparedStatement
+## Prepared Statement
 
 **IMPORTANT:** always use `PreparedStatement` class to create prepared statements - it ensures that all your executions of prepared statement are executed on one connection. Once you call `prepare`, a single connection is acquired from the connection pool and all subsequent executions are executed exclusively on this connection. Prepared Statement also contains a queue to make sure your executions are executed in series. After you call `unprepare`, the connection is then released back to the connection pool.
 
@@ -1027,8 +1042,7 @@ ps.prepare('select @param as value', function(err) {
 
 ---------------------------------------
 
-<a name="prepared-statement-input" />
-### input(name, type)
+### input (name, type)
 
 Add an input parameter to the prepared statement.
 
@@ -1050,8 +1064,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="prepared-statement-output" />
-### output(name, type)
+### output (name, type)
 
 Add an output parameter to the prepared statement.
 
@@ -1073,8 +1086,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="prepare" />
-### prepare(statement, [callback])
+### prepare (statement, [callback])
 
 Prepare a statement.
 
@@ -1099,8 +1111,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="prepared-statement-execute" />
-### execute(values, [callback])
+### execute (values, [callback])
 
 Execute a prepared statement.
 
@@ -1189,6 +1200,8 @@ ps.prepare('select @param as value', function(err) {
 
 **TIP**: To learn more about how number of affected rows works, see section [Affected Rows](#affected-rows).
 
+**TIP**: To access number of affected rows when using Prepared Statement with Promises, use `ps.lastRequest.affectedRows`.
+
 __Errors__
 - ENOTPREPARED (`PreparedStatementError`) - Statement is not prepared.
 - ETIMEOUT (`RequestError`) - Request timeout.
@@ -1197,8 +1210,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="unprepare" />
-### unprepare([callback])
+### unprepare ([callback])
 
 Unprepare a prepared statement.
 
@@ -1224,7 +1236,6 @@ ps.prepare('select @param as value', function(err, recordsets) {
 __Errors__
 - ENOTPREPARED (`PreparedStatementError`) - Statement is not prepared.
 
-<a name="cli" />
 ## CLI
 
 Before you can start using CLI, you must install `mssql` globally with `npm install mssql -g`. Once you do that you will be able to execute `mssql` command.
@@ -1268,7 +1279,6 @@ __Version__
 
 2.0
 
-<a name="geography" />
 ## Geography and Geometry
 
 node-mssql has built-in serializer for Geography and Geometry CLR data types.
@@ -1299,7 +1309,6 @@ Results in:
   segments: [] }
 ```
 
-<a name="tvp" />
 ## Table-Valued Parameter (TVP)
 
 Supported on SQL Server 2008 and later. You can pass a data table as a parameter to stored procedure. First, we have to create custom type in our database.
@@ -1341,7 +1350,6 @@ request.execute('MyCustomStoredProcedure', function(err, recordsets, returnValue
 
 **TIP**: You can also create Table variable from any recordset with `recordset.toTable()`.
 
-<a name="affected-rows">
 ## Affected Rows
 
 If you're performing `INSERT`, `UPDATE` or `DELETE` in a query, you can read number of affected rows.
@@ -1381,8 +1389,7 @@ __Version__
 
 3.0
 
-<a name="json" />
-## JSON support (experimental, works only with Tedious driver)
+## JSON support
 
 SQL Server 2016 introduced built-in JSON serialization. By default, JSON is returned as a plain text in a special column named `JSON_F52E2B61-18A1-11d1-B105-00805F49916B`.
 
@@ -1414,7 +1421,6 @@ __Version__
 
 2.3
 
-<a name="errors" />
 ## Errors
 
 There are 4 types of errors you can handle:
@@ -1463,13 +1469,40 @@ Name | Code | Message
 SQL errors (`RequestError` with `err.code` equal to `EREQUEST`) contains additional details.
 
 - **err.number** - The error number.
-- **err.state** - The error state, used as a modifier to the error number.
+- **err.state** - The error state, used as a modifier to the number.
 - **err.class** - The class (severity) of the error. A class of less than 10 indicates an informational message. Detailed explanation can be found [here](https://msdn.microsoft.com/en-us/library/dd304156.aspx).
 - **err.lineNumber** - The line number in the SQL batch or stored procedure that caused the error. Line numbers begin at 1; therefore, if the line number is not applicable to the message, the value of LineNumber will be 0.
 - **err.serverName** - The server name.
 - **err.procName** - The stored procedure name.
 
-<a name="meta" />
+## Informational messages
+
+To receive informational messages generated by `PRINT` or `RAISERROR` commands use:
+
+```javascript
+var request = new sql.Request();
+request.on('info', function(info) {
+	console.dir(info);
+});
+request.query('print \'Hello world.\';', function(err, recordset) {
+    // ...
+});
+```
+
+Structure of informational message:
+
+- **info.message** - Message.
+- **info.number** - The message number.
+- **info.state** - The message state, used as a modifier to the number.
+- **info.class** - The class (severity) of the message. Equal or lower than 10. Detailed explanation can be found [here](https://msdn.microsoft.com/en-us/library/dd304156.aspx).
+- **info.lineNumber** - The line number in the SQL batch or stored procedure that generated the message. Line numbers begin at 1; therefore, if the line number is not applicable to the message, the value of LineNumber will be 0.
+- **info.serverName** - The server name.
+- **info.procName** - The stored procedure name.
+
+__Version__
+
+3.3
+
 ## Metadata
 
 Recordset metadata are accessible through the `recordset.columns` property.
@@ -1513,7 +1546,6 @@ Columns structure for example above:
 }
 ```
 
-<a name="data-types" />
 ## Data Types
 
 You can define data types with length/precision/scale:
@@ -1578,7 +1610,6 @@ sql.Geometry
 
 To setup MAX length for `VarChar`, `NVarChar` and `VarBinary` use `sql.MAX` length. Types `sql.XML` and `sql.Variant` are not supported as input parameters.
 
-<a name="injection" />
 ## SQL injection
 
 This module has built-in SQL injection protection. Always use parameters to pass sanitized values to your queries.
@@ -1591,7 +1622,6 @@ request.query('select @myval as myval', function(err, recordset) {
 });
 ```
 
-<a name="verbose" />
 ## Verbose Mode
 
 You can enable verbose mode by `request.verbose = true` command.
@@ -1626,35 +1656,36 @@ Output for the example above could look similar to this.
 ---------- completed ----------
 ```
 
-<a name="issues" />
 ## Known issues
 
 ### Tedious
 
 - If you're facing problems with connecting SQL Server 2000, try setting the default TDS version to 7.1 with `config.options.tdsVersion = '7_1'` ([issue](https://github.com/patriksimek/node-mssql/issues/36))
-- If you're executing a statement longer than 4000 chars on SQL Server 2000, always use [batch](#batch) instead of [query](#query) ([issue](https://github.com/patriksimek/node-mssql/issues/68))
+- If you're executing a statement longer than 4000 chars on SQL Server 2000, always use [batch](#batch-batch-callback) instead of [query](#query-command-callback) ([issue](https://github.com/patriksimek/node-mssql/issues/68))
 
 ### msnodesqlv8
 
 - msnodesqlv8 has problem with errors during transactions - [reported](https://github.com/patriksimek/node-mssql/issues/77).
 - msnodesqlv8 doesn't timeout the connection reliably - [reported](https://github.com/TimelordUK/node-sqlserver-v8/issues/9).
-- msnodesqlv8 doesn't support [TVP](#tvp) data type.
+- msnodesqlv8 doesn't support [TVP](#table-valued-parameter-tvp) data type.
 - msnodesqlv8 doesn't support Variant data type.
 - msnodesqlv8 doesn't support request timeout.
 - msnodesqlv8 doesn't support request cancellation.
 - msnodesqlv8 doesn't support [detailed SQL errors](#detailed-sql-errors).
+- msnodesqlv8 doesn't support [Informational messages](#informational-messages).
 
 ### msnodesql
 
 - msnodesql has problem with errors during transactions - [reported](https://github.com/patriksimek/node-mssql/issues/77).
 - msnodesql contains bug in DateTimeOffset ([reported](https://github.com/Azure/node-sqlserver/issues/160))
-- msnodesql doesn't support [Bulk](#bulk) load.
-- msnodesql doesn't support [TVP](#tvp) data type.
+- msnodesql doesn't support [Bulk](#bulk-table-callback) load.
+- msnodesql doesn't support [TVP](#table-valued-parameter-tvp) data type.
 - msnodesql doesn't support Variant data type.
 - msnodesql doesn't support connection timeout.
 - msnodesql doesn't support request timeout.
 - msnodesql doesn't support request cancellation.
 - msnodesql doesn't support [detailed SQL errors](#detailed-sql-errors).
+- msnodesql doesn't support [Informational messages](#informational-messages).
 - msnodesql reports invalid number of affected rows in some cases.
 
 ### node-tds
@@ -1667,20 +1698,19 @@ Output for the example above could look similar to this.
 - node-tds doesn't support Binary, VarBinary and Image as parameters.
 - node-tds always return date/time values in local time.
 - node-tds has serious problems with MAX types.
-- node-tds doesn't support [Bulk](#bulk) load.
-- node-tds doesn't support [TVP](#tvp) data type.
+- node-tds doesn't support [Bulk](#bulk-table-callback) load.
+- node-tds doesn't support [TVP](#table-valued-parameter-tvp) data type.
 - node-tds doesn't support Variant data type.
 - node-tds doesn't support request timeout.
-- node-tds doesn't support [built-in JSON serialization](#json) introduced in SQL Server 2016.
+- node-tds doesn't support [built-in JSON serialization](#json-support) introduced in SQL Server 2016.
 - node-tds doesn't support [detailed SQL errors](#detailed-sql-errors).
 - node-tds doesn't support [Affected Rows](#affected-rows)
 
-<a name="twotothree" />
 ## 2.x to 3.x changes
 
 ### Prepared Statement
 
-* [`execute`](#prepared-statement-execute) method now returns 3 arguments instead of 2.
+* [`execute`](#execute-values-callback) method now returns 3 arguments instead of 2.
 
     ```javascript
     ps.execute(values, function(err, recordset, affected) { });
@@ -1694,7 +1724,7 @@ Output for the example above could look similar to this.
 
 ### Request
 
-* [`execute`](#execute) method now returns 4 arguments instead of 3.
+* [`execute`](#execute-procedure-callback) method now returns 4 arguments instead of 3.
 
     ```javascript
     ps.execute(values, function(err, recordset, returnValue, affected) { });
@@ -1706,7 +1736,7 @@ Output for the example above could look similar to this.
     request.on('done', function(returnValue, affected) { });
     ```
 
-* [`query`](#query) method now returns 3 arguments instead of 2.
+* [`query`](#query-command-callback) method now returns 3 arguments instead of 2.
 
     ```javascript
     ps.execute(values, function(err, recordset, affected) { });
@@ -1718,7 +1748,6 @@ Output for the example above could look similar to this.
     request.on('done', function(affected) { });
     ```
 
-<a name="license" />
 ## License
 
 Copyright (c) 2013-2016 Patrik Simek