AWS CLI 사용 - Amazon DynamoDB

AWS CLI 사용

AWS Command Line Interface(AWS CLI)를 사용하면 명령줄에서 여러 AWS 서비스를 관리하고 스크립트를 통해 자동화할 수 있습니다. 테이블 생성과 같이 특별 작업을 수행할 때 AWS CLI를 사용할 수 있습니다. 또한 이를 사용하여 Amazon DynamoDB 작업을 유틸리티 스크립트 내에 포함할 수 있습니다.

DynamoDB에서 AWS CLI를 사용하려면 액세스 키 ID와 보안 액세스 키를 얻어야 합니다. 자세한 내용은 AWS 액세스 키 가져오기 섹션을 참조하세요.

AWS CLI의 DynamoDB에 사용할 수 있는 모든 명령의 전체 목록을 보려면 AWS CLI 명령 레퍼런스를 참조하십시오.

AWS CLI 다운로드 및 구성

AWS CLI는 http://aws.amazon.com/cli에서 사용할 수 있습니다. Windows, macOS 또는 Linux에서 실행됩니다. AWS CLI 다운로드 후 다음 단계에 따라 설치 및 구성합니다.

  1. AWS Command Line Interface 사용 설명서로 이동합니다.

  2. AWS CLI 설치AWS CLI 구성 지침을 따릅니다.

DynamoDB와 함께 AWS CLI 사용

명령줄 형식은 DynamoDB 작업 이름과 뒤에 나오는 해당 작업 파라미터로 구성됩니다. AWS CLI는 파라미터 값의 간편 구문과 JSON을 지원합니다.

예를 들어, 다음 명령을 사용하면 이름이 Music인 테이블이 생성됩니다. 파티션 키는 Artist이고 정렬 키는 SongTitle입니다. (읽기 쉽도록 이 단원에서는 긴 명령이 여러 줄로 나누어져 있습니다.)

aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1 \ --table-class STANDARD

다음 명령을 통해 테이블에 새 항목이 추가됩니다. 본 예제에서 간편 구문과 JSON이 함께 사용됩니다.

aws dynamodb put-item \ --table-name Music \ --item \ '{"Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"}}' \ --return-consumed-capacity TOTAL aws dynamodb put-item \ --table-name Music \ --item '{ \ "Artist": {"S": "Acme Band"}, \ "SongTitle": {"S": "Happy Day"}, \ "AlbumTitle": {"S": "Songs About Life"} }' \ --return-consumed-capacity TOTAL

명령줄에서는 유효한 JSON을 작성하기가 어려울 수 있지만, AWS CLI는 JSON 파일을 읽을 수 있습니다. 아래에서 이름이 key-conditions.json인 파일에 저장되어 있는 JSON 코드 조각을 예로 들어보겠습니다.

{ "Artist": { "AttributeValueList": [ { "S": "No One You Know" } ], "ComparisonOperator": "EQ" }, "SongTitle": { "AttributeValueList": [ { "S": "Call Me Today" } ], "ComparisonOperator": "EQ" } }

이제 Query를 사용하여 AWS CLI 요청을 발행할 수 있습니다. 이 예제에서는 --key-conditions 파라미터에 key-conditions.json 파일의 콘텐츠가 사용됩니다.

aws dynamodb query --table-name Music --key-conditions file://key-conditions.json

다운로드 가능 DynamoDB에서 AWS CLI 사용

AWS CLI는 컴퓨터에서 실행되는 DynamoDB(다운로드 가능 버전)와 상호 작용할 수도 있습니다. 이렇게 하려면 다음 파라미터를 각 명령에 추가합니다.

--endpoint-url http://localhost:8000

다음은 AWS CLI를 사용하여 로컬 데이터베이스에 테이블을 나열하는 예제입니다.

aws dynamodb list-tables --endpoint-url http://localhost:8000

DynamoDB에서 기본값(8000)이 아닌 다른 포트 번호를 사용하는 경우 그에 따라 --endpoint-url 값을 수정합니다.

참고

AWS CLI는 기본 엔드포인트로 DynamoDB 다운로드 가능 버전을 사용할 수 없습니다. 따라서 각각의 명령어를 사용하여 --endpoint-url을 지정해야 합니다.