Mike Bayer avatar Mike Bayer committed 3ef75b2

crappy docs, lets try that again

Comments (0)

Files changed (2)

lib/sqlalchemy/dialects/mssql/base.py

 --------
 
 SQLAlchemy by default uses OUTPUT INSERTED to get at newly
-generated primary key values via SEQUENCE columns.   MS-SQL does not 
+generated primary key values via IDENTITY columns or other
+server side defaults.   MS-SQL does not 
 allow the usage of OUTPUT INSERTED on tables that have triggers.
 To disable the usage of OUTPUT INSERTED on a per-table basis,
-specify ``implicit_returning=False`` to each :class:`.Table`
-which has sequences::
+specify ``implicit_returning=False`` for each :class:`.Table`
+which has triggers::
 
     Table('mytable', metadata, 
         Column('id', Integer, primary_key=True), 
         __table_args__ = {'implicit_returning':False}
         
         
-This option can also be specified enginewide using the
+This option can also be specified engine-wide using the
 ``implicit_returning=False`` argument on :func:`.create_engine`.
 
 Known Issues

lib/sqlalchemy/engine/__init__.py

         be applied to all connections.  See
         :meth:`~sqlalchemy.engine.base.Connection.execution_options`
 
-    :param implicit_returning=True: When ``False``, the RETURNING
-        feature of the database, if available, will not be used 
-        to fetch newly generated primary key values.   This applies
-        to those backends which support RETURNING or a compatible
-        construct, including Postgresql, Firebird, Oracle, Microsoft
-        SQL Server.  The default behavior is to use a compatible RETURNING
-        construct when a single-row INSERT statement is emitted with no 
-        existing returning() clause in order to fetch newly generated 
-        primary key values.
+    :param implicit_returning=True: When ``True``, a RETURNING-
+        compatible construct, if available, will be used to
+        fetch newly generated primary key values when a single row
+        INSERT statement is emitted with no existing returning() 
+        clause.  This applies to those backends which support RETURNING 
+        or a compatible construct, including Postgresql, Firebird, Oracle, 
+        Microsoft SQL Server.   Set this to ``False`` to disable
+        the automatic usage of RETURNING.
 
     :param label_length=None: optional integer value which limits
         the size of dynamically generated column labels to that many
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.