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

# 從 AWS Explorer 使用 DynamoDB
<a name="dynamodb-tkv"></a>

Amazon DynamoDB 是一種快速、可輕鬆擴展、高度可用、經濟實惠、非關聯式資料庫服務。DynamoDB 會移除資料儲存體的傳統可擴展性限制，同時維持低延遲和可預測的效能。Toolkit for Visual Studio 提供在開發環境中使用 DynamoDB 的功能。如需 DynamoDB 的詳細資訊，請參閱 Amazon Web Services 網站上的 [DynamoDB](https://aws.amazon.com/dynamodb/)。

在 Toolkit for Visual Studio 中， AWS Explorer 會顯示與作用中 相關聯的所有 DynamoDB 資料表 AWS 帳戶。

![\[AWS Explorer window showing DynamoDB tables under the selected US East (Virginia) region.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-aws-explorer.png)


## 建立 DynamoDB 資料表
<a name="tkv-dynamodb-create-table"></a>

您可以使用 Toolkit for Visual Studio 來建立 DynamoDB 資料表。

 **在 AWS Explorer 中建立資料表** 

1. 在 AWS Explorer 中，開啟 **Amazon DynamoDB** 的內容 （按一下滑鼠右鍵） 選單，然後選擇**建立資料表**。

1. 在**建立資料表**精靈的**資料表名稱**中，輸入資料表的名稱。

1. 在**雜湊金鑰名稱**欄位中，輸入主要雜湊金鑰屬性，然後從**雜湊金鑰類型**按鈕中選擇雜湊金鑰類型。DynamoDB 使用主索引鍵屬性建置未排序的雜湊索引，並使用範圍主索引鍵屬性建置選用的排序範圍索引。如需主要雜湊金鑰屬性的詳細資訊，請前往《*Amazon DynamoDB 開發人員指南*》中的[主金鑰](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.CoreComponents.html#HowItWorks.CoreComponents.PrimaryKey)一節。

1. （選用） 選取**啟用範圍金鑰**。在**範圍索引鍵名稱**欄位中，輸入範圍索引鍵屬性，然後從**範圍索引鍵類型**按鈕中選擇範圍索引鍵類型。

1. 在**讀取容量**欄位中，輸入讀取容量單位的數量。在**寫入容量**欄位中，輸入寫入容量單位的數量。您必須指定至少三個讀取容量單位和五個寫入容量單位。如需讀取和寫入容量單位的詳細資訊，請前往 [ DynamoDB 中的佈建輸送量](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ProvisionedThroughput.html)。

1. （選用） 選取**啟用基本警示**，以便在資料表的請求率過高時提醒您。選擇傳送提醒之前，每 60 分鐘必須超過的佈建輸送量百分比。**在傳送通知至** 中，輸入電子郵件地址。

1. 按一下**確定**以建立資料表。

![\[Create Table dialog with fields for table name, key types, capacities, and alarm settings.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-create-table.png)


如需 DynamoDB 資料表的詳細資訊，請前往[資料模型概念 - 資料表、項目和屬性](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.CoreComponents.html#HowItWorks.CoreComponents.TablesItemsAttributes)。

## 將 DynamoDB 資料表檢視為網格
<a name="tkv-dynamodb-grid-view"></a>

若要開啟其中一個 DynamoDB 資料表的網格檢視，請在 AWS Explorer 中按兩下對應至資料表的子節點。從網格檢視中，您可以查看存放在該資料表中的項目、屬性和值。每一列都會對應到資料表中的某個項目。資料表欄會對應到屬性。資料表中的每個儲存格都會保存與該項目之屬性相關聯的值。

屬性可以擁有屬於字串或數字的值。有些屬性的值包含字串或數字的「集合」**。集合值會顯示為逗號分隔的清單，並且用方括號括住。

![\[AWS Explorer interface showing DynamoDB table with product catalog entries and attributes.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-product-catalog.png)


## 編輯和新增屬性和值
<a name="tkv-dynamodb-editing"></a>

透過按兩下儲存格，您可以編輯項目對應屬性的值。對於集合值屬性，您也可以在集合中新增或刪除其中的個別值。

![\[Table showing brand names with associated colors and editing options.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-single-value-cell-edit.png)


除了變更屬性的值之外，您還可以變更屬性值的格式，但有一些限制。例如，任何數值都能轉換為字串值。如果您有字串值，其內容為數字，例如 125，儲存格編輯器可讓您將值的格式從字串轉換為數字。您也可以將單一值轉換為集合值。但是，通常您不能將集合值轉換成為單一值；唯一的例外情況，就是當該集合值其實僅有一個元素。

![\[Spreadsheet interface showing Brand, Color, 描述, Dimensions, and Gender columns with editable cells.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-set-value-attribute.png)


編輯屬性值後，請選擇綠色核取記號以確認您的變更。如果您想要捨棄變更，請選擇紅色 X。

確認變更後，屬性值會以紅色顯示。這表示屬性已更新，但新值尚未寫回 DynamoDB 資料庫。若要將變更寫回 DynamoDB，請選擇**遞交變更**。若要捨棄變更，請選擇**掃描資料表**，當工具組詢問您是否要在掃描前遞交變更時，請選擇**否**。

 *新增 屬性* 

從網格檢視中，您也可以將屬性新增至資料表。若要新增屬性，請選擇**新增屬性**。

![\[Three buttons labeled Scan Table, Commit Changes, and Add Attribute.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-add-attribute-button.png)


在**新增屬性**對話方塊中，輸入屬性的名稱，然後選擇**確定**。

![\[Add Attribute dialog box with input field for Attribute Name and explanatory text.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-add-attribute.png)


若要讓新屬性成為資料表的一部分，您必須為至少一個項目新增值，然後選擇**遞交變更**按鈕。若要捨棄新的屬性，只需關閉資料表的網格檢視，而不選擇**遞交變更**。

![\[Database table view showing ProductCatalog with columns like ISBN, Price, and Genre.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-commit-new-attribute-value.png)


## 掃描 DynamoDB 資料表
<a name="tkv-dynamodb-scan"></a>

![\[Three buttons: Scan Table, Commit Changes, and Add Attribute.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-scan.png)


您可以從 Toolkit 對 DynamoDB 資料表執行掃描。進行掃描時，您可以定義一組條件，而掃描會從資料表中傳回符合您所設定條件的所有項目。掃描是昂貴的操作，應謹慎使用，以避免中斷資料表上較高優先順序的生產流量。如需使用掃描操作的詳細資訊，請前往 *Amazon DynamoDB 開發人員指南*。

 **從 AWS Explorer 在 DynamoDB 資料表上執行掃描** 

1. 在網格檢視中，選擇**掃描條件：新增**按鈕。

1. 在掃描子句編輯器中，選擇要比對的屬性、應如何解譯屬性的值 （字串、數字、設定值）、應如何比對 （例如以 或 包含開頭），以及應比對的常值。

1. 視需要為您的搜尋新增更多掃描子句。掃描只會傳回符合您所有掃描子句之條件的項目。比對字串值時，掃描會執行區分大小寫的比較。

1. 在網格檢視頂端的按鈕列上，選擇**掃描資料表**。

若要移除掃描子句，請選擇每個子句右側的白色線的紅色按鈕。

![\[Product catalog table with scan conditions interface showing bicycle data entries.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/dynamodb-scan-results.png)


若要返回包含所有項目的資料表檢視，請移除所有掃描子句，然後再次選擇**掃描資料表**。

 *為掃描結果編製分頁* 

檢視底部有三個按鈕。

![\[Three buttons at the bottom: rewind, fast forward, and a green play button.\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-visual-studio/latest/user-guide/images/tkv-simpleDB-paginate-export.png)


前兩個藍色按鈕提供掃描結果的分頁。第一個按鈕會顯示額外的結果頁面。第二個按鈕會顯示額外的十頁結果。在此內容中，頁面等於 1 MB 的內容。

 *將掃描結果匯出至 CSV* 

第三個按鈕會將結果從目前的掃描匯出至 CSV 檔案。