AWS Cloud9 の Amazon DynamoDB チュートリアル

AWS CLI または AWS CloudShell の認証情報管理を設定して、AWS CLI、AWS CloudShell、またはその両方を環境にインストールするには、「AWS CLI および AWS CloudShell のサンプル」のステップ 1 および 2 に従います。AWS CLI、AWS CloudShell、またはその両方を既に環境にインストールして設定している場合は、再度実行する必要はありません。

環境のターミナルセッションから DynamoDB list-tables コマンドを実行して、DynamoDB テーブルが存在する場合はそれをリストし、AWS CLI、aws-shell、またはその両方のインストールと設定をテストします。新しいターミナルセッションを開始するには、メニューバーで、[Windows (ウィンドウ)]、[New Terminal (新しいターミナル)] の順に選択します。

aws dynamodb list-tables # For the AWS CLI.
dynamodb list-tables     # For the aws-shell.

このコマンドが正常に実行されると、既存の DynamoDB テーブル (ある場合) のリストが TableNames 配列として出力されます。まだ DynamoDB テーブルがない場合、TableNames 配列は空になります。

{
  "TableNames": []
}

DynamoDB テーブルがある場合は、TableNames 配列にテーブル名のリストが表示されます。

weather-item.json という名前のファイルを作成し、次の内容を記述します。新規ファイルを作成するには、メニューバーで [File (ファイル)]、[New File (新規ファイル)] の順に選択します。ファイルを保存するには、［File (ファイル)］、［Save (保存)］の順に選択します。

{
  "CityID": { "N": "1" },
  "Date": { "S": "2017-04-12" },
  "City": { "S": "Seattle" },
  "State": { "S": "WA" },
  "Conditions": { "S": "Rain" },
  "Temperatures": { "M": {
      "HighF": { "N": "59" },
      "LowF": { "N": "46" }
    }
  }
}

このコードでは、N は数値である属性値です。S は文字列の属性値です。M はマップ属性であり、一連の属性と値のペアです。項目を操作する場合は常に属性のデータ型を指定する必要があります。その他の使用可能な属性のデータ型については、データ型のAmazon DynamoDB デベロッパーガイドのデータ型を参照してください。

テーブル名 (--table-name) と JSON 形式の項目のパス (--item) を指定して DynamoDB put-item コマンドを実行します。

aws dynamodb put-item \
--table-name Weather \
--item file://weather-item.json

コマンドが成功すると、エラーなしで実行され、確認メッセージは表示されません。

テーブルの現在のコンテンツを確認するには、テーブルの名前 (--table-name) を指定して DynamoDB scan コマンドを実行します。

aws dynamodb scan --table-name Weather

コマンドが成功した場合は、テーブルおよび追加した項目に関する概要情報が表示されます。

more-weather-items.json という名前のファイルを作成し、次の内容を記述します。

