# 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)
+ [항목 Put](#workbench.querybuilder.operationbuilder.Put)
+ [항목 업데이트](#workbench.querybuilder.operationbuilder.update)
+ [항목 삭제](#workbench.querybuilder.operationbuilder.Delete)
+ [Query](#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)** 용량을 선택할 수 있습니다.

     프로비저닝됨(Provisioned)을 선택한 경우 최소 및 최대 읽기와 쓰기 용량 단위를 설정할 수 있습니다. 또한 오토 스케일링을 사용 설정하거나 사용 중지할 수 있습니다.
   + 테이블이 현재 온디맨드로 설정되어 있으면 프로비저닝된 처리량을 지정할 수 없습니다.
   + 온디맨드에서 프로비저닝된 처리량으로 전환하면 Auto Scaling이 최소 1, 최대 10, 목표 70%로 모든 GSI에 자동으로 적용됩니다.

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. **업데이트**를 선택합니다.

이 작업에 대한 자세한 내용은 *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)** 용량을 선택할 수 있습니다.

   **프로비저닝된 용량**을 선택한 경우 최소 및 최대 읽기와 쓰기 용량 단위를 설정할 수 있습니다. 또한 오토 스케일링을 사용 설정하거나 사용 중지할 수 있습니다.

1. **업데이트**를 선택합니다.

이 작업에 대한 자세한 내용은 *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 다른 속성 추가**를 선택합니다.

   1. **속성 이름**, **형식** 및 **값**을 지정합니다.

1. `Put Item` 작업이 성공할 수 있는 조건식이 충족되어야 할 경우에는 다음을 수행합니다.

   1. **조건**을 선택합니다.

   1. 속성 이름, 비교 연산자, 속성 형식 및 속성 값을 지정합니다.

   1. 다른 조건이 필요할 경우에는 **조건**을 다시 선택합니다.

   자세한 내용은 [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. **조건**을 선택합니다.

   1. 속성 이름, 비교 연산자, 속성 형식 및 속성 값을 지정합니다.

   1. 다른 조건이 필요할 경우에는 **조건**을 다시 선택합니다.

   자세한 내용은 [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)을 참조하세요.

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

`Query` 작업의 코드를 실행하거나 생성하려면 다음을 수행합니다.

1. NoSQL Workbench UI 상단에서 **쿼리**를 선택합니다.

1. 파티션 키 값을 지정합니다.

1. `Query` 작업에 정렬 키가 필요한 경우

   1. **정렬 키**를 선택합니다.

   1. 비교 연산자 및 속성 값을 지정합니다.

1. **쿼리**를 선택하여 이 쿼리 작업을 실행합니다. 옵션이 더 필요한 경우 **추가 옵션** 확인란을 선택하고 다음 단계를 계속 진행합니다.

1. 작업 결과로 일부 속성만 반환할 경우에는 **Projection expression(프로젝션 식)**을 선택합니다.

1. **\$1** 아이콘을 선택합니다.

1. 커리 결과로 반환될 속성을 입력합니다.

1. 속성이 더 필요한 경우에는 **\$1**를 선택합니다.

1. `Query` 작업이 성공할 수 있는 조건식이 충족되어야 할 경우에는 다음을 수행합니다.

   1. **조건**을 선택합니다.

   1. 속성 이름, 비교 연산자, 속성 형식 및 속성 값을 지정합니다.

   1. 다른 조건이 필요할 경우에는 **조건**을 다시 선택합니다.

   자세한 내용은 [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)를 참조하세요.

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

`Scan` 작업의 코드를 실행하거나 생성하려면 다음을 수행합니다.

1. NoSQL Workbench UI 상단에서 **스캔**을 선택합니다.

1. **스캔** 버튼을 선택하여 이 기본 스캔 작업을 수행합니다. 옵션이 더 필요한 경우 **추가 옵션** 확인란을 선택하고 다음 단계를 계속 진행합니다.

1. 스캔 결과를 필터링하려면 속성 이름을 지정합니다.

1. 작업 결과로 일부 속성만 반환할 경우에는 **Projection expression(프로젝션 식)**을 선택합니다.

1. 스캔 작업이 성공할 수 있는 조건식이 충족되어야 할 경우에는 다음을 수행합니다.

   1. **조건**을 선택합니다.

   1. 속성 이름, 비교 연산자, 속성 형식 및 속성 값을 지정합니다.

   1. 다른 조건이 필요할 경우에는 **조건**을 다시 선택합니다.

   자세한 내용은 [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) 작업 지침을 따릅니다.

   작업 순서를 변경하려면 좌측 목록에서 작업을 선택한 다음 위쪽 또는 아래쪽 화살표를 선택하여 목록에서 위로 또는 아래로 옮깁니다.

   작업을 삭제하려면 목록에서 작업을 선택한 다음 **삭제**(휴지통) 아이콘을 선택합니다.

1. 작업을 수행하려면 **실행**을 선택하고, 저장하려면 **작업 저장**을 선택하며, 해당 코드를 생성하려면 **코드 생성**을 선택합니다.

트랜잭션에 대한 자세한 내용은 [Amazon DynamoDB Transactions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html)를 참조하세요.