https://github.com/pymssql/pymssql
Official home for the pymssql source code.
https://github.com/pymssql/pymssql
Last synced: 7 months ago
JSON representation
Official home for the pymssql source code.
- Host: GitHub
- URL: https://github.com/pymssql/pymssql
- Owner: pymssql
- License: lgpl-2.1
- Created: 2013-09-09T15:10:18.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2025-04-15T02:46:28.000Z (8 months ago)
- Last Synced: 2025-05-03T01:50:53.610Z (7 months ago)
- Language: Python
- Homepage: https://pymssql.readthedocs.io/en/latest/
- Size: 10.7 MB
- Stars: 855
- Watchers: 43
- Forks: 311
- Open Issues: 181
-
Metadata Files:
- Readme: README.rst
- Changelog: ChangeLog.old
- License: LICENSE
Awesome Lists containing this project
- awesome-python-zh - pymssql - Microsoft SQL Server的简单数据库接口。 (数据库驱动程序)
- fucking-awesome-python - pymssql - A simple database interface to Microsoft SQL Server. (Database Drivers)
- awesome-python - pymssql - A simple database interface to Microsoft SQL Server. (Database Drivers)
- awesome-drone - pymssql - A simple database interface to Microsoft SQL Server. (Database Drivers / ASGI Servers)
README
pymssql - DB-API interface to Microsoft SQL Server
==================================================
.. image:: https://github.com/pymssql/pymssql/workflows/Linux/badge.svg
:target: https://github.com/pymssql/pymssql/actions?query=workflow%3A%22Linux%22
.. image:: https://github.com/pymssql/pymssql/workflows/macOS/badge.svg
:target: https://github.com/pymssql/pymssql/actions?query=workflow%3A%22macOS%22
.. image:: https://github.com/pymssql/pymssql/workflows/Windows/badge.svg
:target: https://github.com/pymssql/pymssql/actions?query=workflow%3A%22Windows%22
.. image:: http://img.shields.io/pypi/dm/pymssql.svg
:target: https://pypi.python.org/pypi/pymssql/
.. image:: http://img.shields.io/pypi/v/pymssql.svg
:target: https://pypi.python.org/pypi/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`_.
.. _Microsoft SQL Server: http://www.microsoft.com/sqlserver/
.. _Python: http://www.python.org/
.. _PEP-249: http://www.python.org/dev/peps/pep-0249/
.. _FreeTDS: http://www.freetds.org/
Detailed information on pymssql is available on the website:
`pymssql.readthedocs.io `_
New development is happening on GitHub at:
`github.com/pymssql/pymssql `_
There is a Google Group for discussion at:
`groups.google.com `_
Getting started
===============
pymssql wheels are available from PyPi. To install it run:
.. code-block:: bash
pip install -U pip
pip install pymssql
Most of the times this should be all what's needed.
The official pymssql wheels bundle a static copy of FreeTDS
and have SSL support so they can be used to connect to Azure.
.. note::
On some Linux distributions `pip` version is too old to support all
the flavors of manylinux wheels, so upgrading `pip` is necessary.
An example of such distributions would be Ubuntu 18.04 or
Python3.6 module in RHEL8 and CentOS8.
Basic example
=============
.. code-block:: python
conn = pymssql.connect(server, user, password, "tempdb")
cursor = conn.cursor(as_dict=True)
cursor.execute('SELECT * FROM persons WHERE salesrep=%s', 'John Doe')
for row in cursor:
print("ID=%d, Name=%s" % (row['id'], row['name']))
conn.close()