API 작업 빌드 - Amazon DynamoDB

API 작업 빌드

NoSQL Workbench를 사용하여 DynamoDB CRUD API를 빌드하려면 NoSQL Workbench 사용자 인터페이스의 왼쪽에서 작업 빌더를 선택합니다.

그런 다음, 열기를 선택하고 연결을 선택합니다.

작업 빌더에서 다음 작업을 수행할 수 있습니다.

테이블 삭제

Delete Table 작업을 실행하려면 다음을 수행합니다.

  1. 테이블 섹션에서 삭제하려는 테이블을 찾습니다.

  2. 가로 줄임표 메뉴에서 테이블 삭제를 선택합니다.

  3. 테이블 이름을 입력하여 테이블을 삭제하려 한다는 것을 확인합니다.

  4. 삭제를 선택합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 테이블 삭제를 참조하세요.

GSI 삭제

Delete GSI 작업을 실행하려면 다음을 수행합니다.

  1. 테이블 섹션에서 삭제하려는 테이블의 GSI를 찾습니다.

  2. 가로 줄임표 메뉴에서 GSI 삭제를 선택합니다.

  3. GSI 이름을 입력하여 GSI를 삭제하려 한다는 것을 확인합니다.

  4. 삭제를 선택합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 테이블 삭제를 참조하세요.

테이블 생성

Create Table 작업을 실행하려면 다음을 수행합니다.

  1. 테이블 섹션 옆에 있는 + 아이콘을 선택합니다.

  2. 원하는 테이블 이름을 입력합니다.

  3. 파티션 키를 생성합니다.

  4. 선택 사항: 정렬 키를 생성합니다.

  5. 용량 설정을 사용자 지정하려면 기본 용량 설정 사용 옆의 확인란을 선택 취소합니다.

    • 이제 프로비저닝됨(Provisioned) 또는 온디맨드(On-demand) 용량을 선택할 수 있습니다.

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

    • 테이블이 현재 온디맨드로 설정되어 있으면 프로비저닝된 처리량을 지정할 수 없습니다.

    • 온디맨드에서 프로비저닝된 처리량으로 전환하면 Auto Scaling이 최소 1, 최대 10, 목표 70%로 모든 GSI에 자동으로 적용됩니다.

  6. GSI 없이 이 테이블을 생성하려면 GSI 건너뛰기 및 생성을 선택합니다. 필요에 따라 다음을 선택하여 이 새 테이블로 GSI를 생성할 수 있습니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 테이블 생성을 참조하세요.

GSI 생성

Create GSI 작업을 실행하려면 다음을 수행합니다.

  1. GSI를 추가하려는 테이블을 찾습니다.

  2. 가로 줄임표 메뉴에서 GSI 생성을 선택합니다.

  3. 인덱스 이름 아래에 GSI 이름을 지정합니다.

  4. 파티션 키를 생성합니다.

  5. 선택 사항: 정렬 키를 생성합니다.

  6. 드롭다운에서 프로젝션 유형 옵션을 선택합니다.

  7. GSI 생성을 선택합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 테이블 생성을 참조하세요.

테이블 업데이트

Update Table 작업으로 테이블의 용량 설정을 업데이트하려면 다음을 수행합니다.

  1. 용량 설정을 업데이트하려는 테이블을 찾습니다.

  2. 가로 줄임표 메뉴에서 용량 설정 업데이트를 선택합니다.

  3. 프로비저닝된 용량 또는 온디맨드 용량을 선택합니다.

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

  4. 업데이트를 선택합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 테이블 업데이트를 참조하세요.

GSI 업데이트

Update Table 작업으로 GSI의 용량 설정을 업데이트하려면 다음을 수행합니다.

참고

기본적으로 글로벌 보조 인덱스는 기본 테이블의 용량 설정을 상속받습니다. 글로벌 보조 인덱스는 기본 테이블이 프로비저닝된 용량 모드인 경우에만 다른 용량 모드를 가질 수 있습니다. 프로비저닝된 모드 테이블에서 글로벌 보조 인덱스를 생성할 때는 해당 인덱스에 예상되는 워크로드에 대한 읽기 및 쓰기 용량 단위를 지정해야 합니다. 자세한 내용은 글로벌 보조 인덱스에 대한 프로비저닝된 처리량 고려 사항 단원을 참조하십시오.

  1. 용량 설정을 업데이트하려는 GSI를 찾습니다.

  2. 가로 줄임표 메뉴에서 용량 설정 업데이트를 선택합니다.

  3. 이제 프로비저닝됨(Provisioned) 또는 온디맨드(On-demand) 용량을 선택할 수 있습니다.

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

  4. 업데이트를 선택합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 테이블 업데이트를 참조하세요.

