pymssql

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.

The 2.x branch of pymssql is built on the latest release of FreeTDS which removes many of the limitations found with older FreeTDS versions and the 1.x branch.

Resources

• Docs & Project Home
  • Quick Start
  • FAQ & Troubleshooting
• PyPI Project
• GitHub
• Discussion
• FreeTDS User Guide

Features

• Unicode friendly
• Python 3 friendly
• Works on most popular operating systems
• Written in Cython for performance
• Includes a supported and documented low-level module (_mssql) that you can use instead of the DB-API
• Supports stored procedures with both return values and output parameters
• A comprehensive test suite
• Compatible with cooperative multi-tasking systems (gevent, etc.)
• Can be used to connect to Azure

License

pymssql is licensed under the terms of the GNU LGPL license.

Survey

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

https://www.surveymonkey.com/s/KMQ8BM5

Survey Results

• Excel (.xls) – http://cl.ly/1R0m2B342I0k/download/SurveySummary_04092014.xls
• PDF – http://cl.ly/2P3o1N1K2h3p/download/Data_All_140409.pdf

Documentation

• Introduction
  • Getting started
  • Architecture
  • Supported related software
  • Install
  • Project Discussion
  • Project Status
  • Current Development
• pymssql examples
  • Basic features (strict DB-API compliance)
  • Connecting using Windows Authentication
  • Iterating through results
  • Important note about Cursors
  • Rows as dictionaries
  • Using the with statement (context managers)
  • Calling stored procedures
  • Using pymssql with cooperative multi-tasking systems
• _mssql examples
  • Quickstart usage of various features
  • An example of exception handling
  • Custom message handlers
• Release notes
  • pymssql 2.0.0
• FreeTDS
  • Installation
  • Configuration
• pymssql module reference
  • Module-level symbols
  • Functions
  • Connection class
  • Cursor class
  • Exceptions
• _mssql module reference
  • Module-level symbols
  • Functions
  • MSSQLConnection class
  • MSSQLStoredProcedure class
  • Module-level exceptions
• Migrating from 1.x to 2.x
  • str vs. unicode
  • Handling of uniqueidentifier columns
  • Arguments to pymssql.connect
  • Parameter substitution
• Frequently asked questions
  • Cannot connect to SQL Server
  • Returned dates are not correct
  • Queries return no rows
  • Results are missing columns
  • pymssql does not unserialize DATE and TIME columns to datetime.date and datetime.time instances
  • Shared object “libsybdb.so.3” not found
  • “DB-Lib error message 20004, severity 9: Read from SQL server failed” error appears
  • Unable to use long username and password
  • More troubleshooting
• Building and developing pymssql
  • Building
  • Testing
• FreeTDS and dates
  • Summary
  • Details
• Connecting to Azure SQL Database
• Docker
• Change log
• TODO
  • Documentation

Indices and tables

• Index
• Module Index
• Search Page