---
title: "如何将 Django 与旧有的数据库集成"
version: 6.0
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/6.0/howto/legacy-databases/
canonical: https://djangodocs.dev/zh-hans/6.0/howto/legacy-databases/
---
# 如何将 Django 与旧有的数据库集成

虽然 Django 很适合开发新应用，但也能用它集成旧数据库。Django 包含了一整套套件来尽可能自动处理类似的任务。

本文假设你有 Django 基础，基础内容由 [教程](/zh-hans/6.0/intro/tutorial01/) 介绍。

你配置完 Django 后，你就能跟着此常规操作去集成旧数据库了。

## 将数据库参数告诉 Django

你需要告诉 Django 数据库连接参数和数据库名称。通过编写 [`DATABASES`](/zh-hans/6.0/ref/settings/#std-setting-DATABASES) 配置项并为 `'default'` 连接指定下列值：

- [`NAME`](/zh-hans/6.0/ref/settings/#std-setting-NAME)
- [`ENGINE`](/zh-hans/6.0/ref/settings/#std-setting-DATABASE-ENGINE)
- [`USER`](/zh-hans/6.0/ref/settings/#std-setting-USER)
- [`PASSWORD`](/zh-hans/6.0/ref/settings/#std-setting-PASSWORD)
- [`HOST`](/zh-hans/6.0/ref/settings/#std-setting-HOST)
- [`PORT`](/zh-hans/6.0/ref/settings/#std-setting-PORT)

## 自动生成这些模型

Django 自带一个名为 [`inspectdb`](/zh-hans/6.0/ref/django-admin/#django-admin-inspectdb) 的实用程序，可以通过审查现有数据库来创建模型。你可以通过运行以下命令来查看输出：

```shell
$ python manage.py inspectdb
```

通过使用标准的 Unix 输出重定向，将此保存为文件：

```shell
$ python manage.py inspectdb > models.py
```

该功能仅是一个快捷方式，不是最佳的创建模型的方法。参考 [`inspectdb 文档`](/zh-hans/6.0/ref/django-admin/#django-admin-inspectdb) 获取更多信息。

只要你整理完这些模型，就可以将文件重命名为 `models.py` 并将其放入持有应用的 Python 包中。随后，将应用添加至 [`INSTALLED_APPS`](/zh-hans/6.0/ref/settings/#std-setting-INSTALLED_APPS) 配置。

默认情况下， [`inspectdb`](/zh-hans/6.0/ref/django-admin/#django-admin-inspectdb) 创建未托管的模型。也就是说，模型的 `Meta` 类中的 `managed = False` 告诉 Django 不要管理这些表的创建，修改和删除:

```
class Person(models.Model):
    id = models.IntegerField(primary_key=True)
    first_name = models.CharField(max_length=70)

    class Meta:
        managed = False
        db_table = "CENSUS_PERSONS"
```

若你的确想要允许 Django 管理这些表格的生命周期，你需要将上面的 [`managed`](/zh-hans/6.0/ref/models/options/#django.db.models.Options.managed) 选项的值改为 `True` （或者删掉它，因为 `True` 是默认值）。

## 安装核心 Django 表

接下来，运行 [`migrate`](/zh-hans/6.0/ref/django-admin/#django-admin-migrate) 命令来安装任何额外所需的数据库记录，如管理员权限和内容类型：

```shell
$ python manage.py migrate
```

## 测试和调整

这些是基本步骤——这样，你就能调整 Django 生成的模型，直到他们达到你的要求。试着通过 Django 数据库 API 访问数据，试着通过 Django 后台站点编辑数据，也可以直接编辑模型文件。