启动示例架构 - AWS AppSync
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

启动示例架构

这一部分介绍如何使用 AWS AppSync 控制台启动示例架构,并创建、配置 GraphQL API。

启动示例架构

用户可通过 Event App 示例架构创建应用程序,还能在其中输入事件(例如,“去看电影”或“去父母家吃晚饭”)。应用程序用户还能为事件添加评论(例如,“7 点见!”)。此应用程序演示了如何针对 Amazon DynamoDB 中的持久状态使用 GraphQL 操作。

若要开始使用,您要创建示例架构并进行预置。

创建 API

  1. 从 https://console.aws.amazon.com/appsync/ 打开 AWS AppSync 控制台。

  2. Dashboard (控制面板) 中,选择 Create API (创建 API)

  3. 在示例列表的底部,确保选择了 Event App。如果未选中,请选择它,然后选择 Start (开始)

  4. 输入您 API 的友好名称

  5. 选择 Create (创建),然后等待预置过程完成。

浏览控制台

在部署架构并预配置资源后,您可以在 AWS AppSync 控制台中使用 GraphQL API。您看到的第一个页面是 Queries (查询),其中包含基本查询和更改。

Queries (查询) 页面是控制台中包含的内置设计器,用于编写并运行 GraphQL 查询和更改,包括自检和文档。运行查询和更改中包含了这一点。

架构设计器

在控制台的左侧,选择 Schema (架构) 查看设计器。设计器已加载了您的示例事件架构。代码编辑器有检查错误的功能,您在编写自己的应用程序时也可以使用。

在控制台的右侧显示已创建的 GraphQL 类型,以及不同顶级类型(例如查询)的解析程序。在架构中添加新类型(例如 type TODO {...})时,可以由 AWS AppSync 为您预置 DynamoDB 资源。其中包括可与您的 GraphQL 数据访问模式进行最佳匹配的适当主键、排序键和索引。如果您选择顶部的 Create Resources (创建资源),并从菜单中选择这些用户定义的类型之一,即可在架构设计中选择不同字段选项。现在还不必进行选择,但将来设计架构时可以试一下。

解析程序配置

在架构设计器中,选择字段右侧的某一个解析程序。会打开一个新的页面。这个页面会展示解析程序的经过配置的数据源(控制台的 Data Sources (数据源) 选项卡上有完整列表)以及关联的 Request (请求)Response Mapping Template (响应映射模板) 设计器。针对常见使用案例提供了示例映射模板。您也可以在这里针对各种操作配置自定义逻辑,例如解析 GraphQL 请求的参数、对客户端的分页标记响应,以及自定义 Amazon Elasticsearch Service 的查询消息。

函数和数据源

在主导航窗格中,选择 Functions (函数)。列出函数列表和它们附加到的数据源。函数是可以针对数据源运行的单操作。函数包含请求映射模板响应映射模板。之前在示例架构中展示的解析程序称为单元解析程序。它们直接附加到数据源上。您也可以创建管道解析程序,其中包含在您的 GraphQL 字段上按顺序运行的一个或多个函数。管道解析程序使您能够在单个网络请求中对一个或多个数据源运行操作。您可以在不同的解析程序之间重用逻辑,以及在单个解析程序中混合或匹配数据源以用于不同的使用案例(例如授权或数据聚合)。有关更多信息,请参阅管道解析程序

设置

Settings (设置) 选项卡上,您可以配置 API 的授权方法。有关这些选项的更多信息,请参阅安全

注意:默认授权模式为 API_KEY,使用 API 密钥测试应用程序。但是,用于生产的 GraphQL API 应使用一种更强的授权模式,例如 AWS Identity and Access Management 与 Amazon Cognito 身份池或用户池结合使用。有关更多信息,请参阅安全

集成

Integration (集成) 页面位于左侧导航栏的根部,简要回顾了设置 API 的步骤,并概述了构建客户端应用程序的下一步。此页面提供了使用 AWS Amplify 工具链的详细信息,用于通过配置和代码生成自动将您的 API 连接到 iOS、Android 和 JavaScript 应用程序。Amplify 工具链提供对从您的本地工作站构建项目的完全支持,包括 GraphQL 预置和 CI/CD 所用的工作流。

此页面还列出了示例客户端应用程序(例如,JavaScript、iOS 等)用于测试端到端体验。您可以克隆并下载这些示例,以及您开始使用所需要的配置文件(包含终端节点 URL 等必要信息)。按照 AWS Amplify 工具链中的说明运行您的应用程序。