[SQL-CVS] r2588 - SQLObject/docs

[<sub...@co...>]

Author: phd
Date: 2007-04-24 09:02:56 -0600 (Tue, 24 Apr 2007)
New Revision: 2588

Modified:
   SQLObject/docs/FAQ.txt
Log:
Added an answer and examples to the FAQ on how to use sqlmeta.createSQL.


Modified: SQLObject/docs/FAQ.txt
===================================================================
--- SQLObject/docs/FAQ.txt	2007-04-24 15:01:49 UTC (rev 2587)
+++ SQLObject/docs/FAQ.txt	2007-04-24 15:02:56 UTC (rev 2588)
@@ -506,3 +506,25 @@
 cannot return a list of meaningful objects.
 
 You can use a lower-level machinery available in SQLBuilder_.
+
+How can I specify the MySQL engine to use, or tweak other SQL-engine specific features?
+---------------------------------------------------------------------------------------
+
+You can *ALTER* the table just before creation using the ``sqlmeta``
+attribute ``createSQL``, for example::
+
+    class SomeObject(SQLObject):
+        class sqlmeta:
+            createSQL = { 'mysql' : 'ALTER TABLE some_object ENGINE InnoDB' }
+        # your columns here
+
+Maybe you want to specify the charset too? No problem::
+
+    class SomeObject(SQLObject):
+        class sqlmeta:
+            createSQL = { 'mysql' : '''
+                 ALTER TABLE some_object ENGINE InnoDB;
+                 ALTER TABLE some_object CHARACTER SET utf8
+                     COLLATE utf8_estonian_ci''' }
+        # your columns here
+