生成 API 操作 - Amazon DynamoDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

生成 API 操作

要使用 NoSQL Workbench 构建 DynamoDB CRUD APIs,请选择 Workbench 右上角的 Interface-based operations (基于接口的操作)NoSQL。

选择数据层面操作下拉列表,然后选择要构建的操作。

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

获取项目

要为 Get Item 操作运行或生成代码,请执行以下操作。

  1. 指定分区键值。

  2. 如果要添加投影表达式,请执行以下操作:

    1. 选择 Projection expression (投影表达式)

    2. 选择 Projection expression (投影表达式) 旁边的 +(加号)。

    3. 指定 Attribute name (属性名称)

    
                            显示 putitem 操作生成器的控制台屏幕截图。
  3. 如果要生成代码,请选择 Generate code (生成代码)

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

  4. 如果您希望操作立即运行,请选择 Run (运行)

有关此操作的更多信息,请参阅 PutItem 中的 Amazon DynamoDB API Reference

放置项目

要为 Put Item 操作运行或生成代码,请执行以下操作。

  1. 指定分区键值。

  2. 指定排序键值(如果存在)。

  3. 如果要添加非键属性,请执行以下操作:

    1. 选择 Other attributes (其他属性) 旁边的 +(加号)。

    2. 指定 Attribute name (属性名称)Type (类型)Value (值)

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

    1. 选择 Condition (条件)

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

    3. 如果需要其他条件,请再次选择 Condition (条件)

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

    
                            显示 putitem 操作生成器的控制台屏幕截图。
  5. 如果要生成代码,请选择 Generate code (生成代码)

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

  6. 如果您希望操作立即运行,请选择 Run (运行)

有关此操作的更多信息,请参阅 PutItem 中的 Amazon DynamoDB API Reference

更新项目

要为 Update Item 操作运行或生成代码,请执行以下操作:

  1. 输入分区键值。

  2. 输入排序键值(如果存在)。

  3. Update expression (更新表达式) 中,选择列表中的表达式。

  4. 选择表达式的 +(加号)。

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

  6. 如果要添加更多表达式,请在 Update Expression (更新表达式) 下拉列表中选择另一个表达式,然后选择 +

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

    1. 选择 Condition (条件)

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

    3. 如果需要其他条件,请再次选择 Condition (条件)

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

    
                            显示 updateitem 操作生成器的控制台屏幕截图。
  8. 如果要生成代码,请选择 Generate code (生成代码)

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

  9. 如果您希望操作立即运行,请选择 Run (运行)

有关此操作的更多信息,请参阅 UpdateItem 中的 Amazon DynamoDB API Reference

删除项目

要为 Delete Item 操作运行或生成代码,请执行以下操作。

  1. 输入分区键值。

  2. 输入排序键值(如果存在)。

  3. 如果必须满足条件表达式 Delete Item 操作才能成功,请执行以下操作:

    1. 选择 Condition (条件)

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

    3. 如果需要其他条件,请再次选择 Condition (条件)

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

    
                            显示 deleteitem 操作生成器的控制台屏幕截图。
  4. 如果要生成代码,请选择 Generate code (生成代码)

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

  5. 如果您希望操作立即运行,请选择 Run (运行)

有关此操作的更多信息,请参阅 DeleteItem 中的 Amazon DynamoDB API Reference

Query

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

  1. 指定分区键值。

  2. 如果 Query 操作需要排序键,请执行以下操作:

    1. 选择 Sort key (排序键)

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

  3. 如果并非所有属性都应与操作结果一起返回,请选择 Projection expression (投影表达式)

  4. 选择 +(加号)。

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

  6. 如果需要更多属性,请选择 +

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

    1. 选择 Condition (条件)

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

    3. 如果需要其他条件,请再次选择 Condition (条件)

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

    
                            显示查询操作生成器的控制台屏幕截图。
  8. 如果要生成代码,请选择 Generate code (生成代码)

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

  9. 如果您希望操作立即运行,请选择 Run (运行)

有关此操作的更多信息,请参阅 https://docs.amazonaws.cn/amazondynamodb/latest/APIReference/API_Query.html 中的查询Amazon DynamoDB API Reference。

Scan

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

  1. 如果并非所有属性都应与操作结果一起返回,请选择 Projection expression (投影表达式)

  2. 选择 +(加号)。

  3. 指定要与查询结果一起返回的属性。

  4. 如果需要更多属性,请再次选择 +

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

    1. 选择 Condition (条件)

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

    3. 如果需要其他条件,请再次选择 Condition (条件)

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

  6. 如果要生成代码,请选择 Generate code (生成代码)

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

  7. 如果您希望操作立即运行,请选择 Run (运行)

TransactGetItems

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

  1. 选择 +(加号)。

  2. 按照 获取项目 操作的说明操作。

    指定完操作的详细信息后,如果要添加更多操作,请选择 +(加号)。

    
                            显示 transactgetitems 操作生成器中的加号按钮的控制台屏幕截图。

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

    要删除一项操作,请在列表中选择该操作,然后选择 Delete (删除)(垃圾桶)图标。

  3. 如果要生成代码,请选择 Generate code (生成代码)

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

  4. 如果您希望操作立即运行,请选择 Run (运行)

有关事务的更多信息,请参阅 Amazon DynamoDB 事务

TransactWriteItems

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

  1. Actions (操作) 下拉列表中,选择所需的操作。

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

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

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

    指定完操作的详细信息后,选择 + 按钮。

    
                            显示 transactwriteitems 操作生成器中的加号按钮的控制台屏幕截图。

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

    要删除一项操作,请在列表中选择该操作,然后选择 Delete (删除)(垃圾桶)图标。

    
                            显示操作生成器中的向上箭头和向下箭头以及垃圾桶按钮的控制台屏幕截图。
  2. 如果要生成代码,请选择 Generate code (生成代码)

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

  3. 如果您希望操作立即运行,请选择 Run (运行)

有关事务的更多信息,请参阅 Amazon DynamoDB 事务