GraphQL 查询

GraphQL 查询用于通过项目 API 获取数据。

Archie Core 的 GraphQL 引擎根据您的项目表自动生成查询作为 GraphQL 模式的一部分。所有项目表都可以通过项目端点进行查询。

自动生成的查询

每当将表添加到项目时，都会为该表自动生成两个 GraphQL 查询操作。它们是：

• tableNameById(…) - 接受 id 和任何唯一值作为参数，从数据库中检索单个记录。
• tableNames(…) - 接受 filter、sort、skip、after、before、first、groupBy 和 last，以检策划的记录列表，同时支持分页、关系过滤、排序等。

列表参数

当为列表指定以下查询参数时，Archie Core 会做出响应。

• filter： 根据字段值过滤记录。
• orderBy： [已弃用 - 使用 sort]
• sort： 排序顺序配置。可以是单字段或多字段排序。
• first： 将查询限制为前 N 条记录。默认值和最大值为 5000。
• last： 返回结果中的最后 N 条记录。
• groupBy： 按特定字段的值对返回的记录进行分组。通常与聚合函数（如 count 或 sum）结合使用，以根据类别分析数据。
• after： 返回指定 ID 之后的记录。用于基于游标的分页。
• before： 返回指定 ID 之前的记录。用于基于游标的分页。
• skip： 从结果中跳过 N 条记录。