diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index c6031b7d63..48e699b0d9 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -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 ------------------------------ diff --git a/docs/releases/1.8.txt b/docs/releases/1.8.txt index bea98f6524..c89c65de5c 100644 --- a/docs/releases/1.8.txt +++ b/docs/releases/1.8.txt @@ -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 ` and passing options, the option name can match the command line option name (without the initial dashes) or the final option destination