Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

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

Project description

The Original Pymssql Project Has Been Discontinued

This repository has been forked from upstream pymssql and modified to work with both Python 3.7 and 3.8, whilst continuing to build successfully for 2.7 for a short while, for sentimental but quite fundamental reasons.

There is no interest whatsoever in making this work in Windows.

Why Support Python 2 until its dying day?

Folks, upstream pymssql was taken out back and shot because Microsoft released native drivers into the open source. Using MS drivers on SQL Server 2005 requires version 11.0 or earlier of the MS driver, which is nearly impossible to compile on a modern *nix system due to an entire butterfly network of dependencies on long-deprecated system libraries. If you’ve ever tried to compile something non-trivial on Linux during the mid-90s, you’ll know the pain of which I speak.

Why Not Support Windows?

See above. If Microsoft never honored us by gifting us a bunch of deprecated code that hadn’t been maintained for a decade, the upstream pymssql would have been the only game in town and would have happily chugged along. But Microsoft did honor us, which led to the behind-the-courthouse death of pymssql, which led to the earthly hell of trying to compile Microsoft-gathered *nix code that relied on libraries from the early 2000s, et cetera, ad infinitum.

I have zero interest in figuring out how to build pymssql in a Windows CI. If someone wants to work with me to port pymssql to the Commodore 64, the Amiga 500, or Windows 2.1, let us waste no time. But forget Windows >= 3.1.

It must be childishly easy to get the official drivers working on a Windows box anyways.

Build Instructions

One of the reasons the upstream repository became such a tangle of inconsistent and outdated information is that it contained a large amount of build-related cruft that accumulated over the years. And that cruft was in addition to a README that contained build instructions that maybe worked two versions ago.

To avoid this fate, this repository will maintain only those CI configs that are being used to build, test, and deploy this package to PyPi. Currently, that universe consists of one CI, circleci, chosen only because it was the repository of the most valid build instructions at the time this repo was forked from upstream. This may change in the future.

Though this README may provide some additional context, the only set of build instructions that are guaranteed to be valid will be contained in the config file(s) for the current CI system being used. For the branch to which this README document pertains, the CI system is circleci and the build instructions are at .circleci/config.yml

Though referencing a CI configuration file is not as user-friendly as writing a soliloquy, it has the benefit of being verifiably accurate. If the circleci status badge at the top of this README indicates that the last build succeeded, then the circleci build instructions are valid.


The testing suite has been inherited from upstream. While it shows as passing in circleci, it actually fails with multiple errors, and the successful result in circleci appears to be the result of the tests being passed into circleci as shell scripts, whose error-ful exit codes are not being passed to circleci.

Bringing this project under test will be left to a future maintainer, hopefully a future maintainer of the upstream package. This maintainer tested the resulting packages in the maintainer’s use case, and the packages have passed.

Yes, that is anecdotal.

Since the tests do not work, they have been disabled in .circleci/config.yml.

The remainder of this document is from the upstream repository and is likely outdated, especially as it pertains to build instructions. As my kinsfolk say, szerokiej drogi.

Original Pymssql Readme

To build pymssql-linux, you should have:

  • python >= 3.7 including development files.
  • Cython >= 0.29
  • FreeTDS >= 0.95 including development files. Research your OS-specific distribution channels. (Archlinux: freetds, Debian: freetds-common, freetds-dev)
  • gcc

To build, simply run python build in the project root directory.

It is possible to build a binary wheel package of pymssql-linux that pulls in and compiles a known-working version of FreeTDS. This option may become necessary if FreeTDS code evolves in a way that breaks compatibility with pymssql-linux, the development of which is, after all, frozen. Follow the binary wheel build instructions below in this case.

Details about the discontinuation of the original project and a discussion of alternatives to pymssql can be found at:

This fork is being maintained because pymssql works with older SQL Server versions that use deprecated TLS versions 1.0 and 1.1. Alternatives that utilize Microsoft’s native SQL driver require the installation of version 11.0 of the driver, which is difficult to achieve cleanly due to multiple dependencies on deprecated library versions.

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.

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

Building Binary Wheels

To build manylinux Python wheels, ensure you have docker and docker-compose installed, and run the following in the project root directory:

docker-compose up -d
docker exec pymssql-linux_x86_x64_1 ./io/dev/
docker exec pymssql-linux_i686_1 ./io/dev/
docker-compose down

To run unit tests, run the following before bringing the containers down:

docker exec pymssql-linux_x86_x64_1 ./io/dev/
docker exec pymssql-linux_i686_1 ./io/dev/

If the build suceeds, the dist directory in the project root will contain .whl files for Python versions >= 3.7. These can be installed by running pip install <filename.whl>.

Recent Changes

Version 2.1.6 - 2020-06-05 (pymssql-linux)

  • Fix circleci build script
  • Update docker-compose.yml to manylinux2010 images
  • Prepare package for upload to PyPi as pymssql-linux

Version 2.1.5 - 2019-11-27 (pymssql-linux)

  • Add Python 3.8 support.
  • Drop support for Python < 3.6

Version 3.0.3 - 2019-11-15

Fix messages that say “pymssql<=3.0” should be just “<’. Thanks Eric Moyer for reporting.

Versions 3.0.1 & 3.0.2 were released for the same reason, but with various readme typos that pypi now requires a new version release to fix.

Version 3.0 - 2019-11-15

Release “stub” version that errors during install to notify of project’s discontinuation.

To install the last working released version, install with a version specifier like “pymmsql<3.0”. E.g. pip install "pymssql<3.0"

For details and alternatives, see:

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


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

We are trying to find a balance between security and convenience and will be evaluating the situation for future releases. Your feedback is greatly welcome.


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


    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.

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.

Files for pymssql-linux, version 2.1.6
Filename, size File type Python version Upload date Hashes
Filename, size pymssql_linux-2.1.6-cp27-cp27m-manylinux2010_i686.whl (1.1 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp27-cp27m-manylinux2010_x86_64.whl (1.1 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp27-cp27mu-manylinux2010_i686.whl (1.1 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp27-cp27mu-manylinux2010_x86_64.whl (1.1 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp35-cp35m-manylinux2010_i686.whl (1.2 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp35-cp35m-manylinux2010_x86_64.whl (1.3 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp36-cp36m-manylinux2010_i686.whl (1.3 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp36-cp36m-manylinux2010_x86_64.whl (1.3 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp37-cp37m-manylinux2010_i686.whl (1.3 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp37-cp37m-manylinux2010_x86_64.whl (1.3 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp38-cp38-manylinux2010_i686.whl (1.5 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size pymssql_linux-2.1.6-cp38-cp38-manylinux2010_x86_64.whl (1.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size pymssql-linux-2.1.6.tar.gz (172.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page