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

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

运行查询和更改

现在,您已经初步了解了控制台,是时候进一步熟悉 GraphQL 了。在AmazonAppSync 控制台选择查询左侧的选项卡。右侧的窗格可让您单击以执行各种操作,包括查询、更改和您的架构已公开的订阅。选择 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(在大括号之间指定)。作为最佳实践,此示例使用autoId()函数在 GraphQL 解析程序中为在 DynamoDB 资源上设置的分区键。现在,只需记下返回的 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 正在运行,您就可以使用客户端应用程序与其交互。AmazonAppSync 提供多种编程语言的示例以帮助您开始。转至集成页面位于左侧控制台导航的根目录,方法是选择你的 API 的名称,你会看到平台列表。在底部,为 Event app (事件应用程序) 克隆相应的示例到您的本地工作站,下载配置文件,如果需要,在指令中使用 Amplify CLI,利用您的 API ID 执行代码生成。该配置文件包含开始时要包括的详细信息,如 GraphQL API 的终端节点 URL 和 API 键。当您稍后在生产环境中利用 IAM 或 Amazon Cognito 用户池时,可能会更改此信息。关更多信息,请参阅安全性

后续步骤

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