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

# 建置 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** (儲存)。