生成 API 操作 - Amazon DynamoDB
删除表删除 GSI创建表创建 GSI更新表更新 GSI放置项目更新项目删除项目重复项目查询扫描TransactGetItemsTransactWriteItems
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

生成 API 操作

要使用 NoSQL Workbench 生成 DynamoDB CRUD API，请选择 NoSQL Workbench 用户界面左侧的操作生成器。

然后选择打开并选择一个连接。

您可以在操作生成器中执行以下操作：

删除表

要运行 Delete Table 操作，请完成以下步骤。

  1. 在表部分中找到要删除的表。

  2. 从水平省略号菜单中选择删除表。

  3. 输入表名称来确认您要删除该表。

  4. 选择删除。

有关此操作的更多信息，请参阅《Amazon DynamoDB API 参考》中的删除表。

删除 GSI

要运行 Delete GSI 操作，请完成以下步骤。

  1. 在表部分中找到要删除的表的 GSI。

  2. 从水平省略号菜单中选择删除 GSI。

  3. 输入 GSI 名称来确认您要删除该 GSI。

  4. 选择删除。

有关此操作的更多信息，请参阅《Amazon DynamoDB API 参考》中的删除表。

创建表

要运行 Create Table 操作，请完成以下步骤。

  1. 选择表部分旁边的 + 图标。

  2. 输入所需的表名称。

  3. 创建分区键。

  4. 可选：创建排序键。

  5. 要自定义容量设置，请取消选中使用默认容量设置旁边的复选框。

    • 现在，您可以选择已预置或按需容量。

      选中已预置后，您可以设置最小和最大读取和写入容量单位。您还可以启用或禁用自动扩缩。

    • 如果表当前设置为“按需”，您将无法指定预置吞吐量。

    • 如果您从“按需”切换到“已预置”吞吐量，则自动扩缩将自动应用于所有 GSI，其中，最小值：1，最大值：10；目标：70%。

  6. 选择跳过 GSI 并创建可创建此表而不创建 GSI。或者，您可以选择下一步以创建 GSI 以及此新表。

有关此操作的更多信息，请参阅《Amazon DynamoDB API 参考》中的创建表。

创建 GSI

要运行 Create GSI 操作，请完成以下步骤。

  1. 找到要添加 GSI 的表。

  2. 从水平省略号菜单中，选择创建 GSI。

  3. 在索引名称下为 GSI 命名。

  4. 创建分区键。

  5. 可选：创建排序键。

  6. 从下拉列表中选择投影类型选项。

  7. 选择创建 GSI。

有关此操作的更多信息，请参阅《Amazon DynamoDB API 参考》中的创建表。

更新表

要使用 Update Table 操作更新表的容量设置，请执行以下步骤。

  1. 找到您要更新容量设置的表。

  2. 从水平省略号菜单中，选择更新容量设置。

  3. 选择已预置或按需容量。

    选中已预置后，您可以设置最小和最大读取和写入容量单位。您还可以启用或禁用自动扩缩。

  4. 选择更新。

有关此操作的更多信息，请参阅《Amazon DynamoDB API 参考》中的更新表。

更新 GSI

要使用 Update Table 操作更新 GSI 的容量设置，请执行以下步骤。

注意

默认情况下，全局二级索引继承基表的容量设置。仅当基表采用已预置容量模式时，各个全局二级索引才能具有不同的容量模式。在预置模式表创建全局二级索引时，必须根据该索引的预期工作负载指定读取和写入容量单位。有关更多信息，请参阅 全局二级索引的预调配吞吐量注意事项。

  1. 找到您要更新容量设置的 GSI。

  2. 从水平省略号菜单中，选择更新容量设置。

  3. 现在，您可以选择已预置或按需容量。

    选中已预置后，您可以设置最小和最大读取和写入容量单位。您还可以启用或禁用自动扩缩。

  4. 选择更新。

有关此操作的更多信息，请参阅《Amazon DynamoDB API 参考》中的更新表。

放置项目

您可以使用 Put Item 操作创建项目。要为 Put Item 操作执行或生成代码，请执行以下操作。

  1. 找到您要在其中创建项目的表。

  2. 从操作下拉列表中，选择创建项目。

  3. 输入分区键值。

  4. 输入排序键值（如果存在）。

  5. 如果要添加非键属性，请执行以下操作：

    1. 选择 + 添加其他属性。

    2. 指定属性名称、类型和值。

  6. 如果必须满足条件表达式 Put Item 操作才能成功，请执行以下操作：

    1. 选择条件。

    2. 指定属性名称、比较运算符、属性类型和属性值。

    3. 如果需要其他条件，请再次选择条件。

    有关更多信息，请参阅 条件表达式。

  7. 如果要生成代码，请选择生成代码。

    从显示的选项卡中选择所需的语言。现在，您便可复制此代码并在应用程序中使用它。

  8. 如果要立即执行操作，请选择执行。

  9. 如果要保存此操作以供日后使用，选择保存操作，然后输入操作的名称，选择保存。

有关此操作的更多信息，请参见 Amazon DynamoDB API 参考的 PutItem。

更新项目