항목 추가

Put Item 작업을 사용하여 항목을 생성합니다. Put Item 작업의 코드를 실행하거나 생성하려면 다음을 수행합니다.

  1. 항목을 생성하려는 테이블을 찾습니다.

  2. 작업 드롭다운에서 항목 생성을 선택합니다.

  3. 파티션 키 값을 입력합니다.

  4. 있는 경우 정렬 키 값을 입력합니다.

  5. 비-키 속성을 추가하려면 다음을 수행합니다.

    1. + 다른 속성 추가를 선택합니다.

    2. 속성 이름, 형식을 지정합니다.

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

    1. 조건을 선택합니다.

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

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

    자세한 내용은 DynamoDB 조건 표현식 CLI 예제 단원을 참조하십시오.

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

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

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

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

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 PutItem을 참조하세요.

항목 업데이트

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

  1. 항목을 업데이트하려는 테이블을 찾습니다.

  2. 항목을 선택합니다.

  3. 선택한 표현식의 속성 이름과 속성 값을 입력합니다.

  4. 표현식을 더 추가하려면 표현식 업데이트 드롭다운 목록에서 다른 표현식을 선택한 다음, + 아이콘을 선택합니다.

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

    1. 조건을 선택합니다.

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

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

    자세한 내용은 DynamoDB 조건 표현식 CLI 예제 단원을 참조하십시오.

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

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

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

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

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 UpdateItem을 참조하세요.

항목 삭제

Delete Item 작업을 실행하려면 다음을 수행합니다.

  1. 항목을 삭제하려는 테이블을 찾습니다.

  2. 항목을 선택합니다.

  3. 작업 드롭다운에서 항목 삭제를 선택합니다.

  4. 삭제를 선택하여 항목을 삭제하려 한다는 것을 확인합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 DeleteItem을 참조하세요.

항목 복제

속성이 동일한 새 항목을 생성하여 항목을 복제할 수 있습니다. 항목을 복제하려면 다음을 수행합니다.

  1. 항목을 복제하려는 테이블을 찾습니다.

  2. 항목을 선택합니다.

  3. 작업 드롭다운에서 항목 복제를 선택합니다.

  4. 새 파티션 키를 지정합니다.

  5. 새 정렬 키를 지정합니다(필요한 경우).

  6. 실행을 선택합니다.

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 DeleteItem을 참조하세요.

Query

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

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

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

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

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

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

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

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

  6. + 아이콘을 선택합니다.

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

  8. 속성이 더 필요한 경우에는 +를 선택합니다.

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

    1. 조건을 선택합니다.

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

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

    자세한 내용은 DynamoDB 조건 표현식 CLI 예제 단원을 참조하십시오.

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

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

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

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

이 작업에 대한 자세한 내용은 Amazon DynamoDB API 참조에서 Query를 참조하세요.

스캔

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

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

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

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

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

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

    1. 조건을 선택합니다.

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

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

    자세한 내용은 DynamoDB 조건 표현식 CLI 예제 단원을 참조하십시오.

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

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

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

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

TransactGetItems

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

  1. NoSQL Workbench UI 상단의 추가 작업 드롭다운에서 TransactGetItems를 선택합니다.

  2. TransactGetItem 근처의 + 아이콘을 선택합니다.

  3. 파티션 키를 지정합니다.

  4. 정렬 키를 지정합니다(필요한 경우).

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

트랜잭션에 대한 자세한 내용은 Amazon DynamoDB Transactions를 참조하세요.

TransactWriteItems

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

  1. NoSQL Workbench UI 상단의 추가 작업 드롭다운에서 TransactWriteItems를 선택합니다.

  2. 작업 드롭다운에서 작업을 선택합니다.

  3. TransactWriteItem 근처의 + 아이콘을 선택합니다.

  4. 작업 드롭다운에서 수행하려는 작업을 선택합니다.

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

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

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

트랜잭션에 대한 자세한 내용은 Amazon DynamoDB Transactions를 참조하세요.