DynamoDB API - Amazon DynamoDB
컨트롤 플레인데이터 영역DynamoDB Streams트랜잭션

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DynamoDB API

Amazon DynamoDB를 사용하려면 애플리케이션에서 몇 가지 간단한 API 작업을 사용해야 합니다. 다음은 이러한 작업을 카테고리별로 정리한 요약본입니다.

참고

전체 API 작업 목록은 Amazon DynamoDB API 참조를 참조하세요.

컨트롤 플레인

제어 영역 작업을 사용하면 DynamoDB 테이블을 생성하고 관리할 수 있습니다. 또한 인덱스, 스트림 및 테이블에 따라 다른 다양한 객체를 사용하도록 해 줍니다.

  • CreateTable - 새 테이블을 생성합니다. 선택 사항으로, 하나 이상의 보조 인덱스를 생성하고 테이블에 DynamoDB Streams를 활성화할 수 있습니다.

  • DescribeTable - 기본 키 스키마, 처리량 설정, 인덱스 정보와 같은 테이블에 대한 정보를 반환합니다.

  • ListTables - 모든 테이블의 이름을 목록으로 반환합니다.

  • UpdateTable - 테이블 또는 해당 인덱스의 설정을 수정하거나, 테이블에서 새 인덱스를 생성 또는 제거하거나, 테이블의 DynamoDB Streams 설정을 수정합니다.

  • DeleteTable - DynamoDB에서 테이블 및 해당 종속적 객체 모두를 제거합니다.

데이터 영역

데이터 플레인 작업은 테이블의 데이터에 대해 생성, 읽기, 업데이트 및 삭제(CRUD) 작업을 수행하도록 해 줍니다. 또한 일부 데이터 영역 작업을 사용하여 보조 인덱스에서 데이터를 읽을 수 있습니다.

PartiQL - Amazon DynamoDB용 SQL 호환 쿼리 언어을 사용하여 이러한 CRUD 작업을 수행할 수도 있고 각 작업을 고유한 API 호출로 구분하는 DynamoDB의 클래식 CRUD API를 사용할 수도 있습니다.

PartiQL - SQL 호환 쿼리 언어

  • ExecuteStatement - 테이블에서 여러 항목을 읽습니다. 테이블에서 단일 항목을 쓰거나 업데이트할 수도 있습니다. 단일 항목을 쓰거나 업데이트할 때는 기본 키 속성을 지정해야 합니다.

  • BatchExecuteStatement - 테이블에서 여러 항목을 쓰거나, 업데이트하거나, 읽습니다. 항목을 쓰거나 읽을 때 애플리케이션이 네트워크를 한 번만 왕복하면 되므로 ExecuteStatement보다 더 효율적입니다.

클래식 API

데이터 생성

  • PutItem - 테이블에 단일 항목을 씁니다. 기본 키 속성은 꼭 지정해야 하지만 다른 속성은 지정하지 않아도 됩니다.

  • BatchWriteItem - 테이블에 최대 25개의 항목을 씁니다. 항목을 쓸 때 애플리케이션이 네트워크를 한 번만 왕복하면 되므로 PutItem을 여러 번 호출하는 것보다 이 작업이 효율적입니다.

데이터 읽기

  • GetItem - 테이블에서 단일 항목을 가져옵니다. 원하는 항목의 기본 키를 지정해야 합니다. 전체 항목 또는 속성 일부만 가져올 수 있습니다.

  • BatchGetItem - 하나 이상의 테이블에서 최대 100개의 항목을 가져옵니다. 항목을 읽을 때 애플리케이션이 네트워크를 한 번만 왕복하면 되므로 GetItem을 여러 번 호출하는 것보다 이 작업이 효율적입니다.

  • Query - 특정 파티션 키가 있는 모든 항목을 가져옵니다. 파티션 키 값을 지정해야 합니다. 전체 항목 또는 속성 일부만 가져올 수 있습니다. 경우에 따라 정렬 키 값에 조건을 적용하여 파티션 키가 동일한 데이터의 하위 집합만 검색할 수도 있습니다. 테이블에 파티션 키와 정렬 키가 모두 있는 경우 이러한 작업을 테이블에 사용할 수 있습니다. 또한 인덱스에 파티션 키와 정렬 키가 모두 있는 경우 이러한 작업을 인덱스에 사용할 수 있습니다.

  • Scan - 지정한 테이블 또는 인덱스의 모든 항목을 가져옵니다. 전체 항목 또는 속성 일부만 가져올 수 있습니다. 선택 사항으로, 필터링 조건을 적용하여 필요한 값만 반환하고 나머지는 버릴 수 있습니다.

