All Versions
Latest Version
Avg Release Cycle
150 days
Latest Release
346 days ago

Changelog History
Page 2

  • v2.1.4.dev5

    March 15, 2018
  • v2.1.4.dev4

    March 08, 2018
  • v2.1.4.dev3

    March 08, 2018
  • v2.1.4.dev2

    March 08, 2018
  • v2.1.4.dev1

    March 08, 2018
  • v2.1.3 Changes

    June 22, 2016


    • ๐Ÿ Windows official binaries: Rollback changes to Windows binaries we had implemented in pymssql 2.1.2; go back to using:

      • A statically linked version of FreeTDS (v0.95.95)
      • No SSL support
    • โšก๏ธ Update bundled Linux static version of FreeTDS to v0.95.95.

    ๐Ÿ”‹ Features

    • ๐Ÿง We now publish Linux PEP 513 manylinux wheels on PyPI.

    ๐Ÿ› Bug fixes

    • โž• Add support for reporting TDS version 7.3 is in use via the tds_version property of a _mssql-level connection.
  • v2.1.3.dev2

    June 10, 2016
  • v2.1.2 Changes

    February 10, 2016

    ๐Ÿ .. attention:: Windows users: You need to download and install additional DLLs

    pymssql version 2.1.2 includes a change in the official Windows binaries:
    FreeTDS isn't statically linked as it happened up to release 2.1.1, as that
    FreeTDS copy lacked SSL support.
    Please see for futher
    We are trying to find a balance between security and convenience and will
    be evaluating the situation for future releases. Your feedback is greatly


    • โฌ‡๏ธ Drop support for Python 2.6.

    • โž• Add support for Python 3.5.

    • โšก๏ธ Update shipped Linux FreeTDS static libs to 0.95

    ๐Ÿ”‹ Features

    • โž• Add ability to set TDS protocol version from pymssql when connecting to SQL Server. For the remaining pymssql 2.1.x releases its default value will be 7.1 (GH-323)

    • โž• Add Dockerfile and a Docker image and instructions on how to use it (GH-258). This could be a convenient way to use pymssql without having to build stuff. See Thanks Marc Abramowitz.

    • Floating point values are now accepted as Stored Procedure arguments (GH-287). Thanks Runzhou Li (Leo) for the report and Bill Adams for the implementation.

    • Send pymssql version in the appname TDS protocol login record field when the application doesn't provide one (GH-354)

    ๐Ÿ› Bug fixes

    • ๐Ÿ›  Fix a couple of very common causes of segmentation faults in presence of network a partition between a pymssql-based app and SQL Server (GH-147, GH-271) Thanks Marc Abramowitz. See also GH-373.

    • ๐Ÿ›  Fix failures and inconsistencies in query parameter interpolation when UTF-8-encoded literals are present (GH-185). Thanks Bill Adams. Also, GH-291.

    • ๐Ÿ›  Fix login_timeout parameter of pymssql.connect() (GH-318)

    • ๐Ÿ›  Fixed some cases of cursor.rowcont having a -1 value after iterating over the value returned by pymssql cursor fetchmany() and fetchone() methods (GH-141)

    • โœ‚ Remove automatic treatment of string literals passed in queries that start with '0x' as hexadecimal values (GH-286)

    • ๐Ÿ›  Fix build fatal error when using Cython >= 0.22 (GH-311)

    ๐Ÿ“š Documentation

    • โž• Add installation instructions. Thanks Marc Abramowitz.

    • Document DB-API-mandated exceptions.

    • โœจ Enhance _mssql.MSSQLStoredProcedure.bind() docs.

    • โœจ Enhance description of Azure connections requirements.


    • โž• Add Appveyor hosted CI setup for running tests on Windows (GH-347)

    • โœ… Travis CI: Use newer, faster, container-based infrastructure. Also, test against more than one FreeTDS version.

    • ๐Ÿš€ Make it possible to build official release files (sdist, wheels) on Travis & AppVeyor.

  • v2.1.1 Changes

    November 25, 2014

    ๐Ÿ”‹ Features

    • Custom message handlers (GH-139)

    The DB-Library API includes a callback mechanism so applications can provide functions known as message handlers that get passed informative messages sent by the server which then can be logged, shown to the user, etc.

    _mssql now allows you to install your own message handlers written in Python. See the _msssql examples and reference sections of the documentation for more details.

    Thanks Marc Abramowitz.

    • Compatibility with Azure

    It is now possible to transparently connect to SQL Server instances_ accessible as part of the Azure_ cloud services.

    .. note:: If you need to connect to Azure make sure you use FreeTDS 0.91 or newer.

    • Customizable per-connection initialization SQL clauses (both in pymssql and _mssql) (GH-97)

    It is now possible to customize the SQL statements sent right after the connection is established (e.g. 'SET ANSI_NULLS ON;'). Previously it was a hard-coded list of queries. See the _mssql.MSSQLConnection documentation for more details.

    Thanks Marc Abramowitz.

    • โž• Added ability to handle instances of uuid.UUID passed as parameters for SQL queries both in pymssql and _mssql. (GH-209)

    Thanks Marat Mavlyutov.

    • ๐Ÿ‘ Allow using SQL Server autocommit mode_ from pymssql at connection opening time. This allows e.g. DDL statements like DROP DATABASE to be executed. (GH-210)

    Thanks Marat Mavlyutov.

    • ๐Ÿ“š Documentation: Explicitly mention minimum versions supported of Python (2.6) and SQL Server (2005).

    • ๐Ÿ“š Incremental enhancements to the documentation.

    ๐Ÿ .. _SQL Server instances: ๐Ÿ .. _Azure: .. _SQL Server autocommit mode:

    ๐Ÿ› Bug fixes

    • ๐Ÿ– Handle errors when calling Stored Procedures via the .callproc() pymssql cursor method. Now it will raise a DB-API DatabaseException; previously it allowed a _mssql.MSSQLDatabaseException exception to surface.

    • ๐Ÿ”– Fixes in tds_version _mssql connections property value

    Made it work with TDS protocol version 7.2. (GH-211)

    The value returned for TDS version 7.1 is still 8.0 for backward compatibility (this is because such feature got added in times when Microsoft documentation labeled the two protocol versions that followed 7.0 as 8.0 and 9.0; later it changed them to 7.1 and 7.2 respectively) and will be corrected in a future release (2.2).

    • PEP 249 compliance (GH-251)

    Added type constructors to increase compatibility with other libraries.

    Thanks Aymeric Augustin.

    • pymssql: Made handling of integer SP params more robust (GH-237)

    • Check lower bound value when convering integer values from to Python to SQL (GH-238)


    • โœ… Completed migration of the test suite from nose to py.test.

    • โž• Added a few more test cases to our suite.

    • โœ… Tests: Modified a couple of test cases so the full suite can be run against SQL Server 2005.

    • โž• Added testing of successful build of documentation to Travis CI script.

    • ๐Ÿ— Build process: Cleanup intermediate and ad-hoc anciliary files (GH-231, GH-273)

    • ๐Ÿš€ Fixed handling of release tarballs contents so no extraneous files are shipped and the documentation tree is actually included. Also, removed unused code.

  • v2.1.0 Changes

    February 25, 2014

    ๐Ÿ”‹ Features

    • ๐Ÿ“š Sphinx-based documentation (GH-149)

    Read it online at

    Thanks, Ramiro Morales!


    Lets you use pymssql with cooperative multi-tasking systems like gevent and have pymssql call a callback when it is waiting for a response from the server. You can set this callback to yield to another greenlet, coroutine, etc. For example, for gevent, you could do::

      def wait_callback(read_fileno):

    The above is useful if you're say, running a gunicorn server with the gevent worker. With this callback in place, when you send a query to SQL server and are waiting for a response, you can yield to other greenlets and process other requests. This is super useful when you have high concurrency and/or slow database queries and lets you use less gunicorn worker processes and still handle high concurrency.


    • ๐Ÿ‘ Better error messages.

    E.g.: For a connection failure, instead of:

      pymssql.OperationalError: (20009, 'Net-Lib error during Connection

    the dberrstr is also included, resulting in:

      pymssql.OperationalError: (20009, 'DB-Lib error message 20009,
      severity 9:\nUnable to connect: Adaptive Server is unavailable or
      does not exist\nNet-Lib error during Connection refused\n')


    In the area of error messages, we also made this change:

    execute: Raise ColumnsWithoutNamesError when as_dict=True and missing column names (GH-160)

    because the previous behavior was very confusing; instead of raising an exception, we would just return row dicts with those columns missing. This prompted at least one question on the mailing list (!topic/pymssql/JoZpmNZFtxM), so we thought it was better to handle this explicitly by raising an exception, so the user would understand what went wrong.


    You are most likely to notice a difference from these when you are fetching a large number of rows.

    • Reworked row fetching (GH-159)

      There was a rather large amount of type conversion occuring when fetching a row from pymssql. The number of conversions required have been cut down significantly with these changes. Thanks Damien, Churchill!


    • Modify get_row() to use the CPython tuple API (GH-178)

      This drops the previous method of building up a row tuple and switches to using the CPython API, which allows you to create a correctly sized tuple at the beginning and simply fill it in. This appears to offer around a 10% boost when fetching rows from a table where the data is already in memory. Thanks Damien, Churchill!


    This adds with statement support for MSSQLConnection in the _mssql module -- e.g.::

      with mssqlconn() as conn:
          conn.execute_query("SELECT @@version AS version")

    We already have with statement support for the pymssql module. See:

    Use the bytesarray type added in Python 2.6 to signify that this is binary data and to quote it accordingly. Also modify the handling of str/bytes types checking the first 2 characters for b'0x' and insert that as binary data. See:


    ๐Ÿ› Bug Fixes

    • ๐Ÿ“ฆ GH-142 ("Change how *.pyx files are included in package") - this should prevent pymssql.pyx and _mssql.pyx from getting copied into the root of your virtualenv. Thanks, @Arfrever!

    • GH-145 ("Prevent error string growing with repeated failed connection attempts.")



    ๐Ÿ‘€ See ChangeLog.old_ for older history...

    .. _PyPI: .. _Travis CI: .. _Cython: .. _ChangeLog.old: