入门：创建您的第一个 GraphQL API - Amazon AppSync
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

入门：创建您的第一个 GraphQL API

您可以使用 Amazon AppSync 控制台配置和启动 GraphQL API。GraphQL API 通常需要三个组件：

  1. GraphQL 架构 - 您的 GraphQL 架构是 API 的蓝图。它定义您可以在执行操作时请求的类型和字段。要使用数据填充架构，您必须将数据源连接到 GraphQL API。在该快速入门指南中，我们使用预定义的模型创建一个架构。

  2. 数据源 - 这些资源包含用于填充 GraphQL API 的数据。它可以是 DynamoDB 表、Lambda 函数等。AmazonAppSync 支持多种数据源以构建稳健且可扩展的 GraphQL API。数据源链接到架构中的字段。每次对字段执行请求时，来自源的数据将填充该字段。该机制是由解析器控制的。在该快速入门指南中，我们使用预定义的模型以及架构创建一个数据源。

  3. 解析器 - 解析器负责将架构字段链接到数据源。它们从源中检索数据，然后根据字段定义的内容返回结果。AmazonAppSync 支持使用 JavaScript 和 VTL 编写 GraphQL API 的解析器。在该快速入门指南中，将根据架构和数据源自动生成解析器。我们不会在本节中深入介绍该内容。

Amazon AppSync 支持创建和配置所有 GraphQL 组件。在打开控制台时，您可以使用以下方法创建您的 API：

  1. 设计自定义的 GraphQL API，即通过预定义的模型生成一个 GraphQL API，然后设置新的 DynamoDB 表（数据源）以支持该 API。

  2. 使用空白架构设计 GraphQL API，没有数据源或解析器。

  3. 使用 DynamoDB 表导入数据，并生成架构的类型和字段。

  4. 使用 Amazon AppSync 的 WebSocket 功能和 Pub/Sub 架构开发实时 API。

  5. 使用现有的 GraphQL API（源 API）链接到合并的 API。

注意

我们建议在使用更高级的工具之前查看设计架构一节。这些指南将介绍更简单的示例，从概念上讲，您可以使用这些示例在 Amazon AppSync 中构建更复杂的应用程序。

Amazon AppSync 还支持多种非控制台选项以创建 GraphQL API。其中包括：

  1. Amazon Amplify

  2. Amazon SAM

  3. Amazon CloudFormation

  4. CDK

以下示例将说明如何使用预定义的模型和 DynamoDB 创建 GraphQL API 基本组件。

主题