데이터 업데이트

  • UpdateItem - 항목에서 하나 이상의 속성을 수정합니다. 수정하려는 항목의 기본 키를 지정해야 합니다. 새로운 속성을 추가할 수 있으며 기존 속성을 수정하거나 제거할 수 있습니다. 조건부 업데이트를 수행하여 사용자 정의 조건을 만족할 때만 업데이트가 수행되도록 할 수도 있습니다. 선택 사항으로, 원자성 카운터를 구현할 수 있습니다. 이는 다른 쓰기 요청과 충돌하지 않고도 숫자 속성을 증감합니다.

데이터 삭제

  • DeleteItem - 테이블에서 단일 항목을 삭제합니다. 삭제하려는 항목의 기본 키를 지정해야 합니다.

  • BatchWriteItem - 하나 이상의 테이블에서 최대 25개의 항목을 삭제합니다. 항목을 삭제할 때 애플리케이션이 네트워크를 한 번만 왕복하면 되므로 DeleteItem을 여러 번 호출하는 것보다 이 작업이 효율적입니다.

    참고

    데이터 생성과 삭제에 모두 BatchWriteItem을 사용할 수 있습니다.

DynamoDB Streams

DynamoDB Streams 작업을 사용하면 테이블에서 스트림을 활성화하거나 비활성화할 수 있으며, 스트림에 포함되어 있는 데이터 수정 레코드에 액세스할 수 있습니다.

  • ListStreams - 모든 스트림 목록 또는 특정 테이블의 스트림만 반환합니다.

  • DescribeStream - 해당 Amazon 리소스 이름(ARN) 및 애플리케이션이 처음 몇 개 스트림 레코드를 읽기 시작할 수 있는 위치와 같은 스트림에 대한 정보를 반환합니다.

  • GetShardIterator - 샤드 반복자를 반환합니다. 샤드 반복자는 애플리케이션이 스트림에서 레코드를 가져오는 데 사용하는 데이터 구조입니다.

  • GetRecords - 지정된 샤드 반복자를 사용하여 하나 이상의 스트림 레코드를 가져옵니다.

트랜잭션

트랜잭션은 원자성, 일관성, 격리 및 내구성(ACID)을 제공하여 애플리케이션에서 데이터의 정확성을 더 쉽게 유지할 수 있습니다.

PartiQL - Amazon DynamoDB용 SQL 호환 쿼리 언어을 사용하여 트랜잭션 작업을 수행할 수도 있고 각 작업을 고유한 API 호출로 구분하는 DynamoDB의 클래식 CRUD API를 사용할 수도 있습니다.

PartiQL - SQL 호환 쿼리 언어

  • ExecuteTransaction— 테이블 내부 및 테이블 간의 여러 항목에 대해 CRUD 작업을 수행하여 결과를 보장할 수 있는 일괄 작업입니다. all-or-nothing

클래식 API

  • TransactWriteItems— 테이블 내부 및 테이블 간에 여러 항목에 대한 PutUpdate, 및 Delete 작업을 허용하고 all-or-nothing 결과를 보장하는 배치 작업입니다.

  • TransactGetItems - 하나 이상의 테이블에서 여러 항목을 가져오는 Get 작업을 허용하는 배치 작업입니다.