[1.8.x] Fixed #24177 -- Added documentation about database view support in inspectdb

Backport of bd691f4586 from master
This commit is contained in:
Fabio C. Barrionuevo da Luz 2015-01-18 18:53:18 -03:00 committed by Markus Holtermann
parent 06fa019c1b
commit e69eea73d9
2 changed files with 13 additions and 5 deletions

View File

@ -352,17 +352,17 @@ inspectdb
.. django-admin:: inspectdb
Introspects the database tables in the database pointed-to by the
Introspects the database tables and views in the database pointed-to by the
:setting:`NAME` setting and outputs a Django model module (a ``models.py``
file) to standard output.
Use this if you have a legacy database with which you'd like to use Django.
The script will inspect the database and create a model for each table within
it.
The script will inspect the database and create a model for each table or view
within it.
As you might expect, the created models will have an attribute for every field
in the table. Note that ``inspectdb`` has a few special cases in its field-name
output:
in the table or view. Note that ``inspectdb`` has a few special cases in its
field-name output:
* If ``inspectdb`` cannot map a column's type to a model field type, it'll
use ``TextField`` and will insert the Python comment
@ -405,6 +405,11 @@ it because ``True`` is its default value).
The :djadminopt:`--database` option may be used to specify the
database to introspect.
.. versionadded:: 1.8
A feature to inspect database views was added. In previous versions, only
tables (not views) were inspected.
loaddata <fixture fixture ...>
------------------------------

View File

@ -415,6 +415,9 @@ Management Commands
introspect :class:`~django.db.models.AutoField` for MySQL and PostgreSQL
databases.
* :djadmin:`inspectdb` now introspects database views on all database backends.
In previous versions, only tables (not views) were inspected.
* When calling management commands from code through :ref:`call_command
<call-command>` and passing options, the option name can match the command
line option name (without the initial dashes) or the final option destination