django / docs / legacy_databases.txt

Integrating with a legacy database

While Django is best suited for developing new applications, it's quite
possible to integrate it into legacy databases. Django includes a couple of
utilities to automate as much of this process as possible.

This document assumes you know the Django basics, as covered in the
`official tutorial`_.

.. _official tutorial: ../tutorial1/

Give Django your database parameters

You'll need to tell Django what your database connection parameters are, and
what the name of the database is. Do that by editing these settings in your
`settings file`_:


.. _settings file: ../settings/
.. _DATABASE_NAME: ../settings/#database-name
.. _DATABASE_ENGINE: ../settings/#database-engine
.. _DATABASE_USER: ../settings/#database-user
.. _DATABASE_PASSWORD: ../settings/#database-password
.. _DATABASE_HOST: ../settings/#database-host
.. _DATABASE_PORT: ../settings/#database-port

Auto-generate the models

Django comes with a utility that can create models by introspecting an existing
database. You can view the output by running this command:: inspectdb

Save this as a file by using standard Unix output redirection:: inspectdb >

This feature is meant as a shortcut, not as definitive model generation. See
the ` documentation`_ for more information.

Once you've cleaned up your models, name the file ```` and put it in
the Python package that holds your app. Then add the app to your
``INSTALLED_APPS`` setting.

.. documentation: ../django_admin/

Install the core Django tables

Next, run the `` syncdb`` command to install any extra needed database
records such as admin permissions and content types:: init

See whether it worked

That's it. Try accessing your data via the Django database API, and try editing
objects via Django's admin site.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.