本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
引导式架构向导(可选)
Amazon AppSync 可以指导您完成创建 GraphQL API 的过程,包括部署数据源和连接解析器。此指导性创建方法或向导向您提供了表单生成器界面,通过它,您可在使用 GraphQL 为应用程序创建数据模型以存储在云中时添加或删除属性。
创建并填充你的 API
使用向Amazon AppSync导创建 GraphQL API
-
登录 Amazon Web Services Management Console并打开 AppSync 控制台
。 -
在 API 控制面板中,选择创建 API。
-
在 “入门” 页面的 “自定义您的 API 或从 Amazon DynamoDB 导入” 下,选择 “使用向导创建”。
-
在窗口右侧选择 “开始”。
-
-
选择型号名称。
请注意,您的 GraphQL 操作(即查询、变更和订阅)将使用您的模型的名称。
-
系统会提示您定义模型及其相关字段和功能。模型是一种添加至您的 API 的对象类型,由 Amazon DynamoDB 提供支持,预先配置了 GraphQL 查询、变更和订阅。模型说明您如何定义应用程序的数据类型,以及它们如何存储在云中。模型包含一个或多个字段,用于保存数据类型的特定属性。例如,博客模型可能包含以下字段:
id
title
、和isPublished
。这些字段可以有、的原始类型id
String
,也可以是Boolean
除Amazon AppSync支持的自定义标量之外的字段。使用适合您的模型的逻辑名称和类型添加一个或多个字段。要查看中所有可用的基本体类型Amazon AppSync,请选择 “类型” 下的下拉列表。此外,您可以选中各个字段旁边的一个或两个复选框,将其标记为 List (列表) 或 Required (必需)。
标记为 List (列表) 的类型可容纳多个值。例如,如果您有一个博客文章模型和一个名为的字段
Categories
,则可以将其标记为列表,以便在运行查询时返回多个类别。必需字段在执行 GraphQL 更改时必须输入值作为输入。 -
您可以使用 “配置模型表” 部分
-
选择表名。
请注意,默认表名为 T
able
<Model Name>。您可以在此字段中改写此名称。如果再次更改模型名称,表名也将更改回默认表名。 -
输入主键。Amazon DynamoDB 要求使用它来唯一标识每个条目。
有关更多信息,请参阅主密钥。
-
输入排序键。排序键用作单个主键下的附加标识符或分组,以更好地组织结构。
要查看排序键的示例,请参阅使用排序键组织数据的最佳实践。
-
在 “其他索引” 下,您可以选择添加索引。当您知道需要频繁查询模型中的某些字段时,这会非常有用。例如,如果要经常查询您的博客模型的
isPublished
字段以提供所有已发布的博客,则可以在该字段上创建索引。这会自动为您创建合适的 Amazon DynamoDB 索引和 GraphQL 查询。有关更多信息,请参阅二级索引。
-
选择 Create(创建)。
-
-
在创建资源页面上,输入您的 API 的 API 名称。
API 名称不是唯一的,但用作Amazon AppSync控制台中每个 API 的额外标识符。
-
选择 “创建”,然后将创建资源。
执行 GraphQL
创建资源后,预填充的 GraphQL 变更和查询会在编辑器中打开,供您在Amazon AppSync 控制台的查询页面上运行。选择查询资源管理器顶部的播放按钮,然后选择以 “创建” 开头的选项<model name>。GraphQL 变异会运行并将数据放入你的 Amazon DynamoDB 表中。然后,您再次可以选择播放按钮并选择以 List (列表) 开头的选项,以查看运行 GraphQL 查询的所有记录。
与您的应用程序集成
在您完成控制台教程之后,选择位于左侧的 Amazon AppSync 导航栏的根目录,按照将 GraphQL API 与您的移动或 Web 应用程序集成说明操作。