diff options
| author | Mike Bayer <mike_mp@zzzcomputing.com> | 2022-01-23 09:41:52 -0500 |
|---|---|---|
| committer | Mike Bayer <mike_mp@zzzcomputing.com> | 2022-01-23 09:44:37 -0500 |
| commit | 3fc5d28b7999cafc5111ce999a218cd5cd9329a2 (patch) | |
| tree | c21542e93ab17795a1a9e621e6fd8808784a1f35 /lib/sqlalchemy/sql | |
| parent | 33f71953fcdf3f3e9dd7a498f669010a56a3755d (diff) | |
| download | sqlalchemy-3fc5d28b7999cafc5111ce999a218cd5cd9329a2.tar.gz | |
fix bullet indentation, clarify insert independent of DDL
Change-Id: I3b6f2b7e23044148e837afdbe4fef66773e42777
Diffstat (limited to 'lib/sqlalchemy/sql')
| -rw-r--r-- | lib/sqlalchemy/sql/schema.py | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py index 274da247d..a04fad05d 100644 --- a/lib/sqlalchemy/sql/schema.py +++ b/lib/sqlalchemy/sql/schema.py @@ -1310,7 +1310,11 @@ class Column(DialectKWArgs, SchemaItem, ColumnClause[_T]): :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 @@ -1409,13 +1413,13 @@ class Column(DialectKWArgs, SchemaItem, ColumnClause[_T]): * 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 |