本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将 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
命令,您需要:
安装和配置 AWS CLI。有关更多信息,请参阅安装或更新到最新版本的 AWS CLI 和身份验证和访问凭证。
创建和使用 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 参考:
服务参考:
-
Amazon DynamoDB 开发人员指南中的 DynamoDB Local
-
Amazon DynamoDB 开发人员指南中的将 AWS CLI 与 DynamoDB Local 结合使用