AWS CLI 사용

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

DynamoDB에서 AWS CLI를 사용하려면 액세스 키 ID와 보안 액세스 키를 얻어야 합니다. 자세한 설명은 프로그래밍 방식 액세스 권한 부여 섹션을 참조하세요.

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인 테이블이 생성됩니다. 파티션 키는 아티스트이고 정렬 키는 입니다 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"
    }
}

이제 AWS CLI를 사용하여 Query 요청을 발행할 수 있습니다. 이 예제에서는 --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 값을 수정합니다.

참고

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