在 AWS AppSync 控制台中启动架构 - AWS AppSync

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

在 AWS AppSync 控制台中启动架构

在此示例中，您将创建一个 TodoAPI，允许用户为日常琐事提醒创建Todo项目，例如 Finish task 或者 Pick up groceries。 API这将演示如何在 DynamoDB 表中保持状态的情况下使用 GraphQL 操作。

从概念上讲，创建第一个 GraphQL API 需要三个主要步骤。您必须定义架构（类型和字段），将数据来源附加到字段，然后编写处理业务逻辑的解析器。不过，控制台体验改变了该顺序。我们先定义希望数据来源如何与架构交互，然后定义架构和解析器。

创建你的 GraphQL API

  1. 登录 AWS Management Console 并打开AppSync 控制台。

  2. 在控制面板中，选择创建API。

  3. 选择 GraphQL 后APIs，选择从头开始设计。然后选择下一步。

  4. 对于API名称，将预填充的名称更改为Todo API，然后选择下一步。

    注意

    此处还提供了其他选项，但我们不会在该示例中使用这些选项。

  5. 在指定 GraphQL 资源部分中，执行以下操作：

    1. 选择立即创建由 DynamoDB 表支持的类型。

      注意

      这意味着，我们将创建一个新的 DynamoDB 表以附加为数据来源。

    2. 在模型名称字段中，输入 Todo。

      注意

      我们的第一个要求是，定义我们的架构。该模型名称是类型名称，因此，您真正要做的是创建一个名为 Todo 的 type，该类型将包含在架构中：

      type Todo {}

    3. 在字段下面，执行以下操作：

      1. 创建一个名为 id 的字段，“类型”为 ID，并且“必填”设置为 Yes。

        注意

        这些字段将位于您的 Todo 类型范围内。此处的字段名称指定为 id，类型为 ID!：

        type Todo {
	id: ID!
}

        AWS AppSync 支持针对不同用例的多个标量值。

      2. 通过使用添加新字段，创建 4 个额外的字段，并将Name值设置为 name、when、where 和 description。它们的Type值为 String，Array和Required值设置为 No。它将如下所示：

        Model information form showing fields for a Todo model with ID, name, when, where, and description.
        注意

        完整的类型及其字段如下所示：

        type Todo {
	id: ID!
	name: String
	when: String
	where: String
	description: String
}

        由于我们使用该预定义的模型创建架构，因此，将根据 create、delete 和 update 等类型使用多个样板变更填充该架构，以帮助您轻松填充数据来源。

    4. 在配置模型表下面，输入表名称，例如 TodoAPITable。将主键设置为 id。

      注意

      我们实际上是在创建一个名为的新 DynamoDB 表 TodoAPITable 它将API作为我们的主要数据源附加到。我们的主键设置为以前定义的必填 id 字段。请注意，该新表是空白的，除了分区键以外，该表不包含任何内容。

    5. 选择下一步。

  6. 查看您的更改并选择创建API。请稍等片刻，让 AWS AppSync服务完成您的创建API。

您已经成功创建了一个 GraphQL API 及其架构和 DynamoDB 数据源。总结上述步骤，我们选择创建一个全新的GraphQL API。我们定义了的名称API，然后通过添加第一个类型来添加架构定义。我们定义了类型及其字段，然后选择创建不包含数据的新 DynamoDB 表，以将该数据来源附加到其中的一个字段。