AWS Cloud9 不再提供給新客戶。 AWS Cloud9 的現有客戶可以繼續正常使用該服務。[進一步了解](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 的 Amazon DynamoDB 教學課程 AWS Cloud9 本教學課程可讓您設定 AWS Cloud9 開發環境以使用 Amazon DynamoDB。 DynamoDB 是全受管的 NoSQL 資料庫服務。您可以使用 DynamoDB 建立資料庫資料表，藉此存放和擷取任意數量的資料，並為任何層級的請求流量提供服務。DynamoDB 會自動將資料表的資料和流量分散到足夠數量的伺服器，以便處理指定的請求容量和存放的資料量，同時保持一致且快速的效能。如需詳細資訊，請參閱 AWS 網站上的 [Amazon DynamoDB](https://aws.amazon.com/dynamodb/)。 建立此範例可能會導致 AWS 您的帳戶產生費用。其中包括 Amazon EC2 和 DynamoDB 這類服務可能的費用。如需詳細資訊，請參閱 [Amazon EC2 定價](https://aws.amazon.com/ec2/pricing/)和 [Amazon DynamoDB 定價](https://aws.amazon.com/dynamodb/pricing/)。 如需其他 AWS 資料庫產品的相關資訊，請參閱 AWS 網站上的 [Amazon Relational Database Service (RDS)](https://aws.amazon.com/rds/)、[Amazon ElastiCache](https://aws.amazon.com/elasticache/) 和 [Amazon Redshift](https://aws.amazon.com/redshift/)。另請參閱 AWS 網站上的 [AWS Database Migration Service](https://aws.amazon.com/dms/)。 + [先決條件](#sample-dynamodb-prereqs) + [步驟 1：在環境中安裝和設定 AWS CLI、 AWS CloudShell，或兩者兼具](#sample-dynamodb-cli-setup) + [步驟 2：建立資料表](#sample-dynamodb-create-table) + [步驟 3：新增項目到資料表](#sample-dynamodb-add-item) + [步驟 4：新增多個項目到資料表](#sample-dynamodb-add-items) + [步驟 5：建立全域輔助索引](#sample-dynamodb-create-index) + [步驟 6：取得資料表中的項目](#sample-dynamodb-get-items) + [步驟 7：清除](#sample-dynamodb-clean-up) ## 先決條件 在您使用此範例前，請務必確認您的設定符合下列要求： + **您必須擁有現有的 AWS Cloud9 EC2 開發環境。**本範例假設您已具備 EC2 環境，且該環境已連線到執行 Amazon Linux 或 Ubuntu Server 的 Amazon EC2 執行個體。如果您有不同類型的環境或作業系統，您可能需要依照此範例的說明來設定相關工具。如需詳細資訊，請參閱[在 中建立環境 AWS Cloud9](create-environment.md)。 + **您已開啟現有環境的 AWS Cloud9 IDE。**當您開啟環境時，請在 Web 瀏覽器中 AWS Cloud9 開啟該環境的 IDE。如需詳細資訊，請參閱[在 中開啟環境 AWS Cloud9](open-environment.md)。 ## 步驟 1：在您的環境中安裝和設定 AWS CLI AWS CloudShell、 或兩者 在此步驟中，您可以使用 AWS Cloud9 IDE 在環境中安裝和設定 AWS CLI、 或兩者 AWS CloudShell，以便您可以執行命令來與 DynamoDB 互動。然後，使用 AWS CLI 執行基本 DynamoDB 命令來測試您的安裝和組態。 1. 若要設定 AWS CLI 或 的登入資料管理， AWS CloudShell 以及在您的環境中安裝 AWS CLI、 AWS CloudShell或兩者，請遵循 和 [AWS CLIAWS CloudShell 範例中](sample-aws-cli.md)的步驟 1 和 2，然後返回本主題。如果您已在環境中安裝並設定 AWS CLI、 AWS CloudShell或兩者，則不需要再次執行。 1. 測試 AWS CLI、aws-shell 或兩者的安裝和組態，方法是從環境中的終端機工作階段執行 DynamoDB** `list-tables` ** 命令，如果有的話，列出現有的 DynamoDB 資料表。若要啟動新終端機工作階段，請在選單列上，選擇 **Windows** (視窗)、**New Terminal** (新增終端機)。 ``` aws dynamodb list-tables # For the AWS CLI. dynamodb list-tables # For the aws-shell. ``` **注意** 在此範例中，如果您使用 aws-shell，則會省略開頭為 `aws` 的每個命令中的 `aws`。若要開始 aws-shell，請執行 ** `aws-shell` ** 命令。若要停止使用 aws-shell，請執行 ** `.exit` ** 或 ** `.quit` ** 命令。 如果此命令成功，則輸出的 `TableNames` 陣列會包含您可能已有的現有 DynamoDB 資料表清單。如果您還沒有 DynamoDB 資料表，則 `TableNames` 陣列會是空白。 ``` { "TableNames": [] } ``` 如果您有任何 DynamoDB 資料表，則 `TableNames` 陣列會包含資料表名稱清單。 ## 步驟 2：建立資料表 在此步驟中，您會在 DynamoDB 中建立資料表，並指定資料表名稱、配置、簡單主索引鍵和資料輸送量設定。 這個名為 `Weather` 的範例資料表包含有關美國幾個城市的氣象預測資訊。此資料表包含下列類型的資訊 (在 DynamoDB 中，每個資訊片段都稱為*屬性*)： + 必要的唯一城市 ID (`CityID`) + 必要的預測日期 (`Date`) + 城市名稱 (`City`) + 州名稱 (`State`) + 預測氣象條件 (`Conditions`) + 預測溫度 (`Temperatures`) + 預測華氏高温 (`HighF`) + 預測華氏低温 (`LowF`) 若要建立資料表，請在 IDE AWS Cloud9 的終端機工作階段中執行 DynamoDB** `create-table` ** 命令。 ``` aws dynamodb create-table \ --table-name Weather \ --attribute-definitions \ AttributeName=CityID,AttributeType=N AttributeName=Date,AttributeType=S \ --key-schema \ AttributeName=CityID,KeyType=HASH AttributeName=Date,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 ``` 在此命令中： + `--table-name` 代表資料表名稱 (在此範例中為 `Weather`)。資料表名稱在您帳戶中的每個 AWS 區域中 AWS 必須是唯一的。 + `--attribute-definitions` 代表用來唯一識別資料表項目的屬性。此資料表的每個項目都是以數字 `ID` 屬性與 `Date` 屬性 (以 ISO-8601 格式字串呈現) 的組合予以唯一識別。 + `--key-schema` 代表資料表的索引鍵結構描述。此資料表具有 `CityID` 和 `Date` 的複合主索引鍵。這表示每個資料表項目都必須有 `CityID` 屬性值和 `Date` 屬性值，但資料表中不能有相同 `CityID` 屬性值和 `Date` 屬性值的兩個項目。 + `--provisioned-throughput` 代表資料表的讀寫容量。DynamoDB 允許最大達 4 KB 的項目每秒最多 5 次強式一致性讀取，或最大達 4 KB 的項目每秒最多 5 次最終一致讀取。DynamoDB 也允許最大達 1 KB 的項目每秒最多 5 次寫入。 **注意** 設定較高的佈建輸送量可能會對您的帳戶產生額外費用 AWS 。 如需上述操作和其他 DynamoDB 命令的詳細資訊，請參閱 *AWS CLI 命令參考*中的 [dynamodb](https://docs.aws.amazon.com/cli/latest/reference/dynamodb/index.html)。 如果此命令成功，則會顯示所建立之新資料表的摘要資訊。若要確認已成功建立資料表，請執行 DynamoDB **`describe-table`** 命令，指定資料表名稱 (`--table-name`)。 ``` aws dynamodb describe-table --table-name Weather ``` 成功建立資料表時，`TableStatus` 值會從 `CREATING` 變更為 `ACTIVE`。除非成功建立資料表，否則請不要跳過此步驟。 ## 步驟 3：新增項目到資料表 在此步驟中，您會新增項目到剛建立的資料表。 1. 建立名為 `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` 代表 number 屬性值。`S` 是 string 屬性值。`M` 是 map 屬性，其為一對屬性值組。只要您使用項目，就必須指定屬性的資料類型。如需了解其他可用的屬性資料類型，請參閱 *Amazon DynamoDB 開發人員指南*中的[資料類型](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes)。 1. 執行 DynamoDB **`put-item`** 命令，並指定資料表名稱 (`--table-name`) 以及 JSON 格式的項目 (`--item`) 路徑。 ``` aws dynamodb put-item \ --table-name Weather \ --item file://weather-item.json ``` 如果命令成功，則執行時未發生錯誤，而且未顯示任何確認訊息。 1. 若要確認資料表的目前內容，請執行 DynamoDB **`scan`** 命令，並指定資料表名稱 (`--table-name`)。 ``` aws dynamodb scan --table-name Weather ``` 如果命令成功，則會顯示資料表和您剛新增之項目的摘要。 ## 步驟 4：新增多個項目到資料表 在此步驟中，您會新增數個項目到 `Weather` 資料表。 1. 建立名為 `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 個項目，這與先前步驟中定義的單一項目類似。不過，當您在後續步驟中執行 DynamoDB **`batch-write-item`** 命令時，必須提供 JSON 格式的物件，其中包括包含 `PutRequest` 物件的每個 `Item` 物件。然後，您必須將這些 `PutRequest` 物件包含在名稱與資料表相同的父陣列中。 1. 執行 DynamoDB **`batch-write-item`** 命令，指定要新增的 JSON 格式項目 (`--request-items`) 的路徑。 ``` aws dynamodb batch-write-item \ --request-items file://more-weather-items.json ``` 如果命令成功，則會顯示下列訊息，確認已成功新增項目。 ``` { "UnprocessedItems": {} } ``` 1. 若要確認資料表的目前內容，請再次執行 DynamoDB **`scan`** 命令。 ``` aws dynamodb scan --table-name Weather ``` 如果命令成功，則現在會顯示 9 個項目。 ## 步驟 5：建立全域輔助索引 執行 DynamoDB **`scan`** 命令來取得項目的相關資訊可能會很慢，尤其在資料表的大小增加或您要取得的資訊類型較複雜時更是如此。您可以建立一或多個輔助索引，以加速進行，並讓取得資訊更容易。在此步驟中，您會了解執行上述作業時，DynamoDB 支援的兩種輔助索引類型。這些稱為「本機輔助索引」**和「全域輔助索引」**。然後，您會建立全域輔助索引。 若要了解這些輔助索引類型，您需要先了解可識別資料表中唯一項目的主索引鍵。DynamoDB 支援*簡單主索引鍵*或*複合主索引鍵*。簡單主索引鍵具有單一屬性，而資料表中每個項目的屬性值都必須是唯一。此屬性也稱為*分割區索引鍵* (或*雜湊屬性*)，DynamoDB 可使用此屬性來分割項目，以便加速存取。資料表也可以有複合主索引鍵，其中包含兩個屬性。第一個屬性是分割區索引鍵，而第二個屬性是「排序索引鍵」**(也稱為「範圍屬性」**)。在具有複合主索引鍵的資料表中，任何兩個項目都可以有相同的分割區索引鍵值，但不能同時也有相同的排序索引鍵值。`Weather` 資料表具有複合主索引鍵。 本機輔助索引具有與資料表本身相同的分割區索引鍵，但此索引類型可以有不同的排序索引鍵。全域輔助索引可以有與資料表本身不同的分割區索引鍵和排序索引鍵。 例如，您可能已使用主索引鍵，以 `Weather` 存取 `CityID` 項目。若要以 `Weather` 存取 `State` 項目，您可以建立具有分割區索引鍵 `CityID` (必須與資料表本身相同) 和排序索引鍵 `State` 的本機輔助索引。若要以 `Weather` 存取 `City` 項目，您可以建立具有分割區索引鍵 `City` 和排序索引鍵 `Date` 的全域輔助索引。 您只有在建立資料表時才能建立本機輔助索引。因為 `Weather` 資料表已存在，所以您無法新增任何本機輔助索引到資料表。不過，您可以新增全域輔助索引。請現在練習新增一個全域輔助索引。 **注意** 建立輔助索引可能會使您的 AWS 帳戶產生額外的費用。 1. 建立名為 `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 } } } ] ``` 在此程式碼中： + 全域輔助索引的名稱為 `weather-global-index`。 + `City` 屬性是分割區索引鍵 (雜湊屬性)，而 `Date` 屬性是排序索引鍵 (範圍屬性)。 + 如果每個項目都符合使用此索引的資料表搜尋，則 `Projection` 預設會定義要擷取的屬性 (除了擷取雜湊屬性和任何範圍屬性)。在此範例中，會擷取每個相符項目的 `State`、`Conditions`、`HighF` (`Temperatures` 的一部分) 和 `LowF` (也是 `Temperatures` 的一部分) 屬性 (以及 `City` 和 `Date` 屬性)。 + 與資料表類似，全域輔助索引必須定義其佈建輸送量設定。 + `IndexName`、`KeySchema`、`Projection` 和 `ProvisionedThroughput` 設定都必須包含在 `Create` 物件中，而此物件定義您要在後續步驟中執行 DynamoDB ** `update-table` ** 命令時建立的全域輔助索引。 1. 執行 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` 是要更新的資料表名稱。 + `--attribute-definitions` 是要包含在索引中的屬性。分割區索引鍵一律會先列出，而任何排序索引鍵一律會後列出。 + `--global-secondary-index-updates` 是定義全域輔助索引之檔案的路徑。 如果此命令成功，則會顯示所建立之新全域輔助索引的摘要資訊。若要確認已成功建立全域輔助索引，請執行 DynamoDB **`describe-table`** 命令，並指定資料表名稱 (`--table-name`)。 ``` aws dynamodb describe-table --table-name Weather ``` 成功建立全域輔助索引時，`TableStatus` 值會從 `UPDATING` 變更為 `ACTIVE`，而 `IndexStatus` 值會從 `CREATING` 變更為 `ACTIVE`。除非成功建立全域輔助索引，否則請不要跳過此步驟。這可能需要幾分鐘的時間。 ## 步驟 6：取得資料表中的項目 有多種方法可以取得資料表中的項目。在此步驟中，您會使用資料表的主索引鍵、資料表的其他屬性和全域輔助索引來取得項目。 ### 根據項目的主索引鍵值來取得資料表的單一項目 如果您知道項目的主索引鍵值，則可以執行 DynamoDB 命令 **`get-item`**、**`scan`** 或 **`query`** 來取得相符項目。以下是這些命令的主要差異： + ** `get-item` ** 會為具有指定主索引鍵的項目傳回一組屬性。 + ** `scan` ** 會存取資料表中的每個項目或輔助索引，以傳回一或多個項目和項目屬性。 + ** `query` ** 會根據主索引鍵值尋找項目。您可以查詢任何具有複合主索引鍵 (一個分割區索引鍵及一個排序索引鍵) 的資料表或輔助索引。 在此範例中，以下說明如何使用所有這些命令來取得項目，其包含 `CityID` 屬性值 `1` 和 `Date` 屬性值 `2017-04-12`。 1. 若要執行 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" } }' ``` 1. 若要執行 DynamoDB **`scan`** 命令，請指定： + 資料表名稱 (`--table-name`)。 + 要執行的搜尋 (`--filter-expression`)。 + 要使用的搜尋條件 (`--expression-attribute-values`)。 + 要為相符項目顯示的屬性類型 (`--select`)。 + 要顯示之項目的屬性值 (`--projection-expression`)。 + 如果您有任何屬性正在 DynamoDB 中使用保留的關鍵字，請為這些屬性建立別名 (`--expression-attribute-names`)。 ``` 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" }' ``` 1. 若要執行 DynamoDB **`query`** 命令，請指定： + 資料表名稱 (`--table-name`)。 + 要執行的搜尋 (`--key-condition-expression`)。 + 要用於搜尋的屬性值 (`--expression-attribute-values`)。 + 要為相符項目顯示的屬性類型 (`--select`)。 + 要顯示之項目的屬性值 (`--projection-expression`)。 + 如果您有任何屬性正在 DynamoDB 中使用保留的關鍵字，請為這些屬性建立別名 (`--expression-attribute-names`)。 ``` 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 個項目。 ### 根據項目的主索引鍵值來取得資料表的多個項目 如果您知道項目的主索引鍵值，則可以執行 DynamoDB **`batch-get-item`** 命令來取得相符項目。在此範例中，以下說明如何取得項目，其包含 `CityID` 屬性值 `3` 和 `Date` 屬性值 `2017-04-13` 或 `2017-04-14`。 執行 DynamoDB **`batch-get-item`** 命令，並指定檔案路徑來描述要取得的項目 (`--request-items`)。 ``` aws dynamodb batch-get-item --request-items file://batch-get-item.json ``` 在此範例中，`batch-get-item.json` 檔案中的程式碼指定搜尋 `Weather` 資料表中 `CityID` 為 `3` 且 `Date` 為 `2017-04-13` 或 `2017-04-14` 的項目。對於找到的每個項目，會顯示 `City`、`State`、`Date` 和 `HighF` (`Temperatures` 的一部分) 的屬性值 (如果存在的話)。 ``` { "Weather" : { "Keys": [ { "CityID": { "N": "3" }, "Date": { "S": "2017-04-13" } }, { "CityID": { "N": "3" }, "Date": { "S": "2017-04-14" } } ], "ProjectionExpression": "City, #S, #D, Temperatures.HighF", "ExpressionAttributeNames": { "#S": "State", "#D": "Date" } } } ``` ### 從資料表取得所有相符項目 如果您知道資料表中屬性值的某個資訊，則可以執行 DynamoDB **`scan`** 命令來取得相符項目。在此範例中，以下說明如何取得 `Conditions` 屬性值包含 `Sunny` 而 `HighF` 屬性值 (`Temperatures` 的一部分) 大於 `53` 的日期。 執行 DynamoDB **`scan`** 命令，並指定： + 資料表名稱 (`--table-name`)。 + 要執行的搜尋 (`--filter-expression`)。 + 要使用的搜尋條件 (`--expression-attribute-values`)。 + 要為相符項目顯示的屬性類型 (`--select`)。 + 要顯示之項目的屬性值 (`--projection-expression`)。 + 如果您有任何屬性正在 DynamoDB 中使用保留的關鍵字，請為這些屬性建立別名 (`--expression-attribute-names`)。 ``` aws dynamodb scan \ --table-name Weather \ --filter-expression \ "(contains (Conditions, :sun)) and (Temperatures.HighF > :h)" \ --expression-attribute-values \ '{ ":sun": { "S" : "Sunny" }, ":h": { "N" : "53" } }' \ --select SPECIFIC_ATTRIBUTES \ --projection-expression "City, #S, #D, Conditions, Temperatures.HighF" \ --expression-attribute-names '{ "#S": "State", "#D": "Date" }' ``` ### 從全域輔助索引取得所有相符項目 若要使用全域輔助索引搜尋，請使用 DynamoDB **`query`** 命令。在此範例中，以下說明如何使用 `weather-global-index` 輔助索引以取得名為 `Portland` 的城市在日期 `2017-04-13` 和 `2017-04-14` 的預測條件。 執行 DynamoDB **`query`** 命令，並指定： + 資料表名稱 (`--table-name`)。 + 全域輔助索引的名稱 (`--index-name`)。 + 要執行的搜尋 (`--key-condition-expression`)。 + 要用於搜尋的屬性值 (`--expression-attribute-values`)。 + 要為相符項目顯示的屬性類型 (`--select`)。 + 如果您有任何屬性正在 DynamoDB 中使用保留的關鍵字，請為這些屬性建立別名 (`--expression-attribute-names`)。 ``` aws dynamodb query \ --table-name Weather \ --index-name weather-global-index \ --key-condition-expression "(City = :city) and (#D between :date1 and :date2)" \ --expression-attribute-values \ '{ ":city": { "S" : "Portland" }, ":date1": { "S": "2017-04-13" }, ":date2": { "S": "2017-04-14" } }' \ --select SPECIFIC_ATTRIBUTES \ --projection-expression "City, #S, #D, Conditions, Temperatures.HighF" \ --expression-attribute-names '{ "#S": "State", "#D": "Date" }' ``` ## 步驟 7：清除 為了避免在您完成使用此範例後持續向您的 AWS 帳戶收取費用，您應該刪除資料表。刪除資料表也會刪除全域輔助索引。您也應該刪除環境。 若要刪除資料表，請執行 DynamoDB **`delete-table`** 命令，並指定資料表名稱 (`--table-name`)。 ``` aws dynamodb delete-table --table-name Weather ``` 如果命令成功，則會顯示資料表的相關資訊 (包含 `TableStatus` 值 `DELETING`)。 若要確認已成功刪除資料表，請執行 DynamoDB **`describe-table`** 命令，並指定資料表名稱 (`--table-name`)。 ``` aws dynamodb describe-table --table-name Weather ``` 如果已成功刪除資料表，則會顯示包含 `Requested resource not found` 字詞的訊息。 若要刪除環境，請參閱[刪除環境](delete-environment.md)。