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

# 使用 NoSQL Workbench 探索資料集與建立操作
<a name="workbench.querybuilder"></a>

Amazon DynamoDB 專用 NoSQL Workbench 會提供強大的圖形使用者介面來開發及測試查詢。您可以使用 NoSQL Workbench 中的操作建置器來檢視、探索及查詢即時資料集。結構化操作建置器支援投影表達式、條件表達式，並以多種語言產生範例程式碼。您可以將資料表從一個 Amazon DynamoDB 帳戶直接複製到不同區域中的另一個 Amazon DynamoDB 帳戶。您也可以在 DynamoDB 本機版和 Amazon DynamoDB 帳戶之間直接複製資料表，以便在開發環境之間更快速地複製資料表的索引鍵結構描述 (並可選擇 GSI 結構描述和項目)。您可以在操作建置器中儲存多達 50 個 DynamoDB 資料操作。

**Topics**
+ [連線至即時資料集](workbench.querybuilder.connect.md)
+ [建置複雜的操作](workbench.querybuilder.operationbuilder.md)
+ [使用 NoSQL Workbench 複製資料表](workbench.querybuilder.cloning-tables.md)
+ [將資料匯出到 CSV 檔案](workbench.querybuilder.exportcsv.md)

# 連線至即時資料集
<a name="workbench.querybuilder.connect"></a>

若要使用 NoSQL Workbench 連線到 Amazon DynamoDB 資料表，您必須先連線到 AWS 您的帳戶。

**新增資料庫連線**

1. 在 NoSQL Workbench 的左側導覽窗格中，選擇 **Operation builder** (操作建置器) 圖示。

1. 選擇 **Add Connection** (新增連線)。

1. 指定下列資訊：
   + **連線名稱 (Connection name)**
   + **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. 選擇 **Connect** (連線)。

    如果您不想要註冊免費方案帳戶，且寧可使用 [DynamoDB 本機版 (可下載版本)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html)：

   1. 在連線畫面上選擇 **Local** (本機) 標籤。

   1. 指定下列資訊：
      + **連線名稱 (Connection name)**
      + **連接埠**

   1. 選擇 **connect** (連接) 按鈕。
**注意**  
若要連線至 DynamoDB 本機版，請使用終端機手動啟動 DynamoDB 本機版 (請參閱[在電腦上部署 DynamoDB 本機版](DynamoDBLocal.DownloadingAndRunning.md))，或使用 NoSQL Workbench 導覽選單中的 DDB 本機版切換以直接啟動 DynamoDB 本機版。確保連線連接埠與您的 DynamoDB 本機版連接埠相同。

1. 對已建立的連線選擇 **Open** (開啟)。

連線至 DynamoDB 資料庫後，左窗格即會顯示可用的資料表清單。選擇資料表之一會傳回資料表所存放資料的範例。

您現在可以針對選取的資料表執行臨機操作查詢。

若要在資料表上執行查詢，請參閱有關建置操作的下一節，請參閱 [建置複雜的操作](workbench.querybuilder.operationbuilder.md)。

# 建置複雜的操作
<a name="workbench.querybuilder.operationbuilder"></a>

Amazon DynamoDB 專用 NoSQL Workbench 中的操作建置器提供視覺化介面，可讓您在其中執行複雜的資料平面操作。它包括對投射表達式和條件表達示的支援。建立操作後，您可以儲存操作以供日後使用 (最多可儲存 50 個操作)。然後，您可以在 **Saved Operations** (已儲存操作) 選單中瀏覽常用的資料平面操作清單，再使用它們來自動填入和建置新操作。您也可以使用多種語言產生這些操作的範本程式碼。

NoSQL Workbench 支援建置 DynamoDB 專用 [PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) 陳述式，可讓您使用 SQL 相容查詢語言來與 DynamoDB 互動。NoSQL Workbench 也支援建置 DynamoDB CRUD API 操作。

若要使用 NoSQL Workbench 來建立操作，請在左側導覽窗格中選擇 **Operation builder** (操作建置器) 圖示。

**Topics**
+ [建置 PartiQL 陳述式](workbench.querybuilder.partiql.md)
+ [建置 API 操作](workbench.querybuilder.operationbuilder.api.md)

