ORM 映射类配置

ORM 配置的详细参考，不包括 关系，详情请参阅 关系配置。

要快速了解典型的 ORM 配置，请从 ORM 快速入门。

有关在 SQLAlchemy 中实现的对象关系映射概念的介绍，它首先在 SQLAlchemy Unified 教程中介绍，网址为 使用 ORM 声明式表单定义表元数据。

• 
  ORM 映射类概述
  • 
    ORM 映射样式
    • 
      声明式映射
    • 
      命令式映射
  • 
    映射类基本组件
    • 
      要映射的类
    • 
      table 或其他 from 子句对象
    • 
      properties 字典
    • 
      其他 mapper 配置参数
  • 
    映射的类行为
    • 
      默认构造函数
    • 
      在负载之间保持非映射状态
    • 
      映射类、实例和映射器的运行时内省
      • 
        检查 Mapper 对象
      • 
        检查 Map 实例
• 
  使用声明式映射类
  • 
    声明性映射样式
    • 
      使用声明性基类
    • 
      使用 Decorator 的声明式映射（无声明性基）
  • 
    使用声明式的表配置
    • 
      使用 mapped_column（） 的声明式表
      • 
        使用带注释的声明性表（mapped_column（） 的类型带注释的形式）
      • 
        访问表和元数据
      • 
        声明式表配置
      • 
        具有声明性表的显式架构名称
      • 
        为声明性映射列设置 Load 和 Persistence 选项
      • 
        显式命名声明性映射列
      • 
        将其他列追加到现有的 Declarative 映射类
    • 
      Declarative with Imperative Table（又名 Hybrid Declarative）
      • 
        映射表列的替代属性名称
      • 
        对命令式表列应用 Load、Persistence 和 Mapping 选项
    • 
      使用反射表以声明方式映射
      • 
        使用 DeferredReflection
      • 
        使用 Automap
      • 
        从反射表中自动执行列命名方案
      • 
        映射到一组显式主键列
      • 
        映射表列的子集
  • 
    具有声明式的映射器配置
    • 
      使用 Clarative 定义映射属性
    • 
      具有声明式的映射器配置选项
      • 
        动态构造映射器参数
    • 
      其他声明性映射指令
      • 
        __declare_last__（）
      • 
        __declare_first__（）
      • 
        元数据
      • 
        __抽象__
      • __table_cls__
  • 
    使用 Mixin 组合映射的层次结构
    • 
      增强基础
    • 
      在列中混合
    • 
      混合关系
    • 
      混合 _orm.column_property（） 和其他_orm。MapperProperty 类
    • 
      将 Mixin 和基类与映射继承模式结合使用
      • 
        将 _orm.declared_attr（） 与继承 Table 和 Mapper 参数一起使用
      • 
        使用 _orm.declared_attr（） 生成特定于表的继承列
    • 
      组合来自多个 Mixin 的 Table/Mapper 参数
    • 
      使用 Mixin 的命名约定创建索引和约束
• 
  与 dataclasses 和 attrs 集成
  • 
    声明性数据类映射
    • 
      类级功能配置
    • 
      属性配置
      • 
        列默认值
      • 
        与 Annotated 集成
    • 
      使用 mixin 和抽象超类
    • 
      关系配置
    • 
      使用非映射数据类字段
    • 
      与备用数据类提供程序（如 Pydantic）集成
  • 
    将 ORM 映射应用于现有数据类（使用旧数据类）
    • 
      使用 Declarative With Imperative Table 映射预先存在的数据类
    • 
      使用声明式字段映射预先存在的数据类
      • 
        将声明式 Mixin 与预先存在的数据类一起使用
    • 
      使用 Imperative Mapping 映射预先存在的数据类
  • 
    将 ORM 映射应用于现有 attrs 类
    • 
      将 attrs 与声明性 “Imperative Table” 映射
    • 
      使用 Imperative Mapping 映射 attrs
• 
  SQL 表达式作为映射属性
  • 
    使用混合
  • 
    使用 column_property
    • 
      将 column_property（） 添加到现有的 Declarative 映射类
    • 
      在映射时根据列属性进行撰写
    • 
      将列延迟与 column_property（） 一起使用
  • 
    使用普通描述符
  • 
    查询时 SQL 表达式作为映射属性
• 
  更改属性行为
  • 
    简单验证程序
    • 
      验证（）
  • 
    在核心级别使用自定义数据类型
  • 
    使用描述符和混合
  • 
    同义词
    • 
      同义词（）
  • 
    作员自定义
• 
  复合列类型
  • 
    使用映射的复合列类型
  • 
    复合材料的其他映射形式
    • 
      直接映射列，然后传递给 composite
    • 
      直接映射列，将属性名称传递给 composite
    • 
      命令式映射和命令式表
  • 
    使用旧版非数据类
  • 
    跟踪复合材料上的原位突变
  • 
    重新定义复合材料的比较运算
  • 
    嵌套复合材料
  • 
    复合 API
    • 
      复合（）
