

# AttributesToGet(레거시)
<a name="LegacyConditionalParameters.AttributesToGet"></a>

**참고**  
가능하면 이러한 레거시 파라미터 대신 새 표현식 파라미터를 사용하는 것이 좋습니다. 자세한 내용은 [DynamoDB에서 표현식 사용](Expressions.md) 섹션을 참조하세요. 이 파라미터를 대체하는 새 파라미터에 대한 자세한 내용은 [대신 *ProjectionExpression* 사용](#ProjectionExpression.instead) 섹션을 참조하세요.

레거시 조건 파라미터 `AttributesToGet`은 DynamoDB에서 검색되는 하나 이상의 속성 어레이입니다. 속성 이름을 제공하지 않으면 모든 속성이 반환됩니다. 요청한 속성을 찾을 수 없는 경우 결과에 표시되지 않습니다.

`AttributesToGet`을 사용하면 목록이나 맵 유형의 속성을 검색할 수 있지만 목록이나 맵 안의 개별 요소는 검색할 수 없습니다.

`AttributesToGet`은 할당 처리량에 영향을 주지 않습니다. DynamoDB는 애플리케이션에 반환되는 데이터 크기가 아닌 항목 크기를 기준으로 소비된 용량 단위를 결정합니다.

## 대신 *ProjectionExpression* 사용 - 예
<a name="ProjectionExpression.instead"></a>

*Music* 테이블에서 항목을 검색하고 싶은데, 속성 중 일부만 반환되길 원한다고 가정합니다. 다음 `GetItem` 예제에서와 같이 `AttributesToGet` 요청을 AWS CLI 파라미터와 함께 사용할 수 있습니다.

```
aws dynamodb get-item \
    --table-name Music \
    --attributes-to-get '["Artist", "Genre"]' \
    --key '{
        "Artist": {"S":"No One You Know"},
        "SongTitle": {"S":"Call Me Today"}
    }'
```

대신에 `ProjectionExpression`을 사용할 수 있습니다.

```
aws dynamodb get-item \
    --table-name Music \
    --projection-expression "Artist, Genre" \
    --key '{
        "Artist": {"S":"No One You Know"},
        "SongTitle": {"S":"Call Me Today"}
    }'
```