summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorFabio C. Barrionuevo da Luz <bnafta@gmail.com>2015-01-18 18:53:18 -0300
committerMarkus Holtermann <info@markusholtermann.eu>2015-01-20 01:09:08 +0100
commite69eea73d94c058728143416058a6257c765a9b8 (patch)
tree920d467fcce5b21866d2d7474724e5b7907af5e1 /docs
parent06fa019c1bac6af934c0c5b7f93e5d837d96aefa (diff)
[1.8.x] Fixed #24177 -- Added documentation about database view support in inspectdb
Backport of bd691f4586c8ad45bd059ff9d3621cbf8afdcdce from master
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/django-admin.txt15
-rw-r--r--docs/releases/1.8.txt3
2 files changed, 13 insertions, 5 deletions
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 <fixture fixture ...>
------------------------------
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
<call-command>` and passing options, the option name can match the command
line option name (without the initial dashes) or the final option destination