适用于以下内容的亚马逊 DynamoDB 教程 AWS Cloud9

要为 AWS CLI 或设置凭据管理 AWS CloudShell 并在您的环境中安装 AWS CLI AWS CloudShell、或两者，请按照和AWS CloudShell 示例中的步骤 1 AWS CLI 和 2 进行操作，然后返回本主题。如果您已经在环境中安装并配置了 AWS CloudShell、或两者兼而有之，则无需再次执行此操作。 AWS CLI

通过在您的环境中的终端会话中 AWS CLI运行 DynamoDB list-tables命令来列出您的现有 DynamoDB 表（如果有），以测试安装和配置、aws-shell 或两者兼而有之。要开始新的终端会话，请在菜单栏上依次选择 Window (窗口)、New Terminal (新建终端)。

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

如果此命令成功，它会输出一个 TableNames 数组，其中包含您现在已有的 DynamoDB 表的列表。如果您还没有 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 开发人员指南中的数据类型。

运行 Dyn put-itemamoDB 命令，指定表的名称 --table-name () 和格式化项目的路径 ()。JSON --item

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

如果命令成功，它将运行而没有错误，并且不显示确认消息。

要确认表的当前内容，请运行 DynamoDB scan 命令，在命令中指定表的名称 (--table-name)。

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 个项目，类似于上一步中定义的单个项目。但是，在下一步中运行 batch-write-itemDynamoDB 命令时，必须提供JSON包含对象中的Item每个对象的格式对象。PutRequest然后，您必须将这些 PutRequest 对象包括在与表具有相同名称的父数组中。

运行 Dyn batch-write-itemamoDB 命令，指定要JSON添加的格式项目的路径 ()。--request-items

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

在此命令中：

如果此命令成功，它会显示所创建新全局二级索引的摘要信息。要确认已成功创建全局二级索引，请运行 DynamoDB describe-table 命令，在命令中指定表的名称 (--table-name)。

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 个项目。