# NoSQL Workbench로 데이터 세트 탐색 및 작업 빌드 Amazon DynamoDB용 NoSQL Workbench는 쿼리 개발 및 테스트를 위한 풍부한 그래픽 사용자 인터페이스를 제공합니다. NoSQL Workbench에서 작업 빌더를 사용하여 실시간 데이터 세트를 보고, 탐색하고, 쿼리할 수 있습니다. 구조화된 작업 빌더는 프로젝션 표현식, 조건식을 지원하고 여러 언어로 샘플 코드를 생성합니다. 한 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) # 실시간 데이터 세트에 연결 NoSQL Workbench를 사용하여 Amazon DynamoDB 테이블에 연결하려면 먼저 AWS 계정에 연결해야 합니다. **데이터베이스에 연결 추가하기** 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 Local](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html)(다운로드 버전)을 사용하려는 경우: 1. 연결 화면에서 **Local**(로컬) 탭을 선택합니다. 1. 다음과 같은 정보를 지정합니다. + **연결 이름**: + **포트** 1. **연결** 버튼을 선택합니다. **참고** DynamoDB 로컬에 연결하려면 터미널을 사용하여 DynamoDB 로컬을 수동으로 시작하거나([deploying DynamoDB local on your computer](DynamoDBLocal.DownloadingAndRunning.md) 참조) NoSQL Workbench 탐색 메뉴에서 DDB 로컬 토글을 사용하여 DynamoDB 로컬을 직접 시작하세요. 연결 포트가 DynamoDB 로컬 포트와 동일한지 확인하세요. 1. 생성된 연결에서 **열기**를 선택합니다. DynamoDB 데이터베이스에 연결하면 사용 가능한 테이블 목록이 왼쪽 창에 나타납니다. 테이블 중 하나를 선택하면 테이블에 저장된 데이터의 샘플이 반환됩니다. 이제 선택한 테이블에 대해 쿼리를 실행할 수 있습니다. 테이블에서 쿼리를 실행하려면 작업 빌드에 대한 다음 단원 및 [복잡한 작업 빌드](workbench.querybuilder.operationbuilder.md) 단원을 참조하세요. # 복잡한 작업 빌드 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 문 빌드 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 문 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**(저장)를 선택합니다. ## 트랜잭션 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**(저장)를 선택합니다. ## 배치 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**(저장)를 선택합니다. # API 작업 빌드 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) ## 테이블 삭제 `Delete Table` 작업을 실행하려면 다음을 수행합니다. 1. **테이블** 섹션에서 삭제하려는 테이블을 찾습니다. 1. 가로 줄임표 메뉴에서 **테이블 삭제**를 선택합니다. 1. **테이블 이름**을 입력하여 테이블을 삭제하려 한다는 것을 확인합니다. 1. **삭제**를 선택합니다. 이 작업에 대한 자세한 내용은 *Amazon DynamoDB API 참조*에서 [테이블 삭제](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html)를 참조하세요. ## GSI 삭제 `Delete GSI` 작업을 실행하려면 다음을 수행합니다. 1. **테이블** 섹션에서 삭제하려는 테이블의 GSI를 찾습니다. 1. 가로 줄임표 메뉴에서 **GSI 삭제**를 선택합니다. 1. **GSI 이름**을 입력하여 GSI를 삭제하려 한다는 것을 확인합니다. 1. **삭제**를 선택합니다. 이 작업에 대한 자세한 내용은 *Amazon DynamoDB API 참조*에서 [테이블 삭제](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html)를 참조하세요. ## 테이블 생성 `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 생성 `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)을 참조하세요. ## 테이블 업데이트 `Update Table` 작업으로 테이블의 용량 설정을 업데이트하려면 다음을 수행합니다. 1. 용량 설정을 업데이트하려는 테이블을 찾습니다. 1. 가로 줄임표 메뉴에서 **용량 설정 업데이트**를 선택합니다. 1. **프로비저닝된 용량** 또는 **온디맨드 용량**을 선택합니다. **프로비저닝된 용량**을 선택한 경우 최소 및 최대 읽기와 쓰기 용량 단위를 설정할 수 있습니다. 또한 오토 스케일링을 사용 설정하거나 사용 중지할 수 있습니다. 1. **업데이트**를 선택합니다. 이 작업에 대한 자세한 내용은 *Amazon DynamoDB API 참조*에서 [테이블 업데이트](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)를 참조하세요. ## GSI 업데이트 `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)를 참조하세요. ## 항목 추가 `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)을 참조하세요. ## 항목 업데이트 `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)을 참조하세요. ## 항목 삭제 `Delete Item` 작업을 실행하려면 다음을 수행합니다. 1. 항목을 삭제하려는 테이블을 찾습니다. 1. 항목을 선택합니다. 1. **작업** 드롭다운에서 **항목 삭제**를 선택합니다. 1. **삭제**를 선택하여 항목을 삭제하려 한다는 것을 확인합니다. 이 작업에 대한 자세한 내용은 *Amazon DynamoDB API 참조*에서 [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)을 참조하세요. ## 항목 복제 속성이 동일한 새 항목을 생성하여 항목을 복제할 수 있습니다. 항목을 복제하려면 다음을 수행합니다. 1. 항목을 복제하려는 테이블을 찾습니다. 1. 항목을 선택합니다. 1. **작업** 드롭다운에서 **항목 복제**를 선택합니다. 1. 새 파티션 키를 지정합니다. 1. 새 정렬 키를 지정합니다(필요한 경우). 1. **실행**을 선택합니다. 이 작업에 대한 자세한 내용은 *Amazon DynamoDB API 참조*에서 [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)을 참조하세요. ## 쿼리 `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)를 참조하세요. ## 스캔 `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 `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 `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)를 참조하세요. # NoSQL Workbench로 테이블 복제 테이블을 복제하면 개발 환경 간에 테이블의 키 스키마(및 선택적으로 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으로 두면 됩니다. 복제할 수 있는 최대 항목 수는 5,000개입니다. 1. 용량 모드를 선택합니다. 1. **온디맨드 모드**가 기본적으로 선택됩니다. DynamoDB on-demand는 읽기 및 쓰기 요청에 대해 요청당 지불 가격을 제공하므로 사용하는 만큼에 대해서만 비용을 지불하면 됩니다. 자세히 알아보려면 [DynamoDB On-demand mode](capacity-mode.md#capacity-mode-on-demand) 모드를 참조하세요. 1. **프로비저닝된 모드**를 사용하면 애플리케이션에 필요한 초당 읽기 및 쓰기 횟수를 지정할 수 있습니다. Auto Scaling을 사용하여 트래픽 변경에 따라 테이블의 프로비저닝된 용량을 자동으로 조정할 수 있습니다. 자세히 알아보려면 [DynamoDB Provisioned mode](provisioned-capacity-mode.md)를 참조하세요. 1. **복제**를 선택하여 복제를 시작합니다. 1. 복제 프로세스는 백그라운드에서 실행됩니다. 복제 테이블 상태가 변경될 경우 **작업 빌더** 탭에 알림이 표시됩니다. **작업 빌더** 탭을 선택한 다음 화살표 버튼을 선택하여 이 상태에 액세스할 수 있습니다. 화살표 버튼은 메뉴 사이드바 하단 근처의 테이블 복제 상태 위젯에 있습니다. # 데이터를 CSV 파일로 내보내기 쿼리 결과를 작업 빌더에서 CSV 파일로 내보낼 수 있습니다. 이렇게 하면 스프레드시트에 데이터를 로드하거나 원하는 프로그래밍 언어를 사용하여 처리할 수 있습니다. **CSV로 내보내기** 1. 작업 빌더에서 스캔 또는 쿼리 등의 원하는 작업을 실행합니다. **참고** 읽기 API 작업 및 PartiQL 문의 결과만 CSV 파일로 내보낼 수 있습니다. 트랜잭션 읽기 문의 결과는 내보낼 수 없습니다. 현재는 결과를 한 번에 한 페이지씩 CSV 파일로 내보낼 수 있습니다. 결과 페이지가 여러 개인 경우 각 페이지를 개별적으로 내보내야 합니다. 1. 결과에서 내보내려는 항목을 선택합니다. 1. **작업** 드롭다운에서 **CSV로 내보내기**를 선택합니다. 1. CSV 파일의 파일 이름과 위치를 선택한 다음 **저장(Save)**을 선택합니다.