Django は新しいアプリケーションを開発するのに最適ですが、レガシーなデータベースと統合することも可能です。Django には、それを自動化するいくつかのユーティリティが含まれています。
\nこのドキュメントは チュートリアル に書かれているような、Django についての基本的な知識を持っていることを想定しています。
\nDjango のセットアップが完了したら、次の一般的なプロセスに従うことで、既存のデータベースと統合することができます。
\nまず、Django に既存のデータベース接続のパラメータとデータベースの名前を教えてあげる必要があります。そのために、設定ファイルの DATABASES を編集して、'default' 接続の以下のキーに対して値を設定します。
Django には inspectdb と呼ばれるユーティリティが付属しており、既存のデータベースを調査することでモデルを作成できます。次のコマンドを実行すると出力が表示できます。
$ python manage.py inspectdb\n通常の Unix 出力のリダイレクトにより、ファイルとして保存します。
\n$ python manage.py inspectdb > models.py\nこの機能は最終的なモデル生成ではなく、ショートカットとしての手段です。さらなる情報は、documentation of inspectdb を参照してください。
モデルをクリーンアップしたら、ファイルを models.py と名付け、アプリが含まれる Python パッケージの中に配置します。そして、アプリを INSTALLED_APPS の設定に追加します。
デフォルトでは、inspectdb は未管理 (unmanaged) なモデルを作成します。つまり、モデルの Meta クラス内の managed = False により、Django はテーブルの作成・変更・削除を管理しなくなります。
class Person(models.Model):\n id = models.IntegerField(primary_key=True)\n first_name = models.CharField(max_length=70)\n\n class Meta:\n managed = False\n db_table = "CENSUS_PERSONS"\nDjango にテーブルのライフサイクルの管理を行ってほしい場合、上記の managed オプションを True に設定 (あるいは、True がデフォルト値なので削除) できます。
次に、migrate コマンドを実行すると、追加で必要な admin 権限などのデータベースレコードがインストールされます。
$ python manage.py migrate\n以上は基本的なステップです。ここからは、Django が生成したモデルを期待通りに動作するようになるまで微調整することになるでしょう。必要に応じて、Django データベース API 経由でデータにアクセスしたり、Django の admin サイトで objects を編集したり、models ファイルを編集してみてください。
\n