在 Amazon AppSync 控制台中启动架构 - Amazon AppSync
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

在 Amazon AppSync 控制台中启动架构

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

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

创建你的 GraphQL API
  1. 登录 Amazon Web Services Management Console 并打开AppSync 控制台

  2. 控制面板中,选择创建API

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

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

    注意

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

  5. 指定 GraphQL 资源部分中,执行以下操作:

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

      注意

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

    2. 模型名称字段中,输入 Todo

      注意

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

      type Todo {}
    3. 字段下面,执行以下操作:

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

        注意

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

        type Todo { id: ID! }

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

      2. 通过使用添加新字段,创建 4 个额外的字段,并将Name值设置为 namewhenwheredescription。它们的Type值为 StringArrayRequired值设置为 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 }

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

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

      注意

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

    5. 选择下一步

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

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