本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
启动示例架构
这一部分介绍如何将AmazonAppSync 控制台用于启动示例架构,并创建、配置 GraphQL API。
启动示例架构
用户可通过 Event App 示例架构创建应用程序,还能在其中输入事件(例如,“去看电影”或“去父母家吃晚饭”)。应用程序用户还能为事件添加评论(例如,“7 点见!”)。此应用程序演示了如何针对 Amazon DynamoDB 中持久状态使用 GraphQL 操作。
若要开始使用,您要创建示例架构并进行预置。
创建 API
-
登录到Amazon Web Services Management Console并打开AppSync 控制台
. -
在 Dashboard (控制面板) 中,选择 Create API (创建 API)。
-
-
在示例列表的底部,确保选择了 Event App。如果未选中,请选择它,然后选择 Start (开始)。
-
输入您 API 的友好名称
-
选择 Create (创建),然后等待预置过程完成。
浏览控制台
在部署架构并预配置资源后,您可以在AmazonAppSync 控制台。您看到的第一个页面是 Queries (查询),其中包含基本查询和更改。
Queries (查询) 页面是控制台中包含的内置设计器,用于编写并运行 GraphQL 查询和更改,包括自检和文档。运行查询和更改中包含了这一点。
架构设计器
在控制台的左侧,选择 Schema (架构) 查看设计器。设计器已加载了您的示例事件架构。代码编辑器有检查错误的功能,您在编写自己的应用程序时也可以使用。
在控制台的右侧显示已创建的 GraphQL 类型,以及不同顶级类型(例如查询)的解析程序。例如,如果在架构中添加新类型(例如,type TODO {...}),你可以有AmazonAppSync 为您预配置 DynamoDB 资源。其中包括可与您的 GraphQL 数据访问模式进行最佳匹配的适当主键、排序键和索引。如果您选择顶部的 Create Resources (创建资源),并从菜单中选择这些用户定义的类型之一,即可在架构设计中选择不同字段选项。现在还不必进行选择,但将来设计架构时可以试一下。
解析程序配置
在架构设计器中,选择字段右侧的某一个解析程序。会打开一个新的页面。这个页面会展示解析程序的经过配置的数据源(控制台的 Data Sources (数据源) 选项卡上有完整列表)以及关联的 Request (请求) 和 Response Mapping Template (响应映射模板) 设计器。针对常见使用案例提供了示例映射模板。您也可以在这里针对各种操作配置自定义逻辑,例如解析 GraphQL 请求的参数、对客户端的分页标记响应,以及自定义 Amazon OpenSearch Service 的查询消息。
函数和数据源
在主导航窗格中,选择 Functions (函数)。列出函数列表和它们附加到的数据源。函数是可以针对数据源运行的单操作。函数包含请求映射模板和响应映射模板。之前在示例架构中展示的解析程序称为单元解析程序。它们直接附加到数据源上。您也可以创建管道解析程序,其中包含在您的 GraphQL 字段上按顺序运行的一个或多个函数。管道解析程序使您能够在单个网络请求中对一个或多个数据源运行操作。您可以在不同的解析程序之间重用逻辑,以及在单个解析程序中混合或匹配数据源以用于不同的使用案例(例如授权或数据聚合)。有关更多信息,请参阅管道解析程序。
设置
在 Settings (设置) 选项卡上,您可以配置 API 的授权方法。有关这些选项的更多信息,请参阅安全。
注意:默认授权模式为 API_KEY,使用 API 密钥测试应用程序。但是,用于生产的 GraphQL API 应使用一种更强的授权模式,例如Amazon Identity and Access Management与 Amazon Cognito 身份池或用户池结合使用。关更多信息,请参阅安全性。
集成
这些区域有:集成页面中总结了设置 API 的步骤,并概述了构建客户端应用程序的下一步。要查找此信息,请选择您的姓名Amazon在左侧导航窗格中的 AppSync 应用程序AmazonAppSync 控制台。在开始使用窗格中,找到名为的一节与您的应用程序集成. 本页提供了有关使用AmazonAmplify 工具链
此页面还列出了示例客户端应用程序(例如,JavaScript、iOS 等)用于测试端到端体验。您可以克隆并下载这些示例,以及您开始使用所需要的配置文件(包含终端节点 URL 等必要信息)。按照上的说明操作Amazon Amplify工具链