跳转至

自动查询

跳过 @query 装饰器——框架自动为每个实体生成 by_id 和 by_filter 查询。

AutoQueryConfig

from nexusx import GraphQLHandler, AutoQueryConfig

handler = GraphQLHandler(
    base=SQLModel,
    session_factory=async_session,
    auto_query_config=AutoQueryConfig(),
)

AutoQueryConfig 只保存查询策略，数据库连接由 GraphQLHandler 管理。

你也可以在构造 handler 之前手动注册：

from nexusx import AutoQueryConfig, GraphQLHandler, add_standard_queries

add_standard_queries(
    entities=[User, Post],
    config=AutoQueryConfig(),
    session_factory=async_session,
)
handler = GraphQLHandler(base=SQLModel, session_factory=async_session)

by_id：按主键查单个

为每个有且仅有一个主键字段的实体自动生成：

{ User { by_id(id: 1) { name email } } }
{ Post { by_id(id: 42) { title author { name } } } }

by_filter：按字段过滤

为每个实体生成 FilterInput 类型和过滤查询：

{ User { by_filter(filter: { name: "Alice" }, limit: 5) { id name email } } }
{ Post { by_filter(filter: { author_id: 1 }, limit: 10) { id title } } }

FilterInput 类型的字段与实体字段一一对应（关系字段除外），支持精确匹配过滤。

Tip

by_filter 只支持精确匹配——不支持 LIKE、范围查询或排序。如果需要复杂查询，请写一个自定义的 @query 方法。

限制

Warning

  • by_id 只支持单主键——复合主键的实体不会生成 by_id
  • by_filter 是精确匹配——不支持 LIKE、范围查询或排序
  • session_factory 由 GraphQLHandler 管理，不属于 AutoQueryConfig

与 @query 共存

自动查询和手动 @query / @mutation 可以一起工作：

class Post(SQLModel, table=True):
    # ... 字段定义 ...

    @query
    async def get_recent(cls, days: int = 7) -> list['Post']:
        """自定义查询——自动查询之外"""
        ...

handler = GraphQLHandler(
    base=SQLModel,
    session_factory=async_session,
    auto_query_config=AutoQueryConfig(),
)

此时 GraphQL schema 同时包含：

  • Post.by_id、Post.by_filter——自动生成
  • Post.get_recent——你的自定义查询

回顾

  • AutoQueryConfig 自动为每个实体生成 by_id 和 by_filter 查询
  • 只支持单主键和精确匹配过滤
  • 自动查询和自定义 @query 方法可以在同一个 schema 中共存

下一步