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

# 使用 NoSQL Workbench 建立資料模型
<a name="workbench.Modeler"></a>

您可以使用適用於 Amazon DynamoDB 的 NoSQL Workbench 中的資料模型工具來建立新的資料模型，或根據滿足應用程式資料存取模式的現有資料模型來設計模型。資料模型建立工具包含幾個協助您開始的範例資料模型。

**Topics**
+ [建立新的資料模型](workbench.Modeler.CreateNew.md)
+ [匯入現有的資料模型](workbench.Modeler.ImportExisting.md)
+ [編輯現有的資料模型](workbench.Modeler.Edit.md)
+ [將範例資料新增至資料模型](workbench.Modeler.AddData.md)
+ [新增和驗證存取模式](workbench.Modeler.AccessPatterns.md)
+ [從 CSV 檔案匯入範例資料](workbench.Modeler.ImportCSV.md)
+ [面向](workbench.Modeler.Facets.md)
+ [使用彙總檢視在資料模型中檢視所有資料表](workbench.Modeler.AggregateView.md)
+ [匯出資料模型](workbench.Modeler.ExportModel.md)
+ [向 DynamoDB 遞交資料模型](workbench.Modeler.Commit.md)

# 建立新的資料模型
<a name="workbench.Modeler.CreateNew"></a>

使用 NoSQL Workbench，在 Amazon DynamoDB 中依照這些步驟建立新的資料模型。

**建立新的資料模型**

1.  開啟 NoSQL Workbench，然後在主畫面上，選取**手動建立模型**。

    將開啟新頁面，其中包含第一個資料表的空白組態。NoSQL Workbench 會使用預設名稱 （即 untitled-2) 建立所有新的資料模型，並將其新增至 **Drafts** 專案資料夾。

1.  在**資料表組態畫面上**，指定下列項目：
   +  **Table Name** (資料表名稱)：輸入資料表的唯一名稱。
   +  **分割區索引鍵** — 輸入分割區索引鍵名稱，並指定其類型。或者，您也可以選擇更精細的資料類型格式來產生範例資料。
   +  如果您想要新增**排序索引鍵**，請指定排序索引鍵名稱及其類型。或者，您可以選擇更精細的資料類型格式來產生範例資料。
**注意**  
 若要深入了解主索引鍵設計、設計、有效使用分割區索引鍵以及使用排序索引鍵，請參閱以下內容：  
 [主索引鍵](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey) 
 [在 DynamoDB 中設計與有效運用分割區索引鍵的最佳實務](bp-partition-key-design.md) 
 [使用排序索引鍵組織 DynamoDB 資料的最佳實務](bp-sort-keys.md) 

1. 您可以新增其他屬性，以更清楚地驗證模型和存取模式。若要新增其他屬性：
   +  選擇**新增屬性**。
   +  指定屬性名稱和其類型。
   +  或者，您可以選擇更精細的資料類型格式來產生範例資料。

1.  若要新增全域次要索引，請選擇 **Add global secondary index** (新增全域次要索引)。指定 **Global secondary index name (全域次要索引名稱)**、**Partition key (分割區索引鍵)** 屬性和 **Projection type (投射類型)**。

   如需在 DynamoDB 中使用全域次要索引的詳細資訊，請參閱[全域次要索引](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html)。

1.  或者，**新增面向**。面向是 NoSQL Workbench 中的虛擬建構模組。它不是 DynamoDB 中的功能建構。NoSQL Workbench 中的面向可協助您視覺化應用程式 DynamoDB 的不同資料存取模式，其中只有資料表中的資料子集。
**注意**  
 我們建議您使用 [新增和驗證存取模式](workbench.Modeler.AccessPatterns.md) 視覺化您的應用程式如何存取 DynamoDB 中的資料，而不是 Facets。存取模式會反映您的實際資料庫互動，並協助您為使用案例建置正確的資料模型，而面向是非功能視覺化。

    選擇 **Add facet** (新增面向)。指定下列內容：
   +  **Facet name** (面向名稱)。
   +  **分割區索引鍵別名**有助於分辨此面向視圖。
   +  如果您為資料表提供**排序索引鍵，則為排序索引鍵別名**。 ****
   +  選擇屬於此面向的**屬性**。

    若您想新增更多面向，請重複執行此步驟。

1.  最後，按一下**儲存**按鈕來建立資料表。

1.  如果您需要其他**資料表**或**全域次要索引**，請按一下您剛建立之資料表上方的 **\$1** 圖示。

# 匯入現有的資料模型
<a name="workbench.Modeler.ImportExisting"></a>

您可以使用 Amazon DynamoDB 專用 NoSQL Workbench，藉由匯入與修改現有的模型來建立資料模型。您能夠以 NoSQL Workbench 模型格式或 [AWS CloudFormation JSON 範本格式](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html)匯入資料模型。

**匯入資料模型**

1.  開啟 NoSQL Workbench，然後在主畫面上選取**匯入模型**。您可以匯入 NoSQL Workbench 模型格式或 CloudFormation JSON 範本。

1.  您可以將匯入的模型新增至現有專案，或建立新的專案。如果您未選擇不同的專案，您的模型會新增至草稿專案資料夾。

