diff options
Diffstat (limited to 'lib/sqlalchemy')
| -rw-r--r-- | lib/sqlalchemy/ext/declarative/api.py | 9 | ||||
| -rw-r--r-- | lib/sqlalchemy/sql/schema.py | 20 |
2 files changed, 24 insertions, 5 deletions
diff --git a/lib/sqlalchemy/ext/declarative/api.py b/lib/sqlalchemy/ext/declarative/api.py index b2e8b5afe..d02db7aa5 100644 --- a/lib/sqlalchemy/ext/declarative/api.py +++ b/lib/sqlalchemy/ext/declarative/api.py @@ -42,6 +42,15 @@ def instrument_declarative(cls, registry, metadata): def has_inherited_table(cls): """Given a class, return True if any of the classes it inherits from has a mapped table, otherwise return False. + + This is used in declarative mixins to build attributes that behave + differently for the base class vs. a subclass in an inheritance + hierarchy. + + .. seealso:: + + :ref:`decl_mixin_inheritance` + """ for class_ in cls.__mro__[1:]: if getattr(class_, '__table__', None) is not None: diff --git a/lib/sqlalchemy/sql/schema.py b/lib/sqlalchemy/sql/schema.py index 98a96fd56..fe98138ad 100644 --- a/lib/sqlalchemy/sql/schema.py +++ b/lib/sqlalchemy/sql/schema.py @@ -1061,6 +1061,10 @@ class Column(SchemaItem, ColumnClause): using :class:`.ColumnDefault` as a positional argument with ``for_update=True``. + .. seealso:: + + :ref:`metadata_defaults` - complete discussion of onupdate + :param primary_key: If ``True``, marks this column as a primary key column. Multiple columns can have this flag set to specify composite primary keys. As an alternative, the primary key of a @@ -1095,14 +1099,20 @@ class Column(SchemaItem, ColumnClause): .. seealso:: - :ref:`server_defaults` + :ref:`server_defaults` - complete discussion of server side + defaults :param server_onupdate: A :class:`.FetchedValue` instance - representing a database-side default generation function. This + representing a database-side default generation function, + such as a trigger. This indicates to SQLAlchemy that a newly generated value will be - available after updates. This construct does not specify any DDL - and the implementation is left to the database, such as via a - trigger. + available after updates. This construct does not actually + implement any kind of generation function within the database, + which instead must be specified separately. + + .. seealso:: + + :ref:`triggered_columns` :param quote: Force quoting of this column's name on or off, corresponding to ``True`` or ``False``. When left at its default |