{
  "Weather": [
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "1" },
          "Date": { "S": "2017-04-13" },
          "City": { "S": "Seattle" },
          "State": { "S": "WA" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "52" },
              "LowF": { "N": "43" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "1" },
          "Date": { "S": "2017-04-14" },
          "City": { "S": "Seattle" },
          "State": { "S": "WA" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "49" },
              "LowF": { "N": "43" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "2" },
          "Date": { "S": "2017-04-12" },
          "City": { "S": "Portland" },
          "State": { "S": "OR" },
          "Conditions": { "S": "Thunderstorms" },
          "Temperatures": { "M": {
              "HighF": { "N": "59" },
              "LowF": { "N": "43" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "2" },
          "Date": { "S": "2017-04-13" },
          "City": { "S": "Portland" },
          "State": { "S": "OR" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "51" },
              "LowF": { "N": "41" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "2" },
          "Date": { "S": "2017-04-14" },
          "City": { "S": "Portland" },
          "State": { "S": "OR" },
          "Conditions": { "S": "Rain Showers" },
          "Temperatures": { "M": {
              "HighF": { "N": "49" },
              "LowF": { "N": "39" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "3" },
          "Date": { "S": "2017-04-12" },
          "City": { "S": "Portland" },
          "State": { "S": "ME" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "59" },
              "LowF": { "N": "40" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "3" },
          "Date": { "S": "2017-04-13" },
          "City": { "S": "Portland" },
          "State": { "S": "ME" },
          "Conditions": { "S": "Partly Sunny" },
          "Temperatures": { "M": {
              "HighF": { "N": "54" },
              "LowF": { "N": "37" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "3" },
          "Date": { "S": "2017-04-14" },
          "City": { "S": "Portland" },
          "State": { "S": "ME" },
          "Conditions": { "S": "Mostly Sunny" },
          "Temperatures": { "M": {
              "HighF": { "N": "53" },
              "LowF": { "N": "37" }
            }
          }
        }
      }
    }
  ]
}

このコードでは、前のステップで定義された単一の項目と同様に、8 つの Item オブジェクトがテーブルに追加する 8 つの項目を定義します。ただし、次のステップで DynamoDBbatch-write-item コマンドを実行する際に、JSON 形式のオブジェクトを指定する必要があります。各 Item オブジェクトが PutRequest オブジェクトに含められます。次に、これらの PutRequest オブジェクトを、テーブルと同じ名前の親配列に含める必要があります。

追加する JSON 形式の項目のパス (--request-items) を指定して DynamoDB batch-write-item コマンドを実行します。

aws dynamodb batch-write-item \
--request-items file://more-weather-items.json

コマンドが成功すると、次のメッセージが表示され、項目が正常に追加されたことを確認できます。

{
  "UnprocessedItems": {}
}

テーブルの現在のコンテンツを確認するには、DynamoDB scan コマンドをもう一度実行します。

aws dynamodb scan --table-name Weather

コマンドが成功した場合は、9 件の項目が表示されます。

weather-global-index.json という名前のファイルを作成し、次の内容を記述します。

[
  {
    "Create": {
      "IndexName": "weather-global-index",
      "KeySchema": [
        {
          "AttributeName": "City",
          "KeyType": "HASH"
        },
        {
          "AttributeName": "Date",
          "KeyType": "RANGE"
        }
      ],
      "Projection": {
        "ProjectionType": "INCLUDE",
        "NonKeyAttributes": [
          "State",
          "Conditions",
          "Temperatures"
        ]
      },
      "ProvisionedThroughput": {
        "ReadCapacityUnits": 5,
        "WriteCapacityUnits": 5
      }
    }
  }
]

このコードでは:

DynamoDB update-table コマンドを実行します。

aws dynamodb update-table \
--table-name Weather \
--attribute-definitions \
  AttributeName=City,AttributeType=S AttributeName=Date,AttributeType=S \
--global-secondary-index-updates file://weather-global-index.json

このコマンドで:

このコマンドが成功した場合、作成する新しいグローバルセカンダリインデックスに関する概要情報が表示されます。グローバルセカンダリインデックスが正常に作成されたことを確認するには、テーブルの名前 (--table-name) を指定して DynamoDB describe-table コマンドを実行します。

aws dynamodb describe-table --table-name Weather

グローバルセカンダリインデックスが正常に作成された場合、TableStatus の値が UPDATING から ACTIVE に変わり、IndexStatus の値が CREATING から ACTIVE に変わります。グローバルセカンダリインデックスが正常に作成されてからこのステップの先に進んでください。これには数分間かかる場合があります。

DynamoDB get-item コマンドを実行するには、テーブルの名前 (--table-name)、プライマリキーバリュー (--key)、および表示する項目の属性値 (--projection-expression) を指定します。Date は DynamoDBで予約されたキーワードであるため、Date 属性値のエイリアス (--expression-attribute-names) も指定する必要があります (State も予約されたキーワードであり、このためのエイリアスは後のステップで指定します)。

aws dynamodb get-item \
--table-name Weather \
--key '{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" } }' \
--projection-expression \
  "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \
--expression-attribute-names '{ "#D": "Date" }'

このコマンドや他のコマンドで、項目の属性をすべて表示するには、--projection-expression を含めません。このサンプルでは、--projection-expression を含めていないため、--expression-attribute-names を含める必要もありません。

aws dynamodb get-item \
--table-name Weather \
--key '{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" } }'

DynamoDB scan コマンドを実行するには、以下を指定します。

aws dynamodb scan \
--table-name Weather \
--filter-expression "(CityID = :cityID) and (#D = :date)" \
--expression-attribute-values \
  '{ ":cityID": { "N": "1" }, ":date": { "S": "2017-04-12" } }' \
--select SPECIFIC_ATTRIBUTES \
--projection-expression \
  "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \
--expression-attribute-names '{ "#D": "Date" }'

DynamoDB query コマンドを実行するには、以下を指定します。

aws dynamodb query \
--table-name Weather \
--key-condition-expression "(CityID = :cityID) and (#D = :date)" \
--expression-attribute-values \
  '{ ":cityID": { "N": "1" }, ":date": { "S": "2017-04-12" } }' \
--select SPECIFIC_ATTRIBUTES \
--projection-expression \
  "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \
--expression-attribute-names '{ "#D": "Date" }'

結果を取得するためにスキャンする必要がある項目数が、scan コマンドでは 9 項目すべてであるのに対して query コマンドでは 1 項目のみであることに注目してください。