1.  按一下**瀏覽桌面**，然後選擇要從電腦匯入的模型。

# 編輯現有的資料模型
<a name="workbench.Modeler.Edit"></a>

**編輯現有的使用者**

1. 若要開始變更現有模型，請在模型建構器頁面中開啟模型。

1. 在資源選取器面板中，您會看到**資料表**和**全域次要索引**的清單。

1. 若要編輯**資料表**或**全域次要索引**，請先按一下資源選擇器面板中的名稱，然後使用頂端的動作圖示。可用的動作為**刪除**、**複製**和**編輯**。

1. 如果您想要編輯**模型詳細資訊**，請按一下模型名稱旁的三點圖示。

1. 從那裡，您可以按一下**編輯模型詳細資訊**並相應地編輯資訊。

1. 您也可以從相同的選單**複製**、**移動**、**刪除**和**匯出**模型。

1. 若要變更為另一個模型，您可以再次瀏覽主畫面，或使用模型選取下拉式清單。

# 將範例資料新增至資料模型
<a name="workbench.Modeler.AddData"></a>

**自動產生範例資料**

1. 開啟 NoSQL Workbench，然後在主畫面上，按一下您要新增範例資料的模型名稱。

1. 按一下主要內容工具列中的其他動作 （三點圖示），然後選取**新增範例資料**。

1. 輸入您要產生的範例資料項目數量，然後選取**確認**。

1. 自動產生範例資料可協助您產生 1 到 5000 列的資料，以供立即使用。您可以指定精細的範例資料類型，以根據您的設計和測試需求建立真實的資料。若要利用此功能產生真實的資料，您需要在資料模型建立工具中指定屬性的範例資料類型格式。如需指定範例資料類型格式[建立新的資料模型](workbench.Modeler.CreateNew.md)，請參閱 。

**若要一次新增一個項目的範例資料**

1. 開啟您要編輯的模型，然後選擇您要新增範例資料的資料表。按一下主要內容工具列中的其他動作 （三點圖示），然後選取**編輯資料**。

1. 現在您可以新增、刪除和編輯資料列。進行必要的變更之後，請按一下**儲存**按鈕。

# 新增和驗證存取模式
<a name="workbench.Modeler.AccessPatterns"></a>

您可以使用適用於 Amazon DynamoDB 的 NoSQL Workbench 來建立、存放和驗證*存取模式*。

