# DynamoDB의 조건 및 필터 표현식, 연산자, 함수
<a name="Expressions.OperatorsAndFunctions"></a>

DynamoDB 테이블에서 데이터를 조작하려면 `PutItem`, `UpdateItem` 및 `DeleteItem` 작업을 사용합니다. 이러한 데이터 조작 작업의 경우 조건 표현식을 지정하여 어떤 항목을 수정할지를 결정할 수 있습니다. 조건 표현식이 true로 평가되는 경우 작업이 성공합니다. 그렇지 않으면 작업이 실패합니다.

이 섹션에서는 Amazon DynamoDB에서 필터 표현식 및 조건 표현식을 작성하기 위한 기본 제공 함수와 키워드에 대해 살펴봅니다. [DynamoDB를 사용한 함수 및 프로그래밍에 대한 자세한 내용은 [DynamoDB 및 AWS SDK를 사용한 프로그래밍](Programming.md) 및 DynamoDB API 참조](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/)를 참조하세요.

**Topics**
+ [필터 및 조건 표현식 구문](#Expressions.OperatorsAndFunctions.Syntax)
+ [비교 실행](#Expressions.OperatorsAndFunctions.Comparators)
+ [함수](#Expressions.OperatorsAndFunctions.Functions)
+ [논리 평가](#Expressions.OperatorsAndFunctions.LogicalEvaluations)
+ [괄호](#Expressions.OperatorsAndFunctions.Parentheses)
+ [조건식의 우선 순위](#Expressions.OperatorsAndFunctions.Precedence)

## 필터 및 조건 표현식 구문
<a name="Expressions.OperatorsAndFunctions.Syntax"></a>

아래의 구문 요약에서 {{피연산 함수}}는 다음과 같이 사용됩니다.
+ `Id`, `Title`, `Description`, `ProductCategory` 등의 최상위 속성
+ 내포 속성을 참조하는 문서 경로

```
condition-expression ::=
      {{operand}} comparator {{operand}}
    | {{operand}} BETWEEN {{operand}} AND {{operand}}
    | {{operand}} IN ( {{operand}} (',' {{operand}} (, ...) ))
    | function
    | {{condition}} AND {{condition}}
    | {{condition}} OR {{condition}}
    | NOT {{condition}}
    | ( {{condition}} )

comparator ::=
    =
    | <>
    | <
    | <=
    | >
    | >=

function ::=
    attribute_exists ({{path}})
    | attribute_not_exists ({{path}})
    | attribute_type ({{path}}, {{type}})
    | begins_with ({{path}}, {{substr}})
    | contains ({{path}}, {{operand}})
    | size ({{path}})
```

## 비교 실행
<a name="Expressions.OperatorsAndFunctions.Comparators"></a>

다음 비교기를 사용하여 피연산자를 단일 값과 비교합니다.
+ `{{a}} = {{b}}` - {{a}}가 {{b}}와 같은 경우 true입니다.
+ `{{a}} <> {{b}}` - {{a}}가 {{b}}와 같지 않은 경우 true입니다.
+ `{{a}} < {{b}}` - {{a}}가 {{b}}보다 작은 경우 true입니다.
+ `{{a}} <= {{b}}` - {{a}}가 {{b}}보다 작거나 같은 경우 true입니다.
+ `{{a}} > {{b}}` - {{a}}가 {{b}}보다 큰 경우 true입니다.
+ `{{a}} >= {{b}}` - {{a}}가 {{b}}보다 크거나 같은 경우 true입니다.

`BETWEEN` 및 `IN` 키워드를 사용하여 피연산 함수와 값의 범위 또는 열거된 값 목록을 비교합니다.
+ `{{a}} BETWEEN {{b}} AND {{c}}` - {{a}}가 {{b}}보다 크거나 같고 {{c}}보다 작거나 같은 경우 true입니다.
+ `{{a}} IN ({{b}}, {{c}}, {{d}}) ` - {{a}}가 목록의 임의 값({{b}}, {{c}}, {{d}} 값 등)과 같은 경우 true입니다. 목록에는 쉼표로 구분된 최대 100개의 값이 포함될 수 있습니다.

## 함수
<a name="Expressions.OperatorsAndFunctions.Functions"></a>

다음의 함수를 사용하여 항목에 속성이 존재하는지 판단하거나 속성 값을 평가합니다. 함수 이름은 대/소문자를 구분합니다. 중첩 속성의 경우 전체 문서 경로를 제공해야 합니다.


****  

| 함수 | 설명 | 
| --- | --- | 
| `attribute_exists ({{path}})` | `path`에 의해 지정된 속성이 항목에 포함되어 있는 경우 true입니다.<br />예: `Product` 테이블에 있는 항목에 측면 사진이 있는지를 확인합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html) | 
| `attribute_not_exists ({{path}})` | `path`에 의해 지정된 속성이 항목에 포함되어 있지 않은 경우 true입니다.<br />예: 항목에 `Manufacturer` 속성이 포함되어 있는지 확인합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html) | 
| `attribute_type ({{path}}, {{type}})` | 지정된 경로의 속성이 특정 데이터 유형인 경우 true. `type` 파라미터는 반드시 다음 값 중 하나이어야 합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br />`type` 파라미터에는 반드시 표현식 속성 값을 사용해야 합니다.<br />예: `QuantityOnHand` 속성이 List 유형인지 확인합니다. 위의 예에서 `:v_sub`가 `L` 문자열의 자리 표시자입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br />`type` 파라미터에는 반드시 표현식 속성 값을 사용해야 합니다. | 
| `begins_with ({{path}}, {{substr}})` | `path`에 의해 지정된 속성이 특정 하위 문자열로 시작하는 경우 true입니다.<br />예: 정면 사진 URL이 `http://`로 시작되는지 확인합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br />수식 속성 값인 `:v_sub`가 `http://`의 자리 표시자입니다. | 
| `contains ({{path}}, {{operand}})` | `path`에 의해 지정된 속성이 다음에 해당하는 경우 true입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br />`path`에서 지정한 속성이 `String`인 경우 `operand`는 `String`이어야 합니다. `path`에서 지정한 속성이 `Set`인 경우 `operand`는 집합의 요소 형식이어야 합니다.<br />경로와 피연산자는 서로 달라야 합니다. 즉, `contains (a, a)`는 오류를 반환합니다.<br />예: `Brand` 속성에 하위 문자열 `Company`가 포함되어 있는지 확인합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br />수식 속성 값인 `:v_sub`가 `Company`의 자리 표시자입니다.<br />예: 빨간색 제품 색상을 선택할 수 있는지 확인합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br />수식 속성 값인 `:v_sub`가 `Red`의 자리 표시자입니다. | 
| `size ({{path}})` | 속성의 크기를 나타내는 숫자가 반환됩니다. `size`를 사용하는 데 유효한 데이터 유형은 다음과 같습니다.<br /><br />속성이 `String` 유형인 경우, `size`에서는 문자열의 길이가 반환됩니다.<br />예: `Brand` 문자열이 20자 이하인지 확인합니다. 수식 속성 값인 `:v_sub`가 `20`의 자리 표시자입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br /><br />속성이 `Binary` 유형인 경우, `size`에서는 속성 값의 바이트 수가 반환됩니다.<br />예: `ProductCatalog` 항목에 사용 중인 제품의 동영상 클립이 포함된 `VideoClip`이라는 바이너리 속성이 있는 경우를 가정할 수 있습니다. 다음 수식은 `VideoClip`이 64,000 바이트를 초과하는지 확인합니다. 수식 속성 값인 `:v_sub`가 `64000`의 자리 표시자입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br /><br />속성이 `Set` 데이터 유형인 경우, `size`에서는 집합에 포함된 요소의 개수가 반환됩니다.<br />예: 한 가지 이상의 제품 색상을 선택할 수 있는지 확인합니다. 수식 속성 값인 `:v_sub`가 `1`의 자리 표시자입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html)<br /><br />속성이 `List` 또는 `Map` 유형인 경우, `size`에서는 집합에 포함된 요소의 개수가 반환됩니다.<br />예: `OneStar` 리뷰의 개수가 특정 임계 값을 초과하는지 확인합니다. 수식 속성 값인 `:v_sub`가 `3`의 자리 표시자입니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html) | 

## 논리 평가
<a name="Expressions.OperatorsAndFunctions.LogicalEvaluations"></a>

`AND`, `OR` 및 `NOT` 키워드를 사용하여 논리 평가를 수행합니다. 아래의 목록에서 {{a}}와 {{b}}는 평가될 조건을 나타냅니다.
+ `{{a}} AND {{b}}` - {{a}}와 {{b}}가 모두 true인 경우 true입니다.
+ `{{a}} OR {{b}}` - {{a}} 또는 {{b}}(또는 둘 모두)가 true인 경우 true입니다.
+ `NOT {{a}}` - {{a}}가 false인 경우 true입니다. {{a}}가 true인 경우 false입니다.

다음은 연산에서 AND를 사용한 코드 예제입니다.

`dynamodb-local (*)> select * from exprtest where a > 3 and a < 5;`

## 괄호
<a name="Expressions.OperatorsAndFunctions.Parentheses"></a>

논리 평가의 우선 순위를 변경하려면 괄호를 사용합니다. 예를 들어 {{a}} 및 {{b}} 조건이 true이고 {{c}} 조건이 false인 경우를 가정할 수 있습니다. 다음 수식들은 true로 평가됩니다.
+ `{{a}} OR {{b}} AND {{c}}`

그러나 조건을 괄호로 묶으면 해당 조건을 먼저 평가하게 됩니다. 예를 들어 아래의 경우에는 false로 평가됩니다.
+  `({{a}} OR {{b}}) AND {{c}}`

**참고**  
수식에 괄호를 포함시킬 수 있습니다. 가장 안쪽에 위치한 괄호부터 먼저 평가됩니다.

다음은 논리 평가에 괄호가 포함된 코드 예제입니다.

`dynamodb-local (*)> select * from exprtest where attribute_type(b, string) or ( a = 5 and c = “coffee”);`

## 조건식의 우선 순위
<a name="Expressions.OperatorsAndFunctions.Precedence"></a>

 DynamoDB는 다음의 우선 순위 규칙을 사용하여 왼쪽에서 오른쪽 방향으로 조건식을 평가합니다.
+ `= <> < <= > >=`
+ `IN`
+ `BETWEEN`
+ `attribute_exists attribute_not_exists begins_with contains`
+ 괄호
+ `NOT`
+ `AND`
+ `OR`