---
title: "Django 使用旧有的数据库"
version: 3.2
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/3.2/howto/legacy-databases/
canonical: https://djangodocs.dev/zh-hans/3.2/howto/legacy-databases/
---
# Django 使用旧有的数据库

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

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

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

## 将数据库参数告诉 Django

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

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

## 自动生成这些模型

Django 自带一个叫做 [`inspectdb`](/zh-hans/3.2/ref/django-admin/#django-admin-inspectdb) 的工具，它可以通过内省已存在的数据库创建对应模型。你能通过运行以下命令看到输出:

```bash
$ python manage.py inspectdb
```

通过标准 Unix 输出重定向将其保存为文件:

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

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

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

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

```bash
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/3.2/ref/models/options/#django.db.models.Options.managed) 选项的值改为 `True` （或者删掉它，因为 `True` 是默认值）。

## 安装核心 Django 表

然后，运行 [`migrate`](/zh-hans/3.2/ref/django-admin/#django-admin-migrate) 命令安装所有额外需要的数据库记录，像是后台权限和内容类型:

```bash
$ python manage.py migrate
```

## 测试和调整

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