运行查询和更改 - AWS AppSync
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

运行查询和更改

现在,您已经初步了解了控制台,是时候进一步熟悉 GraphQL 了。在 AWS AppSync 控制台的左侧,选择 Queries (查询) 选项卡。右侧的窗格可让您单击以执行各种操作,包括查询、更改和您的架构已公开的订阅。选择 Mutation (更改) 节点以查看更改。您可以添加新事件到其中,如下所示:createEvent(....):Event。使用此节点可通过 GraphQL 向数据库添加内容。

使用 GraphQL 更改添加数据

您的第一步是添加具有 GraphQL 更改的更多数据。要执行此操作,您可以使用 mutation 关键字,并传递适当参数(类似于函数的工作方式)。您还可以通过将字段放在大括号内,选择要在响应中返回哪些数据。要开始使用,请将以下内容复制到查询编辑器中,然后选择 Run (运行)

mutation add { createEvent( name:"My first GraphQL event" where:"Day 1" when:"Friday night" description:"Catching up with friends" ){ id name where when description } }

记录由 GraphQL 引擎进行分析并由连接到数据源的解析程序插入到 Amazon DynamoDB 表中。(您可以在 DynamoDB 控制台中进行检查。) 请注意,您不必传入 id。将在结果中生成和返回一个 id(在大括号之间指定)。作为最佳实践,此示例为在 DynamoDB 资源上设置的分区键,在 GraphQL 解析程序中使用 autoId() 函数。现在,只需记下返回的 id 值,下一部分会用到它。

使用 GraphQL 查询检索数据

现在数据库中有了记录,您在运行查询时就会得到结果。GraphQL 的一个主要优势是能够指定应用程序在查询中具有的确切的数据要求。此时,只在大括号内添加若干字段,将 id 参数传递给 getEvent(),然后选择顶部的 Run (运行)

query get { getEvent(id:"XXXXXX-XXXX-XXXXXXX-XXXX-XXXXXXXXX"){ name where description } }

此时,仅返回您指定的字段。您也可以尝试列出所有事件,如下所示:

query getAllEvents { listEvents{ items{ id name when } } }

此时,查询显示嵌套类型,并提供可选的查询友好名称 (getAllEvents)。通过添加或删除来进行试验,然后再次运行此查询。完成后,就可以连接客户端应用程序了。

运行应用程序

既然 API 正在运行,您就可以使用客户端应用程序与其交互。AWS AppSync 提供多种编程语言的示例以帮助您开始。在控制台导航左侧的底部,通过选择您 API 的名称转到 Integration (集成) 页面,您将看到平台列表。在底部,为 Event app (事件应用程序) 克隆相应的示例到您的本地工作站,下载配置文件,如果需要,在指令中使用 Amplify CLI,利用您的 API ID 执行代码生成。该配置文件包含开始时要包括的详细信息,如 GraphQL API 的终端节点 URL 和 API 键。当您稍后在生产环境中利用 IAM 或 Amazon Cognito 用户池时,可能会更改此信息。有关更多信息,请参阅安全

后续步骤

既然您已运行了预配置的架构,就可以选择从头开始构建 API、纳入现有数据源或构建客户端应用程序。有关详细信息,请参阅以下章节: