# GraphQL API GraphQL API 在前面的章节讲到了使用GraphQL 进行实体的定义。 GraphQL 是一种用于API查询的语言，对 API 中的数据提供了一套易于理解的完整描述，使得客户端能够准确地获得它需要的数据。因而可以用于描述数据实体，也可以用于请求想要的数据，得到结果。子图中的数据实体就是使用 GraphQL 接口定义语言（IDL）来描述和定义。 本节来说明如何在HyperGraph 中使用GraphQL查询数据。 查询 在子图 schema.graphql 中，定义了称为实体的类型。对于每种实体类型，将在顶层查询类型上生成一个实体和实体关联的字段。 例子 查询您在实体定义文件中定义的单个Token实体： `{` `token(id: "1") {` `id` `owner` `}}` 注意：查询单个实体时，id字段是必填字段，并且必须是字符串，一般是地址或者Hash等具有唯一标识作用的值。 查询所有Token实体： `tokens {` `id` `owner` `}}` 排序 查询集合时，可以使用orderBy参数按特定属性进行排序。另外，orderDirection可用于指定排序方向，升序表示升序，降序表示降序。 例子 `{` `tokens(orderBy: price, orderDirection: asc) {` `id` `owner` `}}` 分页 查询集合时，可以使用第一个参数从集合的开头进行分页。值得注意的是，默认排序顺序是按ID升序字母和数字顺序排序，而不是按创建时间。 此外，skip参数可用于跳过实体和分页。例如 first：100 显示前100个实体，first：100，skip：100 显示以第100个开始的下100个实体。这跟SQL查询中的 Limit start, number 很像。 查询应避免使用非常大的skip值，因为它们通常速度会很慢。对于检索大量数据，最好根据上一个示例中所示的属性来对实体进行分页。 例子 查询前10个Token： `tokens(first: 10) {` `id` `owner` `}}` 为了查询集合中间的一组实体，可以将skip参数与first参数结合使用，以从集合的开头开始跳过指定数量的实体。 例子 查询10个Token实体，从集合开始偏移10个位置： `tokens(first: 10, skip: 10) {` `id` `owner` `}}` 例子 如果需要检索大量实体，则将查询基于属性并按该属性进行过滤会更有效率。例如，使用以下查询检索大量Token实体的数据： `{` `query manyTokens($lastID: String) {` `tokens(first: 1000, where: { id_gt: $lastID }) {` `id` `owner` `}` `}}` 第一次，它将发送带有 lastID =“” 的查询，并且对于后续请求，会将lastID 设置为上一个请求中最后一个实体的id属性。与使用增加的skip值相比，此方法的性能要好得多。 筛选 您可以在查询中使用where参数来筛选不同的属性。您可以过滤where参数中的多个值，也就是说在where中设置多个条件。 例子 查询失败的 challenge： `{` `challenges(where: { outcome: "failed" }) {` `challenger` `outcome` `application {` `id` `}` `}}` 您可以使用诸如\_gt，\_lte之类的后缀进行值比较： 例子 `{` `applications(where: { deposit_gt: "10000000000" }) {` `id` `whitelisted` `deposit` `}}` 参数后缀的完整列表： `_not` `_gt` `_lt` `_gte` `_lte` `_in` `_not_in` `_contains` `_not_contains` `_starts_with` `_ends_with` `_not_starts_with` `_not_ends_with` 请注意，某些后缀仅适用于特定类型。例如，布尔仅支持\_not，\_in和\_not\_in。 时间遍历查询 您不仅可以查询最新区块中实体的状态（默认情况下是查最新块），还可以查询过去的任意区块的状态。通过在查询的顶层字段中包含block参数，可以通过其块号或其块哈希来指定进行查询的块。 这样的查询结果不会随时间变化，即，无论执行什么时候，在特定的过去的块中查询都将返回相同的结果，但有一个例外，如果您在非常靠近以太坊开始的块中进行查询，如果该区块不在主链上并且链被重组，结果可能会改变。一旦一个块可以被认为是最终确认的，查询的结果将不会改变。 例子 `{` `challenges(block: { number: 8000000 }) {` `challenger` `outcome` `application {` `id` `}` `}}` 该查询将返回challenge实体及其关联的应用程序实体，因为它们在8,000,000块后直接存在。 例子 `{` `challenges(block: { hash: "0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c" }) {` `challenger` `outcome` `application {` `id` `}` `}}` 该查询将返回challenge实体及其关联的应用程序实体，因为它们是在使用给定哈希所对应的块之后直接存在的。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.hg.network/product-chan-pin-bang-zhu/cheng-xu-kai-fa/assemblyscript-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.