### 主键（Primary Key） 主键是数据库表中用于唯一标识每一行记录的字段或一组字段。每个表只能有一个主键，并且主键字段不允许有重复值和空值（NULL）。主键确保了数据完整性，同时也能提高查询效率[^1]。 在SQLAlchemy中定义主键的方式如下： ```python from sqlalchemy import Column, Integer, String from sqlalchemy.ext.declarative import declarative_base Base = declarative_base() class User(Base): __tablename__ = 'users' id = Column(Integer, primary_key=True) # 定义id为主键 name = Column(String(50)) age = Column(Integer) ``` 上述代码中，`id`字段被定义为主键，通过`primary_key=True`来指定。该字段将自动创建索引以提升查询性能[^2]。 --- ### 索引（Index） 索引是数据库优化查询速度的重要手段，它类似于书籍的目录结构，允许数据库快速定位符合条件的数据记录。单字段索引适用于单一列上的频繁查询操作[^1]。 在SQLAlchemy中可以为单个字段添加索引，示例如下： ```python from sqlalchemy import Column, Integer, String, Index from sqlalchemy.ext.declarative import declarative_base Base = declarative_base() class Jconfig(Base): __tablename__ = "config" id = Column(Integer, primary_key=True) project_name = Column(String(24), index=True) # 创建project_name字段的索引 path = Column(String(255), index=True) # 创建path字段的索引 ``` 此外，也可以使用`Index()`函数显式地为字段创建索引： ```python Index('idx_project_name', Jconfig.project_name) ``` --- ### 联合索引（Composite Index） 联合索引是指在多个字段上共同建立的索引，也称为复合索引。这种索引对于多条件查询非常有效，因为数据库引擎可以通过一次索引扫描获取多个字段的信息[^1]。 SQLAlchemy中定义联合索引的方式如下： ```python from sqlalchemy import Column, Integer, String, Index from sqlalchemy.ext.declarative import declarative_base Base = declarative_base() class User(Base): __tablename__ = 'users' id = Column(Integer, primary_key=True) name = Column(String(50)) age = Column(Integer) # 创建name和age字段的联合索引 __table_args__ = ( Index('idx_user_name_age', name, age), ) ``` 以上代码通过`Index('idx_user_name_age', name, age)`创建了一个名为`idx_user_name_age`的联合索引，覆盖了`name`和`age`两个字段。当执行`Base.metadata.create_all(engine)`时，会自动在数据库中创建该索引[^2]。 --- ### 示例与实际应用 在MySQL环境中，无论是主键、单字段索引还是联合索引，都可以通过SQL语句手动创建。例如，在已有表上添加联合索引可以使用以下SQL命令： ```sql CREATE INDEX idx_user_name_age ON users (name, age); ``` 此命令将在`users`表上为`name`和`age`字段创建一个联合索引，从而提升基于这两个字段的查询效率[^1]。 在Python SQLAlchemy环境中，除了通过模型类定义索引外，还可以直接执行原生SQL语句进行索引管理。例如： ```python from sqlalchemy import create_engine engine = create_engine('mysql+pymysql://root:password@localhost/testdb') with engine.connect() as conn: conn.execute("CREATE INDEX idx_user_name_age ON users (name, age)") ``` 这种方式适用于需要灵活控制索引创建过程的场景。 --- ### 总结 主键用于唯一标识表中的每一行记录，并自动创建索引以提升查询效率。单字段索引适用于对某一字段频繁查询的场景，而联合索引则针对多字段组合查询的需求，能够显著提高复杂查询的性能。SQLAlchemy提供了多种方式定义索引，包括隐式的`index=True`设置和显式的`Index()`对象声明[^2]。 ---