From a88b25c59bbffe2e5af5668e695926de73ac21b4 Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Sun, 23 Jan 2022 09:41:52 -0500 Subject: [PATCH] fix bullet indentation, clarify insert independent of DDL Change-Id: I3b6f2b7e23044148e837afdbe4fef66773e42777 (cherry picked from commit 3fc5d28b7999cafc5111ce999a218cd5cd9329a2) --- lib/sqlalchemy/sql/schema.py | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py index 4e8776617e..6240357f54 100644 --- a/lib/sqlalchemy/sql/schema.py +++ b/lib/sqlalchemy/sql/schema.py @@ -1251,7 +1251,11 @@ class Column(DialectKWArgs, SchemaItem, ColumnClause): :class:`.Result` object. This also applies towards use of the ORM when ORM-mapped objects are persisted to the database, indicating that a new integer primary key will be available to - become part of the :term:`identity key` for that object. + become part of the :term:`identity key` for that object. This + behavior takes place regardless of what DDL constructs are + associated with the :class:`_schema.Column` and is independent + of the "DDL Rendering" behavior discussed in the previous note + above. The parameter may be set to ``True`` to indicate that a column which is part of a composite (i.e. multi-column) primary key should @@ -1350,13 +1354,13 @@ class Column(DialectKWArgs, SchemaItem, ColumnClause): * Third-party dialects - consult those dialects' documentation for details on their specific behaviors. - * For multiple-row :func:`_sql.insert` constructs invoked with - a list of parameters (i.e. "executemany" semantics), primary-key - retrieving behaviors are generally disabled, however there may - be special APIs that may be used to retrieve lists of new - primary key values for an "executemany", such as the psycopg2 - "fast insertmany" feature. Such features are very new and - may not yet be well covered in documentation. + * For multiple-row :func:`_sql.insert` constructs invoked with + a list of parameters (i.e. "executemany" semantics), primary-key + retrieving behaviors are generally disabled, however there may + be special APIs that may be used to retrieve lists of new + primary key values for an "executemany", such as the psycopg2 + "fast insertmany" feature. Such features are very new and + may not yet be well covered in documentation. :param default: A scalar, Python callable, or -- 2.47.2