**注意**  
 如需[識別正確存取模式的詳細資訊，請參閱識別資料](https://docs.aws.amazon.com/prescriptive-guidance/latest/dynamodb-data-modeling/step3.html)存取模式。

**建立存取模式**

1.  開啟 NoSQL Workbench，然後在主畫面上，按一下您要新增存取模式的模型名稱。

1.  在左側，選擇**存取模式**索引標籤，然後按一下 **\$1** 圖示。

1.  在下一個畫面上，提供**名稱**、選用**的描述**、存取模式的**類型**，以及要測試存取模式的**資料表**或**全域次要索引**。
**注意**  
 NoSQL Workbench 目前支援下列存取模式的操作：`Scan`、`Query`、`GetItem`、`PutItem`、`UpdateItem`、`DeleteItem`。Amazon DynamoDB 支援更廣泛的操作清單。

1.  建立存取模式之後，您可以切換到**驗證**索引標籤，以驗證您的資料模型是否設計為傳回存取模式的預期結果。[將範例資料新增至資料模型](workbench.Modeler.AddData.md) 如需如何自動產生資料表範例資料的詳細資訊，請參閱 。不同類型的存取模式將支援不同的輸入參數。
**注意**  
為了驗證存取模式，NoSQL Workbench 會在連接埠 `8001`（預設） 上啟動單獨的 DynamoDB 本機資料庫，其中包含儲存在記憶體中的資料表和索引。  
NoSQL Workbench 會自動將模型中的範例資料新增至暫存資料表。
如果您編輯範例資料或資料模型本身，NoSQL Workbench 會更新暫時資料表。
當您關閉應用程式時，會清除此暫時資料庫。

**編輯您的存取模式**

1.  開啟 NoSQL Workbench，然後在主畫面上，按一下您要編輯存取模式的模型名稱。

1.  在左側，選擇**存取模式**索引標籤。

1. 若要編輯存取模式，請從左側的清單中選擇。

1. 在頂端列中，按一下**編輯**動作按鈕。

# 從 CSV 檔案匯入範例資料
<a name="workbench.Modeler.ImportCSV"></a>

如果您有 CSV 檔案預先存在範例資料，您可以將其匯入 NoSQL Workbench。這使您可以快速填入模型取樣資料，而無需逐行輸入。

CSV 檔案中的欄名稱必須與資料模型中的屬性名稱相符，但不需要以相同的順序排列。例如，如果您的資料模型具有名為 `LoginAlias`、`FirstName`，以及 `LastName`，您的 CSV 列可以是 `LastName`、`FirstName`，以及 `LoginAlias`。

您一次最多可從 CSV 檔案匯入 150 個資料列。

**若要從 CSV 檔案匯入資料至 NoSQL Workbench**

1. 若要將 CSV 資料匯入**資料表**，請先按一下資源面板中的資料表名稱，然後按一下主要內容工具列中的其他動作 （三點圖示）。

1. 選取**匯入範例資料**。

1. 選取 CSV 檔案，然後選擇 **Open** (開啟)。CSV 資料會附加到您的資料表。

# 面向
<a name="workbench.Modeler.Facets"></a>

 在 NoSQL Workbench 中，*構面*可讓您檢視資料表中資料的子集，而無需查看不符合構面限制的記錄。面向是一種視覺資料建模工具，在 DynamoDB 中不作為可用的建構存在，因為其純粹用於輔助存取模式建模。

**注意**  
 我們建議您使用 [新增和驗證存取模式](workbench.Modeler.AccessPatterns.md) 視覺化您的應用程式如何存取 DynamoDB 中的資料，而不是 Facets。存取模式會反映您的實際資料庫互動，並協助您為使用案例建置正確的資料模型，而面向是非功能視覺化。

**建立面向**

1. 在資源選取器面板中，選擇您要編輯的**資料表** 

1. 在頂端列中，按一下**編輯**動作圖示。

1. 向下捲動至**面向篩選條件**區段。

1.  選擇 **Add facet** (新增面向)。指定下列內容：
   +  **Facet name** (面向名稱)。
   +  **分割區索引鍵別名**有助於分辨此面向視圖。
   +  如果您為資料表提供**排序索引鍵，則為排序索引鍵別名**。 ****
   +  選擇屬於此面向的**屬性**。

    若您想新增更多面向，請重複執行此步驟。

# 使用彙總檢視在資料模型中檢視所有資料表
<a name="workbench.Modeler.AggregateView"></a>

NoSQL Workbench for Amazon DynamoDB 中的彙總檢視可讓您視覺化資料模型中的所有資料表和索引。每份資料表都會顯示以下資訊：
+ 資料表欄位名稱
+ 範例資料
+ 所有與資料表相關聯的全域次要索引。NoSQL Workbench 會顯示每個索引的下列資訊：
  + 索引欄位名稱
  + 範例資料

**檢視所有資料表資訊**

1. 開啟 NoSQL Workbench，然後在主畫面上，按一下您要開啟的模型名稱。

1. 在頂端列中，按一下**彙總檢視**。您會在同一個畫面上看到所有資料表和索引的資料。

**將彙總檢視匯出為影像**

1. 選取**彙總檢視**後，按一下三點圖示，然後選擇**匯出彙總檢視**

1. 所有資料表和索引的 PNG 映像封存將呈現以供下載。

# 匯出資料模型
<a name="workbench.Modeler.ExportModel"></a>

在使用 Amazon DynamoDB 專用 NoSQL Workbench 建立資料模型後，即可以 NoSQL Workbench 模型格式或 [AWS CloudFormation JSON 範本格式](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html)來儲存和匯出該模型。

**匯出資料模型**

1. 開啟 NoSQL Workbench，然後在主畫面上，按一下您要編輯的模型名稱。

1. 按一下資料模型名稱旁的三點圖示，然後選取**匯出模型**。

1.  選擇是否以 NoSQL Workbench 模型格式或 CloudFormation JSON 範本格式匯出資料模型。
   +  如果您想要使用 **NoSQL Workbench** 與其他團隊成員共用模型，或稍後將其匯入 NoSQL Workbench，請選擇 NoSQL Workbench 模型格式。
   +  如果您想要將模型直接部署到 ， AWS 或將其整合到您的infrastructure-as-code工作流程，請選擇 **CloudFormation JSON 範本**格式。

# 向 DynamoDB 遞交資料模型
<a name="workbench.Modeler.Commit"></a>

 當您滿意資料模型後，即可向 Amazon DynamoDB 遞交模型。

**注意**  
此動作會在 中 AWS 為資料模型中呈現的資料表和全域次要索引建立伺服器端資源。
NoSQL Workbench 預設會使用隨需容量建立資料表和索引。

**向 DynamoDB 遞交資料模型**

1. 開啟 NoSQL Workbench，然後在主畫面上，按一下您要遞交的模型名稱。

1. 在頂端列中，按一下**遞交**。

1. 選擇現有的連線，或按一下新增連線按鈕來**建立新的連線**。
   + 指定下列資訊，新增新的連線：
     + **帳戶別名**
     + **AWS 區域**
     + **存取金鑰 ID**
     + **私密存取金鑰**

     如需如何取得存取金鑰的詳細資訊，請參閱[取得 AWS 存取金鑰](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials)。
   + 您可以選擇指定下列項目：
     + [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
     + [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)

1. 如果您偏好使用 [DynamoDB 本機](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html)：

   1. 選擇**本機連線**索引標籤。

   1. 按一下**新增連線**按鈕。

   1. 指定 **Connection name** (連線名稱) 和 **Port** (連接埠)。
**注意**  
 若要使用 DynamoDB 本機，您需要使用 NoSQL Workbench 畫面左下角的 **DynamoDB 本機**切換來開啟它。

1. 按一下**遞交**。