{"title":"如何将 Django 与旧有的数据库集成","version":"6.0","locale":"zh-hans","docname":"howto/legacy-databases","url":"/zh-hans/6.0/howto/legacy-databases/","canonical":"https://djangodocs.dev/zh-hans/6.0/howto/legacy-databases/","summary":"虽然 Django 很适合开发新应用，但也能用它集成旧数据库。Django 包含了一整套套件来尽可能自动处理类似的任务。 本文假设你有 Django 基础，基础内容由 教程 介绍。 你配置完 Django 后，你就能跟着此常规操作去集成旧数据库了。 将数据库参数告诉 Django Link to this heading #…","html":"<h1>如何将 Django 与旧有的数据库集成<a class=\"heading-anchor\" href=\"#how-to-integrate-django-with-a-legacy-database\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>虽然 Django 很适合开发新应用，但也能用它集成旧数据库。Django 包含了一整套套件来尽可能自动处理类似的任务。</p>\n<p>本文假设你有 Django 基础，基础内容由 <a class=\"reference internal\" href=\"/zh-hans/6.0/intro/tutorial01/\"><span class=\"doc\">教程</span></a> 介绍。</p>\n<p>你配置完 Django 后，你就能跟着此常规操作去集成旧数据库了。</p>\n<section id=\"give-django-your-database-parameters\">\n<h2>将数据库参数告诉 Django<a class=\"heading-anchor\" href=\"#give-django-your-database-parameters\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>你需要告诉 Django 数据库连接参数和数据库名称。通过编写 <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-DATABASES\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">DATABASES</span></code></a> 配置项并为 <code class=\"docutils literal notranslate\"><span class=\"pre\">'default'</span></code> 连接指定下列值：</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-NAME\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">NAME</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-DATABASE-ENGINE\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">ENGINE</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-USER\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">USER</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-PASSWORD\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">PASSWORD</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-HOST\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">HOST</span></code></a></p></li>\n<li><p><a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-PORT\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">PORT</span></code></a></p></li>\n</ul>\n</section>\n<section id=\"auto-generate-the-models\">\n<h2>自动生成这些模型<a class=\"heading-anchor\" href=\"#auto-generate-the-models\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django 自带一个名为 <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/django-admin/#django-admin-inspectdb\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">inspectdb</span></code></a> 的实用程序，可以通过审查现有数据库来创建模型。你可以通过运行以下命令来查看输出：</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>python<span class=\"w\"> </span>manage.py<span class=\"w\"> </span>inspectdb\n</code></pre></div>\n<p>通过使用标准的 Unix 输出重定向，将此保存为文件：</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>python<span class=\"w\"> </span>manage.py<span class=\"w\"> </span>inspectdb<span class=\"w\"> </span>&gt;<span class=\"w\"> </span>models.py\n</code></pre></div>\n<p>该功能仅是一个快捷方式，不是最佳的创建模型的方法。参考 <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/django-admin/#django-admin-inspectdb\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">inspectdb</span> <span class=\"pre\">文档</span></code></a> 获取更多信息。</p>\n<p>只要你整理完这些模型，就可以将文件重命名为 <code class=\"docutils literal notranslate\"><span class=\"pre\">models.py</span></code> 并将其放入持有应用的 Python 包中。随后，将应用添加至 <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">INSTALLED_APPS</span></code></a> 配置。</p>\n<p>默认情况下， <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/django-admin/#django-admin-inspectdb\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">inspectdb</span></code></a> 创建未托管的模型。也就是说，模型的 <code class=\"docutils literal notranslate\"><span class=\"pre\">Meta</span></code> 类中的 <code class=\"docutils literal notranslate\"><span class=\"pre\">managed</span> <span class=\"pre\">=</span> <span class=\"pre\">False</span></code> 告诉 Django 不要管理这些表的创建，修改和删除:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">Person</span><span class=\"p\">(</span><span class=\"n\">models</span><span class=\"o\">.</span><span class=\"n\">Model</span><span class=\"p\">):</span>\n    <span class=\"nb\">id</span> <span class=\"o\">=</span> <span class=\"n\">models</span><span class=\"o\">.</span><span class=\"n\">IntegerField</span><span class=\"p\">(</span><span class=\"n\">primary_key</span><span class=\"o\">=</span><span class=\"kc\">True</span><span class=\"p\">)</span>\n    <span class=\"n\">first_name</span> <span class=\"o\">=</span> <span class=\"n\">models</span><span class=\"o\">.</span><span class=\"n\">CharField</span><span class=\"p\">(</span><span class=\"n\">max_length</span><span class=\"o\">=</span><span class=\"mi\">70</span><span class=\"p\">)</span>\n\n    <span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">Meta</span><span class=\"p\">:</span>\n        <span class=\"n\">managed</span> <span class=\"o\">=</span> <span class=\"kc\">False</span>\n        <span class=\"n\">db_table</span> <span class=\"o\">=</span> <span class=\"s2\">&quot;CENSUS_PERSONS&quot;</span>\n</code></pre></div>\n<p>若你的确想要允许 Django 管理这些表格的生命周期，你需要将上面的 <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/models/options/#django.db.models.Options.managed\" title=\"django.db.models.Options.managed\"><code class=\"xref py py-attr docutils literal notranslate\"><span class=\"pre\">managed</span></code></a> 选项的值改为 <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code> （或者删掉它，因为 <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code> 是默认值）。</p>\n</section>\n<section id=\"install-the-core-django-tables\">\n<h2>安装核心 Django 表<a class=\"heading-anchor\" href=\"#install-the-core-django-tables\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>接下来，运行 <a class=\"reference internal\" href=\"/zh-hans/6.0/ref/django-admin/#django-admin-migrate\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">migrate</span></code></a> 命令来安装任何额外所需的数据库记录，如管理员权限和内容类型：</p>\n<div class=\"code-block\" data-language=\"shell\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Shell code\"><code>$<span class=\"w\"> </span>python<span class=\"w\"> </span>manage.py<span class=\"w\"> </span>migrate\n</code></pre></div>\n</section>\n<section id=\"test-and-tweak\">\n<h2>测试和调整<a class=\"heading-anchor\" href=\"#test-and-tweak\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>这些是基本步骤——这样，你就能调整 Django 生成的模型，直到他们达到你的要求。试着通过 Django 数据库 API 访问数据，试着通过 Django 后台站点编辑数据，也可以直接编辑模型文件。</p>\n</section>","rootId":"how-to-integrate-django-with-a-legacy-database","toc":[{"title":"将数据库参数告诉 Django","anchor":"give-django-your-database-parameters","children":[]},{"title":"自动生成这些模型","anchor":"auto-generate-the-models","children":[]},{"title":"安装核心 Django 表","anchor":"install-the-core-django-tables","children":[]},{"title":"测试和调整","anchor":"test-and-tweak","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"如何引导","url":"/zh-hans/6.0/howto/"}],"prev":{"docname":"howto/initial-data","title":"如何为模型提供初始数据","url":"/zh-hans/6.0/howto/initial-data/"},"next":{"docname":"howto/custom-model-fields","title":"编写自定义模型字段","url":"/zh-hans/6.0/howto/custom-model-fields/"},"formats":{"html":"/zh-hans/6.0/howto/legacy-databases/","markdown":"/zh-hans/6.0/howto/legacy-databases.md","json":"/zh-hans/6.0/howto/legacy-databases.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/legacy-databases.txt","official":"https://docs.djangoproject.com/zh-hans/6.0/howto/legacy-databases/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}