• 
  映射类继承层次结构
  • 
    联接表继承
    • 
      具有 Joined 继承的关系
    • 
      加载联接的继承映射
  • 
    单个表继承
    • 
      使用 use_existing_column 解决列冲突
    • 
      使用单个表继承的关系
    • 
      使用 polymorphic_abstract 构建更深的层次结构
    • 
      加载单个继承映射
  • 
    具体表继承
    • 
      混凝土多态加载配置
    • 
      抽象具体类
    • 
      经典和半经典混凝土多晶型
    • 
      与 Concrete 继承的关系
    • 
      加载具体继承映射
• 
  非传统映射
  • 
    将类映射到多个表
  • 
    针对任意子查询映射类
  • 
    一个类的多个映射器
• 
  配置版本计数器
  • 
    简单版本计数
  • 
    自定义版本计数器/类型
  • 
    服务器端版本计数器
  • 
    编程或条件版本计数器
• 
  类映射 API
  • 
    注册表
    • 
      registry.__init__（）
    • registry.as_declarative_base()
    • 
      注册表.configure（）
    • 
      注册表.dispose（）
    • 
      registry.generate_base（）
    • 
      registry.map_declaratively（）
    • 
      registry.map_imperatively（）
    • 
      注册表.mapped（）
    • registry.mapped_as_dataclass()
    • 
      注册表.mappers
    • registry.update_type_annotation_map()
  • 
    add_mapped_attribute（）
  • 
    column_property（）
  • 
    declarative_base（）
  • 
    declarative_mixin（）
  • 
    as_declarative（）
  • 
    mapped_column（）
  • declared_attr
    • declared_attr.cascading
    • declared_attr.directive
  • 
    声明式基础
    • DeclarativeBase.__mapper__
    • DeclarativeBase.__mapper_args__
    • DeclarativeBase.__table__
    • DeclarativeBase.__table_args__
    • DeclarativeBase.__tablename__
    • 
      DeclarativeBase.metadata 元数据
    • 
      DeclarativeBase.registry 注册表
  • 
    声明式 BaseNoMeta
    • DeclarativeBaseNoMeta.__mapper__
    • DeclarativeBaseNoMeta.__mapper_args__
    • DeclarativeBaseNoMeta.__table__
    • DeclarativeBaseNoMeta.__table_args__
    • DeclarativeBaseNoMeta.__tablename__
    • DeclarativeBaseNoMeta.metadata
    • DeclarativeBaseNoMeta.registry
  • 
    has_inherited_table（）
  • 
    synonym_for（）
  • 
    object_mapper（）
  • 
    class_mapper（）
  • 
    configure_mappers（）
  • 
    clear_mappers（）
  • 
    identity_key（）
  • 
    polymorphic_union（）
  • 
    orm_insert_sentinel（）
  • 
    重新构建器 （）
  • 
    映射
    • 
      Mapper.__init__（）
    • 
      Mapper.add_properties（）
    • 
      Mapper.add_property（）
    • Mapper.all_orm_descriptors
    • Mapper.attrs
    • Mapper.base_mapper
    • 
      映射器.c
    • 
      Mapper.cascade_iterator（）
    • Mapper.class_
    • Mapper.class_manager
    • Mapper.column_attrs
    • Mapper.columns
    • 
      Mapper.common_parent（）
    • Mapper.composites
    • Mapper.concrete
    • Mapper.configured
    • Mapper.entity
    • 
      Mapper.get_property（）
    • Mapper.get_property_by_column()
    • Mapper.identity_key_from_instance()
    • Mapper.identity_key_from_primary_key()
    • Mapper.identity_key_from_row()
    • Mapper.inherits
    • Mapper.is_mapper
    • 
      Mapper.is_sibling（）
    • 
      Mapper.isa（）
    • Mapper.iterate_properties
    • Mapper.local_table
    • Mapper.mapped_table
    • 
      映射器.mapper
    • Mapper.non_primary
    • Mapper.persist_selectable
    • Mapper.polymorphic_identity
    • 
      Mapper.polymorphic_iterator（）
    • Mapper.polymorphic_map
    • Mapper.polymorphic_on
    • Mapper.primary_key
    • Mapper.primary_key_from_instance()
    • 
      Mapper.primary_mapper（）
    • 
      映射器关系
    • Mapper.selectable
    • Mapper.self_and_descendants
    • Mapper.single
    • 
      Mapper.同义词
    • Mapper.tables
    • Mapper.validators
    • Mapper.with_polymorphic_mappers
  • 
    MappedAsData类
  • 
    MappedClassProtocol 协议