x/sqlalchemy-migrate
Code Issues Proposed changes

adding faq section to docs

Browse Source
This commit is contained in:
iElectric 2010-11-16 18:14:43 +01:00
parent 20fce9acd8
commit 47f4b5a619
2 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
docs/faq.rst Normal file
View File

@ -0,0 +1,13 @@
FAQ
===
Q: Adding a **nullable=False** column
**************************************
A: Your table probably already contains data. That means if you add column, it's contents will be NULL.
Thus adding NOT NULL column restriction will trigger IntegrityError on database level.
You have basically two options:
#. Add the column with a default value and then, after it is created, remove the default value property. This does not work for column types that do not allow default values at all (such as 'text' and 'blob' on MySQL).
#. Add the column without NOT NULL so all rows get a NULL value, UPDATE the column to set a value for all rows, then add the NOT NULL property to the column. This works for all column types.

1
docs/index.rst
View File

@ -135,6 +135,7 @@ The versioning API is available as the :ref:`migrate <command-line-usage>` comma
versioning
changeset
tools
faq
.. _`google's summer of code`: http://code.google.com/soc
.. _`Google Code project`: http://code.google.com/p/sqlalchemy-migrate