将 Amazon DynamoDB 与 AWS CLI - AWS Command Line Interface

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

将 Amazon DynamoDB 与 AWS CLI

Amazon DynamoDB 简介

AWS Command Line Interface (AWS CLI) 为所有 AWS 数据库服务提供支持,包括亚马逊 DynamoDB。您可以使用 AWS CLI 进行即兴操作,例如创建表。您还可以使用它在实用工具脚本中嵌入 DynamoDB 操作。

有关将 AWS CLI 与 DynamoDB 配合使用的更多信息,dynamodb请参阅《命令参考》中的。AWS CLI

要列出 DynamoDB 的 AWS CLI 命令,请使用以下命令。

$ aws dynamodb help

先决条件

要运行 dynamodb 命令,您需要:

创建和使用 DynamoDB 表

命令行格式为 DynamoDB 命令名称后接该命令的参数。 AWS CLI 支持参数值的CLI速记语法和完整语法。JSON

下面的示例创建了一个名为 MusicCollection 的表。

$ aws dynamodb create-table \ --table-name MusicCollection \ --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1

您可以使用类似下面的命令向表中添加新行,如以下示例所示。这些示例结合使用了速记语法和。JSON

$ aws dynamodb put-item \ --table-name MusicCollection \ --item '{ "Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"} , "AlbumTitle": {"S": "Somewhat Famous"} }' \ --return-consumed-capacity TOTAL { "ConsumedCapacity": { "CapacityUnits": 1.0, "TableName": "MusicCollection" } }
$ aws dynamodb put-item \ --table-name MusicCollection \ --item '{ "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"} , "AlbumTitle": {"S": "Songs About Life"} }' \ --return-consumed-capacity TOTAL { "ConsumedCapacity": { "CapacityUnits": 1.0, "TableName": "MusicCollection" } }

在单行命令JSON中可能很难组成有效的命令。为了简化此操作, AWS CLI 可以读取JSON文件。例如,考虑以下JSON片段,该片段存储在名expression-attributes.json为的文件中。

{ ":v1": {"S": "No One You Know"}, ":v2": {"S": "Call Me Today"} }

您可以使用此文件通过 query 发出 AWS CLI请求。在下面的示例中,expression-attributes.json 文件的内容用作 --expression-attribute-values 参数的值。

$ aws dynamodb query --table-name MusicCollection \ --key-condition-expression "Artist = :v1 AND SongTitle = :v2" \ --expression-attribute-values file://expression-attributes.json { "Count": 1, "Items": [ { "AlbumTitle": { "S": "Somewhat Famous" }, "SongTitle": { "S": "Call Me Today" }, "Artist": { "S": "No One You Know" } } ], "ScannedCount": 1, "ConsumedCapacity": null }

使用 DynamoDB Local

除了 DynamoDB 之外,您还可以将与 DynamoDB 本地版 AWS CLI 一起使用。DynamoDB Local 是模拟 DynamoDB 服务的小客户端数据库和服务器。DynamoDB Local 允许您编写使用 DynamoDB 的应用程序,而无需操作 D API ynamoDB 网络服务中的任何表或数据。而是将所有API操作重新路由到本地数据库。这样可节省预配置吞吐量、数据存储和数据传输费用。

有关 DynamoDB Local 以及如何将其与一起使用的更多信息,请参阅 AWS CLI《亚马逊 D ynamoD B 开发者指南》的以下部分:

资源

AWS CLI 参考:

服务参考: