summaryrefslogtreecommitdiff
path: root/docs/ref/models
diff options
context:
space:
mode:
authorShai Berger <shai@platonix.com>2013-10-21 18:12:48 +0300
committerShai Berger <shai@platonix.com>2013-10-23 15:04:14 +0300
commitcc0dcfc64405419d95e87c8dcc612bd441a8d6de (patch)
treefb324e8a8e53848a666bcb3ad6d54c699b892e50 /docs/ref/models
parent6e413928387a3665a6504339c1c9c464ebff7645 (diff)
Fixed #13245: Explained Oracle's behavior w.r.t db_table
and how to prevent table-name truncation Thanks russellm & timo for discussion, and timo for review. Backported from master 317040a73b77be8f8210801793b2ce6d1a69301e
Diffstat (limited to 'docs/ref/models')
-rw-r--r--docs/ref/models/options.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/ref/models/options.txt b/docs/ref/models/options.txt
index c2a3430c2b..e2a502cf25 100644
--- a/docs/ref/models/options.txt
+++ b/docs/ref/models/options.txt
@@ -67,6 +67,18 @@ Django quotes column and table names behind the scenes.
the table name via ``db_table``, particularly if you are using the MySQL
backend. See the :ref:`MySQL notes <mysql-notes>` for more details.
+.. admonition:: Table name quoting for Oracle
+
+ In order to to meet the 30-char limitation Oracle has on table names,
+ and match the usual conventions for Oracle databases, Django may shorten
+ table names and turn them all-uppercase. To prevent such transformations,
+ use a quoted name as the value for ``db_table``::
+
+ db_table = '"name_left_in_lowercase"'
+
+ Such quoted names can also be used with Django's other supported database
+ backends; except for Oracle, however, the quotes have no effect. See the
+ :ref:`Oracle notes <oracle-notes>` for more details.
``db_tablespace``
-----------------