本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
运行查询和更改
现在,您已经初步了解了控制台,是时候进一步熟悉 GraphQL 了。在 Amazon 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
(在大括号之间指定)。作为最佳实践,此示例使用 GraphQL 解析器中的autoId()
函数来处理在 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 正常工作,您可以使用客户端应用程序与之交互。要开始使用,请跳至构建客户端应用程序。否则,请参阅下面的其他选项。
后续步骤
既然您已运行了预配置的架构,就可以选择从头开始构建 API、纳入现有数据源或构建客户端应用程序。有关详细信息,请参阅以下章节: