Quickstart

Installation

  • Install SQL Server Management Studio or manually install Microsoft Data Access Components (MDAC).

  • Install django-mssql with your favorite Python package manager:

    pip install django-mssql
    
  • Add the DATABASES configuration.

    DATABASES = {
        'default': {
            'NAME': 'my_database',
            'ENGINE': 'sqlserver_ado',
            'HOST': 'dbserver\\ss2008',
            'USER': '',
            'PASSWORD': '',
        }
    }
    

    Note

    Although the project is named django-mssql the python module is named sqlserver_ado.

    Do not include a django.db.backends. prefix. That is only for core backends that are included with Django, not 3rd party backends.

Getting the code

The project code is hosted on Bitbucket

hg clone https://bitbucket.org/Manfre/django-mssql/

Are you planning to contribute? See Contributing to Django-mssql.

Dependencies

Django

Django 1.6 and 1.7 are supported by the current release.

Support for Django 1.5 requires django-mssql v1.5

Python

This backend requires Python 2.6 or newer. Python 3.3+ support has been added and should be considered experimental.

PyWin32

PyWin32 build 212 or newer is required.