要为 Update Item 操作执行或生成代码，请执行以下操作：

  1. 找到您要在其中更新项目的表。

  2. 选择项目。

  3. 输入选定表达式的属性名称和属性值。

  4. 如果要添加更多表达式，请在更新表达式下拉列表中选择另一个表达式，然后选择 + 图标。

  5. 如果必须满足条件表达式 Update Item 操作才能成功，请执行以下操作：

    1. 选择条件。

    2. 指定属性名称、比较运算符、属性类型和属性值。

    3. 如果需要其他条件，请再次选择条件。

    有关更多信息，请参阅 条件表达式。

  6. 如果要生成代码，请选择生成代码。

    选择所需语言的选项卡。现在，您便可复制此代码并在应用程序中使用它。

  7. 如果要立即执行操作，请选择执行。

  8. 如果要保存此操作以供日后使用，选择保存操作，然后输入操作的名称，选择保存。

有关此操作的更多信息，请参见 Amazon DynamoDB API 参考的 UpdateItem。

删除项目

要运行 Delete Item 操作，请完成以下步骤。

  1. 找到您要从中删除项目的表。

  2. 选择项目。

  3. 从操作下拉列表中，选择删除项目。

  4. 选择删除以确认您要删除相应项目。

有关此操作的更多信息，请参见 Amazon DynamoDB API 参考的 DeleteItem。

重复项目

您可以创建一个具有相同属性的新项目，从而复制项目。要复制项目，请执行以下操作。

  1. 找到您要在其中复制项目的表。

  2. 选择项目。

  3. 从操作下拉列表中，选择重复项目。

  4. 指定新的分区键。

  5. 指定新的排序键（如果需要）。

  6. 选择运行。

有关此操作的更多信息，请参见 Amazon DynamoDB API 参考的 DeleteItem。

查询

要为 Query 操作执行或生成代码，请执行以下操作。

  1. 从 NoSQL Workbench UI 的顶部选择查询。

  2. 指定分区键值。

  3. 如果 Query 操作需要排序键，请执行以下操作：

    1. 选择排序键。

    2. 指定比较运算符和属性值。

  4. 选择查询以运行此查询操作。如果需要更多选项，请选中更多选项复选框，然后继续执行以下步骤。

  5. 如果并非所有属性都应与操作结果一起返回，请选择投影表达式。

  6. 选择 + 图标。

  7. 输入要与查询结果一起返回的属性。

  8. 如果需要更多属性，请选择 +。

  9. 如果必须满足条件表达式 Query 操作才能成功，请执行以下操作：

    1. 选择条件。

    2. 指定属性名称、比较运算符、属性类型和属性值。

    3. 如果需要其他条件，请再次选择条件。

    有关更多信息，请参阅 条件表达式。

  10. 如果要生成代码，请选择生成代码。

    选择所需语言的选项卡。现在，您便可复制此代码并在应用程序中使用它。

  11. 如果要立即执行操作，请选择执行。

  12. 如果要保存此操作以供日后使用，选择保存操作，然后输入操作的名称，选择保存。

有关此操作的更多信息，请参见 Amazon DynamoDB API 参考的 Query。

扫描

要为 Scan 操作执行或生成代码，请执行以下操作。

  1. 从 NoSQL Workbench UI 的顶部选择扫描。

  2. 选择扫描按钮以执行此基本扫描操作。如果需要更多选项，请选中更多选项复选框，然后继续执行以下步骤。

  3. 指定属性名称可筛选扫描结果。

  4. 如果并非所有属性都应与操作结果一起返回，请选择投影表达式。

  5. 如果必须满足条件表达式扫描操作才能成功，请执行以下操作：

    1. 选择条件。

    2. 指定属性名称、比较运算符、属性类型和属性值。

    3. 如果需要其他条件，请再次选择条件。

    有关更多信息，请参阅 条件表达式。

  6. 如果要生成代码，请选择生成代码。

    选择所需语言的选项卡。现在，您便可复制此代码并在应用程序中使用它。

  7. 如果要立即执行操作，请选择执行。

  8. 如果要保存此操作以供日后使用，选择保存操作，然后输入操作的名称，选择保存。

TransactGetItems

要为 TransactGetItems 操作执行或生成代码，请执行以下操作。

  1. 从 NoSQL Workbench UI 顶部的更多操作下拉列表中，选择 TransactGetItems。

  2. 选择 TransactGetItem 旁边的 + 图标。

  3. 指定分区键。

  4. 指定排序键（如果需要）。

  5. 选择运行可执行操作，选择保存操作可进行保存，或者选择生成代码可为操作生成代码。

有关事务的更多信息，请参阅 Amazon DynamoDB Transactions。

TransactWriteItems

要为 TransactWriteItems 操作执行或生成代码，请执行以下操作。

  1. 从 NoSQL Workbench UI 顶部的更多操作下拉列表中，选择 TransactWriteItems。

  2. 从操作下拉列表中选择一个操作。

  3. 选择 TransactWriteItem 旁边的 + 图标。

  4. 在操作下拉列表中，选择您要执行的操作。

    • 对于 DeleteItem，按照 删除项目 操作的说明操作。

    • 对于 PutItem，按照 放置项目 操作的说明操作。

    • 对于 UpdateItem，按照 更新项目 操作的说明操作。

    要更改操作的顺序，请在左侧列表中选择一项操作，然后选择向上或向下箭头以在列表中将其上移或下移。

    要删除一项操作，请在列表中选择该操作，然后选择删除（垃圾桶）图标。

  5. 选择运行可执行操作，选择保存操作可进行保存，或者选择生成代码可为操作生成代码。

有关事务的更多信息，请参阅 Amazon DynamoDB Transactions。