class Relationship(RelationshipProperty[
Describes an object property that holds a single item or list of items that correspond to a related database table. Public constructor is the :func:`_orm.relationship` function. .. seealso:: :ref:`relationship_config_toplevel` .. versionchanged:: 2.0 Added :class:`_orm.Relationship` as a Declarative compatible subclass for :class:`_orm.RelationshipProperty`.
Class Variable | inherit |
:meta private: |
Inherited from RelationshipProperty
:
Class |
|
Produce boolean, comparison, and other operators for :class:`.RelationshipProperty` attributes. |
Method | __init__ |
Undocumented |
Method | __str__ |
Undocumented |
Method | cascade |
Undocumented |
Method | cascade |
Iterate through instances related to the given instance for a particular 'cascade', starting with this MapperProperty. |
Method | declarative |
Perform class-specific initializaton at early declarative scanning time. |
Method | do |
Perform subclass-specific initialization post-mapper-creation steps. |
Method | instrument |
Hook called by the Mapper to the property to initiate instrumentation of the class attribute managed by this MapperProperty. |
Method | merge |
Merge the attribute represented by this ``MapperProperty`` from source to destination object. |
Instance Variable | active |
Undocumented |
Instance Variable | argument |
Undocumented |
Instance Variable | back |
Undocumented |
Instance Variable | backref |
Undocumented |
Instance Variable | collection |
Undocumented |
Instance Variable | comparator |
Undocumented |
Instance Variable | direction |
Undocumented |
Instance Variable | distinct |
Undocumented |
Instance Variable | doc |
optional documentation string |
Instance Variable | enable |
Undocumented |
Instance Variable | entity |
Return the target mapped entity, which is an inspect() of the class or aliased class that is referred towards. |
Instance Variable | innerjoin |
Undocumented |
Instance Variable | join |
Undocumented |
Instance Variable | lazy |
Undocumented |
Instance Variable | load |
Undocumented |
Instance Variable | local |
Undocumented |
Instance Variable | local |
Undocumented |
Instance Variable | omit |
Undocumented |
Instance Variable | order |
Undocumented |
Instance Variable | passive |
Undocumented |
Instance Variable | passive |
Undocumented |
Instance Variable | post |
Undocumented |
Instance Variable | primaryjoin |
Undocumented |
Instance Variable | query |
Undocumented |
Instance Variable | remote |
Undocumented |
Instance Variable | secondary |
Undocumented |
Instance Variable | secondary |
Undocumented |
Instance Variable | secondaryjoin |
Undocumented |
Instance Variable | single |
Undocumented |
Instance Variable | strategy |
Undocumented |
Instance Variable | sync |
Undocumented |
Instance Variable | synchronize |
Undocumented |
Instance Variable | target |
Undocumented |
Instance Variable | uselist |
Undocumented |
Instance Variable | viewonly |
Undocumented |
Property | cascade |
Return the current cascade setting for this :class:`.RelationshipProperty`. |
Property | mapper |
Return the targeted :class:`_orm.Mapper` for this :class:`.RelationshipProperty`. |
Static Method | _check |
Undocumented |
Method | _add |
Undocumented |
Method | _check |
Undocumented |
Method | _check |
Test that this relationship is legal, warn about inheritance conflicts. |
Method | _columns |
Return True if all columns in the given collection are mapped by the tables referenced by this :class:`.RelationshipProperty`. |
Method | _create |
Undocumented |
Method | _generate |
Interpret the 'backref' instruction to create a :func:`_orm.relationship` complementary to this one. |
Method | _get |
Create the callable that is used in a many-to-one expression. |
Method | _lazy |
Undocumented |
Method | _optimized |
Undocumented |
Method | _persists |
Return True if this property will persist values on behalf of the given mapper. |
Method | _post |
Undocumented |
Method | _process |
Convert incoming configuration arguments to their proper form. |
Method | _set |
Undocumented |
Method | _setup |
Undocumented |
Method | _setup |
Undocumented |
Method | _setup |
Undocumented |
Method | _value |
Return a list of tuples (state, obj) for the given key. |
Method | _warn |
Undocumented |
Method | _with |
Undocumented |
Class Variable | _is |
Undocumented |
Class Variable | _links |
True if this MapperProperty refers to a mapped entity. |
Class Variable | _persistence |
Undocumented |
Instance Variable | _calculated |
Undocumented |
Instance Variable | _cascade |
Undocumented |
Instance Variable | _dependency |
Undocumented |
Instance Variable | _init |
Undocumented |
Instance Variable | _join |
Undocumented |
Instance Variable | _lazy |
Undocumented |
Instance Variable | _legacy |
Undocumented |
Instance Variable | _overlaps |
Undocumented |
Instance Variable | _reverse |
Undocumented |
Instance Variable | _user |
Undocumented |
Property | _clsregistry |
Undocumented |
Property | _clsregistry |
Undocumented |
Property | _clsregistry |
Undocumented |
Property | _effective |
Undocumented |
Property | _is |
Undocumented |
Property | _use |
memoize the 'use_get' attribute of this RelationshipLoader's lazyloader. |
Inherited from _IntrospectsAnnotations
(via RelationshipProperty
):
Method | found |
return a copy of this object to use in declarative when the object is found inside of an Annotated object. |
Class Variable | __slots__ |
Undocumented |
Method | _raise |
Undocumented |
Inherited from StrategizedProperty
(via RelationshipProperty
, _IntrospectsAnnotations
):
Class Method | strategy |
Undocumented |
Method | create |
Produce row processing functions and append to the given set of populators lists. |
Method | post |
Perform instrumentation adjustments that need to occur after init() has completed. |
Method | setup |
Called by Query for the purposes of constructing a SQL statement. |
Class Variable | strategy |
Undocumented |
Instance Variable | strategy |
Undocumented |
Class Method | _strategy |
Undocumented |
Method | _get |
Undocumented |
Method | _get |
Undocumented |
Method | _memoized |
Undocumented |
Method | _memoized |
Undocumented |
Class Variable | _all |
Undocumented |
Instance Variable | _strategies |
Undocumented |
Inherited from MapperProperty
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
):
Method | __repr__ |
Undocumented |
Method | init |
Called after all mappers are created to assemble relationships between mappers and perform other post-mapper-creation initialization steps. |
Method | set |
Set the parent mapper that references this MapperProperty. |
Class Variable | comparator |
The :class:`_orm.PropComparator` instance that implements SQL expression construction on behalf of this mapped attribute. |
Class Variable | info |
Info dictionary associated with the object, allowing user-defined data to be associated with this :class:`.InspectionAttr`. |
Class Variable | is |
Part of the InspectionAttr interface; states this object is a mapper property. |
Class Variable | key |
name of class attribute |
Instance Variable | parent |
the :class:`.Mapper` managing this property. |
Property | class |
Return the class-bound descriptor corresponding to this :class:`.MapperProperty`. |
Method | _memoized |
Info dictionary associated with the object, allowing user-defined data to be associated with this :class:`.InspectionAttr`. |
Class Variable | _cache |
Undocumented |
Instance Variable | _attribute |
behavioral options for ORM-enabled Python attributes |
Instance Variable | _configure |
Undocumented |
Instance Variable | _configure |
Undocumented |
Instance Variable | _has |
Undocumented |
Inherited from HasCacheKey
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
):
Class Method | _generate |
generate cache key dispatcher for a new class. |
Class Method | _generate |
Undocumented |
Method | _gen |
return an optional cache key. |
Method | _generate |
return a cache key. |
Class Variable | _generated |
Undocumented |
Class Variable | _hierarchy |
private attribute which may be set to False to prevent the inherit_cache warning from being emitted for a hierarchy of subclasses. |
Class Variable | _is |
Undocumented |
Inherited from _DeclarativeMapped
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
):
Method | operate |
Operate on an argument. |
Method | reverse |
Reverse operate on an argument. |
Inherited from Mapped
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
):
Method | __delete__ |
Undocumented |
Method | __get__ |
Undocumented |
Method | __set__ |
Undocumented |
Class Method | _empty |
Undocumented |
Inherited from SQLORMOperations
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
):
Method | and_ |
Undocumented |
Method | any |
Undocumented |
Method | has |
Undocumented |
Method | of |
Undocumented |
Inherited from SQLCoreOperations
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
):
Method | __add__ |
Implement the ``+`` operator. |
Method | __and__ |
Implement the ``&`` operator. |
Method | __contains__ |
Undocumented |
Method | __eq__ |
Implement the ``==`` operator. |
Method | __floordiv__ |
Implement the ``//`` operator. |
Method | __ge__ |
Implement the ``>=`` operator. |
Method | __getitem__ |
Implement the [] operator. |
Method | __gt__ |
Implement the ``>`` operator. |
Method | __invert__ |
Implement the ``~`` operator. |
Method | __le__ |
Implement the ``<=`` operator. |
Method | __lt__ |
Implement the ``<`` operator. |
Method | __mod__ |
Implement the ``%`` operator. |
Method | __mul__ |
Implement the ``*`` operator. |
Method | __ne__ |
Implement the ``!=`` operator. |
Method | __neg__ |
Implement the ``-`` operator. |
Method | __or__ |
Implement the ``|`` operator. |
Method | __radd__ |
Implement the ``+`` operator in reverse. |
Method | __rfloordiv__ |
Implement the ``//`` operator in reverse. |
Method | __rmod__ |
Implement the ``%`` operator in reverse. |
Method | __rmul__ |
Implement the ``*`` operator in reverse. |
Method | __rsub__ |
Implement the ``-`` operator in reverse. |
Method | __rtruediv__ |
Implement the ``/`` operator in reverse. |
Method | __sub__ |
Implement the ``-`` operator. |
Method | __truediv__ |
Implement the ``/`` operator. |
Method | all_ |
Produce an :func:`_expression.all_` clause against the parent object. |
Method | any_ |
Produce an :func:`_expression.any_` clause against the parent object. |
Method | asc |
Produce a :func:`_expression.asc` clause against the parent object. |
Method | between |
Produce a :func:`_expression.between` clause against the parent object, given the lower and upper range. |
Method | bool |
Return a custom boolean operator. |
Method | collate |
Produce a :func:`_expression.collate` clause against the parent object, given the collation string. |
Method | concat |
Implement the 'concat' operator. |
Method | contains |
Implement the 'contains' operator. |
Method | desc |
Produce a :func:`_expression.desc` clause against the parent object. |
Method | distinct |
Produce a :func:`_expression.distinct` clause against the parent object. |
Method | endswith |
Implement the 'endswith' operator. |
Method | ilike |
Implement the ``ilike`` operator, e.g. case insensitive LIKE. |
Method | in_ |
Implement the ``in`` operator. |
Method | is_ |
Implement the ``IS`` operator. |
Method | is |
Implement the ``IS DISTINCT FROM`` operator. |
Method | is |
Implement the ``IS NOT`` operator. |
Method | is |
Implement the ``IS NOT DISTINCT FROM`` operator. |
Method | isnot |
Undocumented |
Method | like |
Implement the ``like`` operator. |
Method | match |
Implements a database-specific 'match' operator. |
Method | not |
implement the ``NOT ILIKE`` operator. |
Method | not |
implement the ``NOT IN`` operator. |
Method | not |
implement the ``NOT LIKE`` operator. |
Method | notilike |
Undocumented |
Method | notin_ |
Undocumented |
Method | notlike |
Undocumented |
Method | nulls |
Produce a :func:`_expression.nulls_first` clause against the parent object. |
Method | nulls |
Produce a :func:`_expression.nulls_last` clause against the parent object. |
Method | nullsfirst |
Undocumented |
Method | nullslast |
Undocumented |
Method | op |
Produce a generic operator function. |
Method | regexp |
Implements a database-specific 'regexp match' operator. |
Method | regexp |
Implements a database-specific 'regexp replace' operator. |
Method | startswith |
Implement the ``startswith`` operator. |
Property | _propagate |
Undocumented |
Inherited from ExpressionElementRole
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
):
Method | label |
Undocumented |
Class Variable | _role |
Undocumented |
Inherited from ColumnOperators
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
, ExpressionElementRole
, TypedColumnsClauseRole
, ORMDescriptor
, WriteOnlyMapped
, DynamicMapped
, _MappedAnnotationBase
, _MappedAttribute
):
Method | __lshift__ |
implement the << operator. |
Method | __rshift__ |
implement the >> operator. |
Method | bitwise |
Produce a bitwise AND operation, typically via the ``&`` operator. |
Method | bitwise |
Produce a bitwise LSHIFT operation, typically via the ``<<`` operator. |
Method | bitwise |
Produce a bitwise NOT operation, typically via the ``~`` operator. |
Method | bitwise |
Produce a bitwise OR operation, typically via the ``|`` operator. |
Method | bitwise |
Produce a bitwise RSHIFT operation, typically via the ``>>`` operator. |
Method | bitwise |
Produce a bitwise XOR operation, typically via the ``^`` operator, or ``#`` for PostgreSQL. |
Method | icontains |
Implement the ``icontains`` operator, e.g. case insensitive version of :meth:`.ColumnOperators.contains`. |
Method | iendswith |
Implement the ``iendswith`` operator, e.g. case insensitive version of :meth:`.ColumnOperators.endswith`. |
Method | isnot |
Undocumented |
Method | istartswith |
Implement the ``istartswith`` operator, e.g. case insensitive version of :meth:`.ColumnOperators.startswith`. |
Class Variable | timetuple |
Hack, allows datetime objects to be compared on the LHS. |
Method | _rconcat |
Implement an 'rconcat' operator. |
Inherited from TypingOnly
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
, ExpressionElementRole
, TypedColumnsClauseRole
, ORMDescriptor
, WriteOnlyMapped
, DynamicMapped
, _MappedAnnotationBase
, _MappedAttribute
, ColumnOperators
, Operators
):
Method | __init |
Undocumented |
Inherited from InspectionAttr
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
, ExpressionElementRole
, TypedColumnsClauseRole
, ORMDescriptor
, WriteOnlyMapped
, DynamicMapped
, _MappedAnnotationBase
, _MappedAttribute
, ColumnOperators
, Operators
, TypingOnly
, InspectionAttrInfo
):
Class Variable | is |
True if this object is an instance of :class:`.AliasedClass`. |
Class Variable | is |
True if this object is a Python :term:`descriptor`. |
Class Variable | is |
True if this object is an instance of :class:`.Bundle`. |
Class Variable | is |
True if this object is an instance of :class:`_expression.ClauseElement`. |
Class Variable | is |
True if this object is an instance of :class:`.InstanceState`. |
Class Variable | is |
True if this object is an instance of :class:`_orm.Mapper`. |
Class Variable | is |
Return True if this object is an instance of :class:`_expression.Selectable`. |
Class Variable | _is |
True if this object is an internal proxy object. |
Inherited from MemoizedSlots
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
, ExpressionElementRole
, TypedColumnsClauseRole
, ORMDescriptor
, WriteOnlyMapped
, DynamicMapped
, _MappedAnnotationBase
, _MappedAttribute
, ColumnOperators
, Operators
, TypingOnly
, InspectionAttrInfo
, InspectionAttr
):
Method | __getattr__ |
Undocumented |
Method | _fallback |
Undocumented |
Inherited from Identified
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
, ExpressionElementRole
, TypedColumnsClauseRole
, ORMDescriptor
, WriteOnlyMapped
, DynamicMapped
, _MappedAnnotationBase
, _MappedAttribute
, ColumnOperators
, Operators
, TypingOnly
, InspectionAttrInfo
, InspectionAttr
, MemoizedSlots
):
Class Variable | logger |
Undocumented |
Class Variable | logging |
Undocumented |
Method | _should |
Undocumented |
Method | _should |
Undocumented |
Class Variable | _echo |
Undocumented |
Inherited from SQLRole
(via RelationshipProperty
, _IntrospectsAnnotations
, StrategizedProperty
, MapperProperty
, HasCacheKey
, _DCAttributeOptions
, _DeclarativeMapped
, Mapped
, SQLORMExpression
, SQLORMOperations
, SQLColumnExpression
, SQLCoreOperations
, ExpressionElementRole
, TypedColumnsClauseRole
, ORMDescriptor
, WriteOnlyMapped
, DynamicMapped
, _MappedAnnotationBase
, _MappedAttribute
, ColumnOperators
, Operators
, TypingOnly
, InspectionAttrInfo
, InspectionAttr
, MemoizedSlots
, Identified
, DDLConstraintColumnRole
):
Class Variable | allows |
Undocumented |
Class Variable | uses |
Undocumented |