DynamoDB にアクセスする

AWS CLI は、http://aws.amazon.com/cli で入手できます。Windows、macOS、または Linux 上で実行できます。AWS CLI をダウンロードしたら、以下の手順に従って、インストールと設定を行います。

コマンドラインの形式は、DynamoDB オペレーション名と、それに続くそのオペレーションのパラメータで構成されます。AWS CLI では、パラメータ値の短縮構文および JSON をサポートしています。

例えば、次のコマンドでは、Music という名前のテーブルを作成します。パーティションキーは Artist で、ソートキーは SongTitle です。(読みやすくするために、このセクションの長いコマンドは、複数の行に分かれています)。

aws dynamodb create-table \
    --table-name Music \
    --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 \
    --table-class STANDARD

次のコマンドでは、新しい項目をテーブルに追加します。この例では、短縮構文と JSON を組み合わせて使用しています。

aws dynamodb put-item \
    --table-name Music \
    --item \
        '{"Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"}}' \
    --return-consumed-capacity TOTAL  

aws dynamodb put-item \
    --table-name Music \
    --item '{
        "Artist": {"S": "Acme Band"},
        "SongTitle": {"S": "Happy Day"},
        "AlbumTitle": {"S": "Songs About Life"} }' \
    --return-consumed-capacity TOTAL

コマンドラインで、有効な JSON を作成するのは難しい場合があります。ただし、AWS CLI で JSON ファイルを読み込むことができます。例えば、key-conditions.json という名前のファイルに格納されている次の JSON コードスニペットがあるとします。

{
    "Artist": {
        "AttributeValueList": [
            {   
                "S": "No One You Know"
            }   
        ],  
        "ComparisonOperator": "EQ"
    },  
    "SongTitle": {
        "AttributeValueList": [
            {   
                "S": "Call Me Today"
            }   
        ],  
        "ComparisonOperator": "EQ"
    }
}

次のように、Query を使用して、AWS CLI リクエストを発行できます。この例では、key-conditions.json ファイルの内容は、--key-conditions パラメータに使用されます。

aws dynamodb query --table-name Music --key-conditions file://key-conditions.json

AWS CLI を使用して、コンピュータで実行されている DynamoDB Local (ダウンロード可能なバージョン) を操作することもできます。これを有効にするには、各コマンドに次のパラメータを追加します。

--endpoint-url http://localhost:8000

次の例では、AWS CLI を使用して、ローカルデータベースのテーブルを一覧表示します。

aws dynamodb list-tables --endpoint-url http://localhost:8000

DynamoDB がデフォルト (8000) 以外のポート番号を使用している場合は、それに応じて --endpoint-url 値を変更する必要があります。