Skip to main content

DB-API interface to Microsoft SQL Server for Python. (new Cython-based version)

Project description

pymssql - DB-API interface to Microsoft SQL Server

A simple database interface for Python that builds on top of FreeTDS to provide a Python DB-API (PEP-249) interface to Microsoft SQL Server.

Detailed information on pymssql is available on the website:

New development is happening on GitHub at:

There is a Google Group for discussion at:!forum/pymssql

Do you use pymssql?

Can you take a minute and fill out this survey to help us prioritize development tasks?

Bitdeli badge

Recent Changes

Version 2.1.4 - 2018-08-28


  • Drop support for versions of FreeTDS older than 0.91.

  • Add Python 3.7 support

  • Drop Python 3.3 support


  • Support for new in SQL Server 2008 DATE, TIME and DATETIME2 data types (GH-156). The following conditions need to be additionally met so values of these column types can be returned from the database as their native corresponding Python data types instead of as strings:

    • Underlying FreeTDS must be 0.95 or newer.

    • TDS protocol version in use must be 7.3 or newer.

    Thanks Ed Avis for the implementation. (GH-331)

Bug fixes

  • Fix tds_version _mssql connection property value for TDS version. 7.1 is actually 7.1 and not 8.0.

Version 2.1.3 - 2016-06-22 - Ramiro Morales

  • We now publish Linux PEP 513 manylinux wheels on PyPI.

  • 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

Version 2.1.2 - 2016-02-10 - Ramiro Morales


  • 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)


  • 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.

Version 2.1.1 - 2014-11-25 - Ramiro Morales


  • 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.

  • 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.

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.

Version 2.1.0 - 2014-02-25 - Marc Abramowitz


Bug Fixes

See ChangeLog for older history…

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymssql-2.1.4.tar.gz (691.6 kB view hashes)

Uploaded Source

Built Distributions

pymssql-2.1.4-cp37-cp37m-win_amd64.whl (411.1 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

pymssql-2.1.4-cp37-cp37m-win32.whl (353.4 kB view hashes)

Uploaded CPython 3.7m Windows x86

pymssql-2.1.4-cp37-cp37m-manylinux1_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.7m

pymssql-2.1.4-cp37-cp37m-manylinux1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.7m

pymssql-2.1.4-cp36-cp36m-win_amd64.whl (411.4 kB view hashes)

Uploaded CPython 3.6m Windows x86-64

pymssql-2.1.4-cp36-cp36m-win32.whl (353.8 kB view hashes)

Uploaded CPython 3.6m Windows x86

pymssql-2.1.4-cp36-cp36m-manylinux1_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.6m

pymssql-2.1.4-cp36-cp36m-manylinux1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.6m

pymssql-2.1.4-cp35-cp35m-win_amd64.whl (406.9 kB view hashes)

Uploaded CPython 3.5m Windows x86-64

pymssql-2.1.4-cp35-cp35m-win32.whl (350.7 kB view hashes)

Uploaded CPython 3.5m Windows x86

pymssql-2.1.4-cp35-cp35m-manylinux1_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.5m

pymssql-2.1.4-cp35-cp35m-manylinux1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.5m

pymssql-2.1.4-cp34-cp34m-win_amd64.whl (409.8 kB view hashes)

Uploaded CPython 3.4m Windows x86-64

pymssql-2.1.4-cp34-cp34m-win32.whl (360.0 kB view hashes)

Uploaded CPython 3.4m Windows x86

pymssql-2.1.4-cp34-cp34m-manylinux1_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.4m

pymssql-2.1.4-cp34-cp34m-manylinux1_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.4m

pymssql-2.1.4-cp27-cp27mu-manylinux1_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 2.7mu

pymssql-2.1.4-cp27-cp27mu-manylinux1_i686.whl (1.2 MB view hashes)

Uploaded CPython 2.7mu

pymssql-2.1.4-cp27-cp27m-win_amd64.whl (419.6 kB view hashes)

Uploaded CPython 2.7m Windows x86-64

pymssql-2.1.4-cp27-cp27m-win32.whl (359.0 kB view hashes)

Uploaded CPython 2.7m Windows x86

pymssql-2.1.4-cp27-cp27m-manylinux1_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 2.7m

pymssql-2.1.4-cp27-cp27m-manylinux1_i686.whl (1.2 MB view hashes)

Uploaded CPython 2.7m

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page