SQLAlchemy：高效查询数据库，仅获取所需列-Python教程-PHP中文网

SQLAlchemy：高效查询数据库，仅获取所需列

花韻仙語

发布： 2025-08-12 18:10:16

原创

606人浏览过

sqlalchemy：高效查询数据库，仅获取所需列

本文旨在帮助开发者在使用 SQLAlchemy 进行数据库查询时，如何仅选择需要的列，避免不必要的数据加载，从而提升性能。我们将对比不同的查询方法，并深入探讨 load_only 选项的使用，以及可能遇到的缓存问题，确保你能够高效地从数据库中获取所需数据。

在使用 SQLAlchemy 进行数据库操作时，有时我们只需要表中的部分列数据，而不是全部列。加载不必要的列会增加数据传输量，影响性能。本文将介绍几种方法，帮助你仅获取所需的列，并探讨可能遇到的问题。

方法一：直接选择需要的列

最直接的方法是在 select 语句中明确指定需要查询的列。

from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy import Column, Integer, String
from sqlalchemy.orm import declarative_base

Base = declarative_base()

class PostSQL(Base):
    __tablename__ = "posts"
    id = Column(Integer, primary_key=True)
    title = Column(String)
    content = Column(String)
    # 假设还有其他列，例如 author, created_at, updated_at

async def get_posts_with_id_title(db: AsyncSession):
    query = select(PostSQL.id, PostSQL.title)
    result = await db.execute(query)
    posts = result.all()
    return posts

# 示例用法
# posts = await get_posts_with_id_title(db_session)
# print(posts) # 输出：[(1, 'hello'), (2, 'hello')]

登录后复制

这种方法会返回一个包含元组的列表，每个元组包含所选列的值。例如，[(1, 'hello'), (2, 'hello')]。这种方式的优点是简单直接，性能较高。

方法二：使用 load_only 选项

另一种方法是使用 load_only 选项。这种方法允许你选择加载哪些列，而 SQLAlchemy 会在查询结果中只填充这些列，其他列保持未加载状态。

LuckyCola工具库

LuckyCola工具库是您工作学习的智能助手，提供一系列AI驱动的工具，旨在为您的生活带来便利与高效。

查看详情

from sqlalchemy.orm import load_only

async def get_posts_with_id_title_load_only(db: AsyncSession):
    query = select(PostSQL).options(load_only(PostSQL.id, PostSQL.title))
    result = await db.execute(query)
    posts = result.scalars().all()
    return posts

# 示例用法
# posts = await get_posts_with_id_title_load_only(db_session)
# print(posts) # 输出：[<app.models.PostSQL object at 0x...>, <app.models.PostSQL object at 0x...>]

登录后复制

这种方法返回的是 PostSQL 对象的列表。理想情况下，这些对象应该只包含 id 和 title 属性的数据。然而，有时你可能会发现对象中包含了所有列的数据，即使使用了 load_only。