搭配使用 Amazon DynamoDB AWS CLI - AWS Command Line Interface
必要條件建立和使用 DynamoDB 資料表使用 DynamoDB Local資源

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

搭配使用 Amazon DynamoDB AWS CLI

Amazon DynamoDB 簡介

AWS Command Line Interface (AWS CLI) 為所有 AWS 資料庫服務提供支援，包括 Amazon DynamoDB。您可以使 AWS CLI 用即興作業，例如建立資料表。您也可以用其在公用程式指令碼中嵌入 DynamoDB 操作。

如需 AWS CLI 與 DynamoDB 搭配使用的詳細資訊，請參閱AWS CLI 命令參考dynamodb中的。

若要列出適用於 DynamoDB 的 AWS CLI 命令，請使用下列命令。

$ aws dynamodb help

必要條件

若要執行 dynamodb 命令，您需要：

建立和使用 DynamoDB 資料表

命令列格式包含 DynamoDB 命令名稱，隨後接著該命令的參數。 AWS CLI 支援參數值CLI的速記語法，以及 full。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"}
}

您可以使用該檔案來使用 AWS CLI發出 query 請求。在下列範例中，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 之外，您還可以搭配使 AWS CLI 用 DynamoDB 機。DynamoDB Local 是模擬 DynamoDB 服務的小型用戶端資料庫及伺服器。DynamoDB 本機可讓您撰寫使用 DynamoDB 的應用程式API，而無需操作 DynamoDB Web 服務中的任何表格或資料。而是將所有API動作重新路由至本機資料庫。如此可讓您節省佈建輸送、資料儲存和數據傳輸費。

如需有關 DynamoDB 本機以及如何搭配使用它的詳細資訊 AWS CLI，請參閱 Amazon DynamoDB 開發人員指南的以下各節：

資源

AWS CLI 參考：

服務參考：