# 建置 PartiQL 陳述式
<a name="workbench.querybuilder.partiql"></a>

若要使用 NoSQL Workbench 來建置 [DynamoDB 專用 PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) 陳述式，請選擇位於 NoSQL Workbench UI 頂端的 **PartiQL 編輯器**。

您可以在操作建置器中建立以下 PartiQL 陳述式類型。

**Topics**
+ [單一陳述式](#workbench.querybuilder.partiql.single)
+ [交易](#workbench.querybuilder.partiql.transaction)
+ [批次](#workbench.querybuilder.partiql.batch)

## 單一陳述式
<a name="workbench.querybuilder.partiql.single"></a>

若要執行或產生 PartiQL 陳述式的程式碼，請執行以下操作。

1. 選擇視窗頂端附近的 **PartiQL 編輯器**。

1. 輸入有效的 [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (PartiQL 陳述式)。

1. 如果您的陳述式使用參數：

   1. 選擇 **Optional request parameters** (選用的請求參數)。

   1. 選擇 **Add new parameters** (新增新參數)。

   1. 輸入屬性類型和值。

   1. 如果希望新增其他參數，請重複步驟 b 和 c。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   從顯示的標籤中選取所需的語言。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)。然後輸入操作的名稱，並選擇 **Save** (儲存)。

## 交易
<a name="workbench.querybuilder.partiql.transaction"></a>

若要執行或產生 PartiQL 交易的程式碼，請執行以下操作。

1. 從**更多操作**下拉式清單中選擇 **PartiQLTransaction**。

1. 選擇 **Add a new statement** (新增新陳述式)。

1. 輸入有效的 [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (PartiQL 陳述式)。
**注意**  
同一個 PartiQL 交易請求中不能同時支援讀取和寫入操作。SELECT 陳述式不能與 INSERT、UPDATE 和 DELETE 陳述式存在於同一個請求中。如需詳細資訊，請參閱[使用 DynamoDB 專用 PartiQL 執行交易](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html)。

1. 如果您的陳述式使用參數

   1. 選擇 **Optional request parameters** (選用的請求參數)。

   1. 選擇 **Add new parameters** (新增新參數)。

   1. 輸入屬性類型和值。

   1. 如果希望新增其他參數，請重複步驟 b 和 c。

1. 如果希望新增更多陳述式，請重複步驟 2 至 4。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   從顯示的標籤中選取所需的語言。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)。然後輸入操作的名稱，並選擇 **Save** (儲存)。

## 批次
<a name="workbench.querybuilder.partiql.batch"></a>

若要執行或產生 PartiQL 批次的程式碼，請執行以下操作。

1. 從**更多操作**下拉式清單中選擇 **PartiQLBatch**。

1. 選擇 **Add a new statement** (新增新陳述式)。

1. 輸入有效的 [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (PartiQL 陳述式)。
**注意**  
 同一個 PartiQL 批次請求中不能同時支援讀取和寫入操作，也就是說 SELECT 陳述式不能與 INSERT、UPDATE 和 DELETE 陳述式存在於同一個請求中。不允許對相同項目執行寫入操作。與 BatchGetItem 操作一樣，僅支援單一讀取操作。不支援掃描和查詢操作。如需詳細資訊，請參閱[使用 DynamoDB 專用 PartiQL 執行批次操作](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html)。

1. 如果您的陳述式使用參數：

   1. 選擇 **Optional request parameters** (選用的請求參數)。

   1. 選擇 **Add new parameters** (新增新參數)。

   1. 輸入屬性類型和值。

   1. 如果希望新增其他參數，請重複步驟 b 和 c。

1. 如果希望新增更多陳述式，請重複步驟 2 至 4。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   從顯示的標籤中選取所需的語言。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)。然後輸入操作的名稱，並選擇 **Save** (儲存)。

# 建置 API 操作
<a name="workbench.querybuilder.operationbuilder.api"></a>

若要使用 NoSQL Workbench 來建立 DynamoDB CRUD API，請選取位於 NoSQL Workbench 左側的**操作建置器**。

選取**開啟**，然後選擇連線。

您可以在操作建置器中執行以下操作。
+ [刪除資料表](#workbench.querybuilder.operationbuilder.DeleteTable)
+ [建立資料表](#workbench.querybuilder.operationbuilder.CreateTable)
+ [更新資料表](#workbench.querybuilder.operationbuilder.UpdateTable)
+ [放置項目](#workbench.querybuilder.operationbuilder.Put)
+ [更新項目](#workbench.querybuilder.operationbuilder.update)
+ [刪除項目](#workbench.querybuilder.operationbuilder.Delete)
+ [查詢](#workbench.querybuilder.operationbuilder.Query)
+ [掃描](#workbench.querybuilder.operationbuilder.scan)
+ [交易取得項目](#workbench.querybuilder.operationbuilder.transactget)
+ [交易寫入項目](#workbench.querybuilder.operationbuilder.transactwrite)

## 刪除資料表
<a name="workbench.querybuilder.operationbuilder.DeleteTable"></a>

若要執行 `Delete Table` 操作，請執行下列動作。

1. 從**資料表**區段尋找要刪除的資料表。

1. 從水平省略符號功能表中，選取**刪除資料表**。

1. 輸入**資料表名稱**，確認您想要刪除資料表。

1. 選取**刪除**。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》中的[刪除資料表](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html)。

## 刪除 GSI
<a name="workbench.querybuilder.operationbuilder.DeleteGSI"></a>

若要執行 `Delete GSI` 操作，請執行下列動作。

1. 從**資料表**區段尋找要刪除之資料表的 GSI。

1. 從水平省略號功能表中選取**刪除 GSI**。

1. 輸入 **GSI 名稱**，確認您想要刪除該 GSI。

1. 選取**刪除**。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》中的[刪除資料表](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html)。

## 建立資料表
<a name="workbench.querybuilder.operationbuilder.CreateTable"></a>

若要執行 `Create Table` 操作，請執行下列動作。

1. 選擇**資料表**區段旁的 **\$1** 圖示。

1. 輸入所需的資料表名稱。

1. 建立分割區索引鍵。

1. 選用：建立排序索引鍵。

1. 自定義容量設定並取消勾選**使用預設容量設定**核取方塊。
   + 您現在可以選取 **Provisioned** (已佈建的) 或 **On-demand capacity** (隨需容量)。

     若選取佈建，您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動擴展。
   + 如果資料表目前設定為隨需，您將無法指定佈建的輸送量。
   + 如果您從隨需切換到佈建輸送量，則自動擴展將自動套用到所有 GSI，其中包含：最小值：1，最大值：10；目標：70%。

1. 選取**略過 GSI 並建立**，以建立沒有 GSI 的資料表。或者，您可以選擇**下一步**，使用此新資料表建立 GSI。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》中的[建立資料表](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html)。

## 建立 GSI
<a name="workbench.querybuilder.operationbuilder.CreateGSI"></a>

若要執行 `Create GSI` 操作，請執行下列動作。

1. 尋找您要新增 GSI 的資料表。

1. 從水平省略號功能表中，選取**建立 GSI**。

1. 在**索引名稱**下，命名您的 GSI。

1. 建立分割區索引鍵。

1. 選用：建立排序索引鍵。

1. 從下拉式清單中選擇投影類型選項。

1. 選擇**建立 GSI**。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》中的[建立資料表](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html)。

## 更新資料表
<a name="workbench.querybuilder.operationbuilder.UpdateTable"></a>

若要使用 `Update Table` 操作更新資料表的容量設定，請執行下列動作。

1. 尋找待更新容量設定的資料表。

1. 從水平省略號功能表中，選取**更新容量設定**。

1. 選取**佈建**或**隨需容量**。

   若選取**佈建**，您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動擴展。

1. 選取 **Update** (更新)。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》中的[更新資料表](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)。

## 更新 GSI
<a name="workbench.querybuilder.operationbuilder.UpdateGSI"></a>

若要使用 `Update Table` 操作更新 GSI 的容量設定，請執行下列動作。

**注意**  
根據預設，全域次要索引會繼承基礎資料表的容量設定。只有在基礎資料表設定為佈建容量模式時，全域次要索引才具有不同的容量模式。當您對佈建模式資料表建立全域次要索引時，必須為該索引的預期工作負載指定讀取與寫入容量單位。如需詳細資訊，請參閱[全域次要索引的佈建輸送量考量](GSI.md#GSI.ThroughputConsiderations)。

1. 尋找待更新容量設定的 GSI。

1. 從水平省略號功能表中，選取**更新容量設定**。

1. 您現在可以選取 **Provisioned** (已佈建的) 或 **On-demand capacity** (隨需容量)。

   若選取**佈建**，您可以設定最小和最大讀寫容量單位。您還可以啟用或停用自動擴展。

1. 選取 **Update** (更新)。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》中的[更新資料表](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)。

## 放置項目
<a name="workbench.querybuilder.operationbuilder.Put"></a>

您可以使用 `Put Item` 操作以建立項目。若要執行或產生 `Put Item` 操作的程式碼，請執行以下操作。

1. 尋找您要在其中建立項目的資料表。

1. 從**動作**下拉式清單中，選取**建立項目**。

1. 輸入分割區索引鍵值。

1. 輸入排序索引鍵值 (如有)。

1. 若想要新增非索引鍵屬性，請執行以下作業：

   1. 選取**新增其他屬性**。

   1. 指定 **Attribute name** (屬性名稱)、**Type** (類型) 和 **Value** (值)。

1. 如果必須滿足某項條件表達式，`Put Item` 操作才能成功，請執行以下作業：

   1. 選擇 **Condition** (條件)。

   1. 指定屬性名稱、比較運算子、屬性類型和屬性值。

   1. 如需其他條件，請再次選擇 **Condition** (條件)。

   如需詳細資訊，請參閱 [DynamoDB 條件表達式 CLI 範例](Expressions.ConditionExpressions.md)。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   從顯示的標籤中選取所需的語言。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)，然後輸入操作的名稱，再選擇 **Save** (儲存)。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》**中的 [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)。

## 更新項目
<a name="workbench.querybuilder.operationbuilder.update"></a>

若要執行或產生 `Update Item` 操作的程式碼，請執行以下操作：

1. 尋找您要在其中更新項目的資料表。

1. 選取項目。

1. 輸入所選表達式的屬性名稱和屬性值。

1. 若要新增更多表達式，請在**更新表達式**下拉式清單中選擇另一項表達式，然後選取 **\$1** 圖示。

1. 如果必須滿足某項條件表達式，`Update Item` 操作才能成功，請執行以下作業：

   1. 選擇 **Condition** (條件)。

   1. 指定屬性名稱、比較運算子、屬性類型和屬性值。

   1. 如需其他條件，請再次選擇 **Condition** (條件)。

   如需詳細資訊，請參閱 [DynamoDB 條件表達式 CLI 範例](Expressions.ConditionExpressions.md)。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   選擇您想要的語言標籤。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)，然後輸入操作的名稱，再選擇 **Save** (儲存)。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》**中的 [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)。

## 刪除項目
<a name="workbench.querybuilder.operationbuilder.Delete"></a>

若要執行 `Delete Item` 操作，請執行下列動作。

1. 尋找您想要在其中刪除項目的資料表。

1. 選取項目。

1. 從**動作**下拉式清單中，選取**刪除項目**。

1. 選取**刪除**，確認您想要刪除項目。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》**中的 [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)。

## 複製項目
<a name="workbench.querybuilder.operationbuilder.Duplicate"></a>

您可以建立具有相同屬性的新項目以複製項目。執行下列步驟以複製項目。

1. 尋找您要在其中複製項目的資料表。

1. 選取項目。

1. 從**動作**下拉式清單中，選取**複製項目**。

1. 指定新的分割區索引鍵。

1. 指定新的排序索引鍵 (如有必要)。

1. 選取**執行**。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》**中的 [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)。

## Query
<a name="workbench.querybuilder.operationbuilder.Query"></a>

若要執行或產生 `Query` 操作的程式碼，請執行以下操作。

1. 從 NoSQL Workbench UI 頂端選取**查詢**。

1. 指定分割區索引鍵值。

1. 如果 `Query` 操作需要排序索引鍵：

   1. 選取 **Sort key** (排序索引鍵)。

   1. 指定比較運算子和屬性值。

1. 選取**查詢**以執行此查詢操作。如果需要更多選項，請勾選**更多選項**核取方塊並繼續執行下列步驟。

1. 如果不是所有屬性都應傳回並附帶操作結果，請選取 **Projection expression** (投射表達式)。

1. 選擇 **\$1** 圖示。

1. 輸入附帶查詢結果傳回的屬性。

1. 如需更多屬性，請選擇 **\$1**。

1. 如果必須滿足某項條件表達式，`Query` 操作才能成功，請執行以下作業：

   1. 選擇 **Condition** (條件)。

   1. 指定屬性名稱、比較運算子、屬性類型和屬性值。

   1. 如需其他條件，請再次選擇 **Condition** (條件)。

   如需詳細資訊，請參閱 [DynamoDB 條件表達式 CLI 範例](Expressions.ConditionExpressions.md)。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   選擇您想要的語言標籤。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)，然後輸入操作的名稱，再選擇 **Save** (儲存)。

如需此操作的詳細資訊，請參閱《Amazon DynamoDB API 參考》**中的 [Query](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html)。

## Scan
<a name="workbench.querybuilder.operationbuilder.scan"></a>

若要執行或產生 `Scan` 操作的程式碼，請執行以下操作。

1. 從 NoSQL Workbench UI 頂端選取**掃描**。

1. 選取**掃描**按鈕以執行此基本掃描操作。如果需要更多選項，請勾選**更多選項**核取方塊並繼續執行下列步驟。

1. 指定屬性名稱以篩選掃描結果。

1. 如果不是所有屬性都應傳回並附帶操作結果，請選取 **Projection expression** (投射表達式)。

1. 如果必須滿足某項條件表達式，scan 操作才能成功，請執行以下作業：

   1. 選擇 **Condition** (條件)。

   1. 指定屬性名稱、比較運算子、屬性類型和屬性值。

   1. 如需其他條件，請再次選擇 **Condition** (條件)。

   如需詳細資訊，請參閱 [DynamoDB 條件表達式 CLI 範例](Expressions.ConditionExpressions.md)。

1. 若要產生程式碼，請選擇 **Generate code** (產生程式碼)。

   選擇您想要的語言標籤。您現在可以複製此程式碼，並使用在您的應用程式中。

1. 若希望立即執行此操作，請選擇 **Run** (執行)。

1. 若想儲存此操作以供日後使用，請選擇 **Save operation** (儲存操作)，然後輸入操作的名稱，再選擇 **Save** (儲存)。

## TransactGetItems
<a name="workbench.querybuilder.operationbuilder.transactget"></a>

若要執行或產生 `TransactGetItems` 操作的程式碼，請執行以下操作。

1. 從 NoSQL Workbench UI 頂端的**更多操作**下拉式清單中，選擇 **TransactGetItems**。

1. 選擇 **TransactGetItem** 附近的 **\$1** 圖示。

1. 指定分割區索引鍵。

1. 指定排序索引鍵 (如有必要)。

1. 選取**執行**以執行操作、**儲存操作**以儲存，或選取**產生程式碼**以產生操作的程式碼。

如需交易的詳細資訊，請參閱 [Amazon DynamoDB Transactions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html)。

## TransactWriteItems
<a name="workbench.querybuilder.operationbuilder.transactwrite"></a>

若要執行或產生 `TransactWriteItems` 操作的程式碼，請執行以下操作。

1. 從 NoSQL Workbench UI 頂端的**更多操作**下拉式清單中，選擇 **TransactWriteItems**。

1. 從**動作**下拉式清單中，選擇操作。

1. 選擇 **TransactWriteItem** 附近的 **\$1** 圖示。

1. 在**動作**下拉式清單中，選擇您想執行的操作。
   + 如需 `DeleteItem`，請遵循 [刪除項目](#workbench.querybuilder.operationbuilder.Delete) 操作的說明。
   + 如需 `PutItem`，請遵循 [放置項目](#workbench.querybuilder.operationbuilder.Put) 操作的說明。
   + 如需 `UpdateItem`，請遵循 [更新項目](#workbench.querybuilder.operationbuilder.update) 操作的說明。

   若要變更動作順序，請在左側清單中選擇動作，然後選擇上下箭號在清單中上下移動該動作。

   若要刪除動作，請在清單中選擇動作，然後選擇 **Delete** (刪除) (回收桶) 圖示。

1. 選取**執行**以執行操作、**儲存操作**以儲存，或選取**產生程式碼**以產生操作的程式碼。

如需交易的詳細資訊，請參閱 [Amazon DynamoDB Transactions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html)。

# 使用 NoSQL Workbench 複製資料表
<a name="workbench.querybuilder.cloning-tables"></a>

複製資料表功能會在您的開發環境之間複製資料表的索引鍵結構描述 (並可選擇 GSI 結構描述和項目)。您可以將 DynamoDB 本機版之間的資料表複製到 Amazon DynamoDB 帳戶，甚至將資料表從一個帳戶複製到不同區域中的另一個帳戶，以加快實驗速度。

**複製資料表**

1. 在**操作建置器**中，選取您的連線和區域 (DynamoDB 本機版不提供區域選取功能)。

1. 連線至 DynamoDB 後，請瀏覽您的資料表，然後選取您要複製的資料表。

1. 從水平省略號功能表中，選取**複製**選項。

1. 輸入複製目的地詳細資訊：

   1. 選取連線。

   1. 選取區域 (DynamoDB 本機版無法選擇區域)。

   1. 輸入新的資料表名稱。

   1. 選擇複製選項：

      1. **索引鍵結構描述**預設為選取，且無法取消選取。根據預設，如有可用的主索引鍵及排序索引鍵，資料表進行複製時會一併複製。

      1. 如果要複製的資料表具有 GSI，則會預設選取 **GSI 結構描述**。如有可用的 GSI 主索引鍵及排序索引鍵，資料表進行複製時會一併複製。您可以選擇取消選取 GSI 結構描述，以略過複製 GSI 結構描述。資料表進行複製時，會複製基礎資料表的容量設定，套用為 GSI 的容量設定。您可以使用操作建置器中的 `UpdateTable` 操作，在複製完成後更新資料表的 GSI 容量設定。

1. 輸入要複製的項目數量。如僅需複製索引鍵結構描述和選用的 GSI 結構描述，您可以將**待複製項目**的值維持在 0。可複製的項目數量上限為 5000。

1. 選擇容量模式：

   1. 依預設，會選取**隨需模式**。DynamoDB 隨需提供讀取和寫入請求pay-per-request定價，因此您只需按使用量付費。如需進一步了解，請參閱 [DynamoDB 隨需模式](capacity-mode.md#capacity-mode-on-demand)。

   1. **佈建模式**可讓您指定應用程式需要的每秒讀取和寫入次數。您可以使用自動擴展來自動調整資料表的佈建容量，以回應流量的變動。如需進一步了解，請參閱 [DynamoDB 佈建模式](provisioned-capacity-mode.md)。

1. 選取**複製**以開始複製。

1. 複製程序將在背景執行。當複製資料表的狀態發生變更時，**操作建置器**索引標籤會顯示通知。您可以選取**操作建置器**索引標籤，接著選取箭頭按鈕以存取此狀態。箭頭按鈕位於複製資料表狀態小工具上，靠近功能表側邊欄底部。

# 將資料匯出到 CSV 檔案
<a name="workbench.querybuilder.exportcsv"></a>

您可以從作業建置器將查詢的結果匯出到 CSV 檔案。這可讓您將資料載入試算表或使用偏好的程式設計語言來處理資料。

**匯出至 CSV**

1. 在作業產生器中，執行您選擇的作業，例如掃描或查詢。
**注意**  
您只能將讀取 API 操作和 PartiQL 陳述式的結果匯出至 CSV 檔案。您無法從交易讀取陳述式匯出結果。
目前，您每次可以匯出一個頁面的結果到 CSV 檔案。如果有多個結果頁面，您必須個別匯出每個頁面。

1. 從結果中選取您要匯出的項目。

1. 從**動作**下拉式清單中，選擇**匯出 CSV**。

1. 為 CSV 檔案選擇檔案名稱及位置，然後選擇 **Save** (儲存)。