Django的数据库配置以及常见的错误信息

小灰灰 2022-05-19 04:52 213阅读 0赞

记住这些理念之后，让我们来开始 Django 数据库层的探索。 首先，我们需要做些初期配置；我们需要告诉Django使用什么数据库以及如何连接数据库。

我们将假定你已经完成了数据库服务器的安装和激活，并且已经在其中创建了数据库（例如，用 CREATE DATABASE 语句）。 如果你使用SQLite，不需要这步安装，因为SQLite使用文件系统上的独立文件来存储数据。

象前面章节提到的 TEMPLATE\_DIRS 一样，数据库配置也是在Django的配置文件里，缺省 是 settings.py 。 打开这个文件并查找数据库配置：

DATABASE_ENGINE = ''
    DATABASE_NAME = ''
    DATABASE_USER = ''
    DATABASE_PASSWORD = ''
    DATABASE_HOST = ''
    DATABASE_PORT = ''

配置纲要如下。

> DATABASE\_ENGINE 告诉Django使用哪个数据库引擎。 如果你在 Django 中使用数据库， DATABASE\_ENGINE 必须是 Table 5-1 中所列出的值。
> 
> <table>  表 5-1. 数据库引擎设置  
>  <thead> 
>   <tr> 
>    <th>设置</th> 
>    <th>数据库</th> 
>    <th>必要的适配器</th> 
>   </tr> 
>  </thead> 
>  <tbody> 
>   <tr> 
>    <td>`` postgresql``</td> 
>    <td>PostgreSQL</td> 
>    <td>psycopg 1.x版， <a href="http://www.djangoproject.com/r/python-pgsql/1/" rel="nofollow">http://www.djangoproject.com/r/python-pgsql/1/</a>。</td> 
>   </tr> 
>   <tr> 
>    <td>postgresql_psycopg2</td> 
>    <td>PostgreSQL</td> 
>    <td>psycopg 2.x版， <a href="http://www.djangoproject.com/r/python-pgsql/" rel="nofollow">http://www.djangoproject.com/r/python-pgsql/</a>。</td> 
>   </tr> 
>   <tr> 
>    <td>mysql</td> 
>    <td>MySQL</td> 
>    <td>MySQLdb , <a href="http://www.djangoproject.com/r/python-mysql/" rel="nofollow">http://www.djangoproject.com/r/python-mysql/</a>.</td> 
>   </tr> 
>   <tr> 
>    <td>sqlite3</td> 
>    <td>SQLite</td> 
>    <td>如果使用Python 2.5+则不需要适配器。 否则就使用 pysqlite ， <a href="http://www.djangoproject.com/r/python-sqlite/" rel="nofollow">http://www.djangoproject.com/r/python-sqlite/</a>。</td> 
>   </tr> 
>   <tr> 
>    <td>oracle</td> 
>    <td>Oracle</td> 
>    <td>cx_Oracle , <a href="http://www.djangoproject.com/r/python-oracle/" rel="nofollow">http://www.djangoproject.com/r/python-oracle/</a>.</td> 
>   </tr> 
>  </tbody> 
> </table>
> 
> 要注意的是无论选择使用哪个数据库服务器，都必须下载和安装对应的数据库适配器。 访问表 5-1 中“所需适配器”一栏中的链接，可通过互联网免费获取这些适配器。 如果你使用Linux，你的发布包管理系统会提供方便包。 比如说查找\`\` python-postgresql\`\` 或者\`\` python-psycopg\`\` 的软件包。
> 
> 配置示例：

DATABASE_ENGINE = 'postgresql_psycopg2'

> DATABASE\_NAME 将数据库名称告知 Django 。 例如：

DATABASE_NAME = 'mydb'

> 如果使用 SQLite，请对数据库文件指定完整的文件系统路径。 例如：

DATABASE_NAME = '/home/django/mydata.db'

> 对于SQLite数据库的存放，这个例子将其存放在/home/django目录下，你可以使用任意对你来说最便捷的目录。
> 
> DATABASE\_USER 告诉 Django 用哪个用户连接数据库。 例如： 如果用SQLite，空白即可。
> 
> DATABASE\_PASSWORD 告诉Django连接用户的密码。 SQLite 用空密码即可。
> 
> DATABASE\_HOST 告诉 Django 连接哪一台主机的数据库服务器。 如果数据库与 Django 安装于同一台计算机（即本机），可将此项保留空白。 如果你使用SQLite，此项留空。
> 
> 此处的 MySQL 是一个特例。 如果使用的是 MySQL 且该项设置值由斜杠（ '/' ）开头，MySQL 将通过 Unix socket 来连接指定的套接字，例如：

DATABASE_HOST = '/var/run/mysql'

一旦在输入了那些设置并保存之后应当测试一下你的配置。 我们可以在\`\` mysite\`\` 项目目录下执行上章所提到的\`\` python manage.py shell\`\` 来进行测试。 （我们上一章有提到在正确的Django配置前提下，\`\` manager.py shell\`\` 命令是启用Python交互解释器的一种方法。） 这个方法在这里是很有必要的，因为Django可以通过它知晓数据库连接信息的配置文件

输入下面这些命令来测试你的数据库配置：

>>> from django.db import connection
    >>> cursor = connection.cursor()

如果没有显示什么错误信息，那么你的数据库配置是正确的。 否则，你就得 查看错误信息来纠正错误。 表 5-2 是一些常见错误。

<table>  表 5-2. 数据库配置错误信息  
 <thead> 
  <tr> 
   <th>错误信息</th> 
   <th>解决方法</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>You haven’t set the DATABASE_ENGINE setting yet.</td> 
   <td>未正确配置`` DATABASE_ENGINE`` 的值。 表格 5-1 列出可用的值。</td> 
  </tr> 
  <tr> 
   <td>Environment variable DJANGO_SETTINGS_MODULE is undefined.</td> 
   <td>使用`` python manager.py shell`` 命令启动的交互解释器，而非`` python`` 命令启动的交互解释器。</td> 
  </tr> 
  <tr> 
   <td>Error loading _____ module: No module named _____.</td> 
   <td>未安装合适的数据库适配器 (例如, psycopg 或 MySQLdb ).</td> 
  </tr> 
  <tr> 
   <td>_____ isn’t an available database backend.</td> 
   <td>设置正确的 DATABASE_ENGINE 配置。 也许是拼写错误？</td> 
  </tr> 
  <tr> 
   <td>database _____ does not exist</td> 
   <td>设置`` DATABASE_NAME`` 指向存在的数据库，或者先在数据库客户端中执行合适的`` CREATE DATABASE`` 语句创建数据库。</td> 
  </tr> 
  <tr> 
   <td>role _____ does not exist</td> 
   <td>设置`` DATABASE_USER`` 指向存在的用户，或者先在数据库客户端中执创建用户。</td> 
  </tr> 
  <tr> 
   <td>could not connect to server</td> 
   <td>查看DATABASE_HOST和DATABASE_PORT是否已正确配置，并确认数据库服务器是否已正常运行。</td> 
  </tr> 
 </tbody> 
</table>