1. Luke Plant
  2. django

Commits

boul...@bcc190cf-cafb-0310-a4f2-bffc1f526a37  committed feac05d

boulder-oracle-sprint: Added documentation for the db_tablespace options and Oracle coercion of the null option.

  • Participants
  • Parent commits 5fb3730
  • Branches boulder-oracle-sprint

Comments (0)

Files changed (1)

File docs/model-api.txt

View file
 possible values for "no data;" Django convention is to use the empty
 string, not ``NULL``.
 
+Due to database limitations when using the Oracle backend, the ``null=True``
+option will be coerced for string-based fields, and the value ``NULL`` will
+be stored to denote the empty string.
+
 ``blank``
 ~~~~~~~~~
 
 If ``True``, ``django-admin.py sqlindexes`` will output a ``CREATE INDEX``
 statement for this field.
 
+``db_tablespace``
+~~~~~~~~~~~~~~~~~
+
+If this field is indexed, the name of the database tablespace to use for the
+index. The default is the ``db_tablespace`` of the model, if any. If the
+backend doesn't support tablespaces, this option is ignored.
+
 ``default``
 ~~~~~~~~~~~
 
     ``limit_choices_to``     A dictionary of lookup arguments and values (see
                              the `Database API reference`_) that limit the
                              available admin choices for this object. Use this
-                             with functions from the Python ``datetime`` module 
+                             with functions from the Python ``datetime`` module
                              to limit choices of objects by date. For example::
 
                                 limit_choices_to = {'pub_date__lte': datetime.now}
 that aren't allowed in Python variable names -- notably, the hyphen --
 that's OK. Django quotes column and table names behind the scenes.
 
+``db_tablespace``
+-----------------
+
+The name of the database tablespace to use for the model. If the backend
+doesn't support tablespaces, this option is ignored.
+
 ``get_latest_by``
 -----------------