

# 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**
+ [Singleton 문](#workbench.querybuilder.partiql.single)
+ [트랜잭션](#workbench.querybuilder.partiql.transaction)
+ [배치](#workbench.querybuilder.partiql.batch)

## Singleton 문
<a name="workbench.querybuilder.partiql.single"></a>

PartiQL 문의 코드를 실행하거나 생성하려면 다음을 수행합니다.

1. 창 상단 근처에서 **PartiQL 편집기**를 선택합니다.

1. 유효한 [PartiQL 문](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html)을 입력합니다.

1. 문에서 파라미터를 사용하는 경우:

   1. **Optional request parameters(선택적 요청 파라미터)**를 선택합니다.

   1. **Add new parameter(새 파라미터 추가)**를 선택합니다.

   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 문](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html)을 입력합니다.
**참고**  
동일한 PartiQL 트랜잭션 요청에서 읽기 및 쓰기 작업이 지원되지 않습니다. 동일한 요청에서 INSERT, UPDATE 및 DELETE 문과 함께 SELECT 문을 사용할 수 없습니다. 자세한 내용은 [DynamoDB용 PartiQL에서 트랜잭션 수행](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html)을 참조하세요.

1. 문에서 파라미터를 사용하는 경우

   1. **Optional request parameters(선택적 요청 파라미터)**를 선택합니다.

   1. **Add new parameter(새 파라미터 추가)**를 선택합니다.

   1. 속성 유형 및 값을 입력합니다.

   1. 파라미터를 추가하려면 b 및 c단계를 반복합니다.

1. 문을 추가하려면 2\$14단계를 반복합니다.

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 문](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html)을 입력합니다.
**참고**  
 동일한 PartiQL 배치 요청에서 읽기 및 쓰기 작업이 지원되지 않습니다. 즉, 동일한 요청에서 INSERT, UPDATE 및 DELETE 문과 함께 SELECT 문을 사용할 수 없습니다. 동일한 항목에 쓰기 작업은 허용되지 않습니다. BatchGetItem 작업에서처럼 singleton 읽기 작업만 지원됩니다. 검색 및 쿼리 작업은 지원되지 않습니다. 자세한 내용은 [DynamoDB용 PartiQL에서 일괄 작업 실행](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html)을 참조하세요.

1. 문에서 파라미터를 사용하는 경우:

   1. **Optional request parameters(선택적 요청 파라미터)**를 선택합니다.

   1. **Add new parameter(새 파라미터 추가)**를 선택합니다.

   1. 속성 유형 및 값을 입력합니다.

   1. 파라미터를 추가하려면 b 및 c단계를 반복합니다.

1. 문을 추가하려면 2\$14단계를 반복합니다.

1. 코드를 생성하려면 **Generate code(코드 생성)**를 선택합니다.

   표시된 탭에서 원하는 언어를 선택합니다. 이제 이 코드를 복사하여 애플리케이션에서 사용할 수 있습니다.

1. 작업을 즉시 실행하려면 **Run(실행)**을 선택합니다.

1. 나중에 사용하기 위해 이 작업을 저장하려면 **Save operation**(저장)을 선택합니다. 그런 다음 작업 이름을 입력하고 **Save**(저장)를 선택합니다.