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

# 쿼리 구문
<a name="query-syntax"></a>

플릿 인덱싱에서는 쿼리 구문을 사용하여 쿼리를 지정합니다.

## 지원되는 기능
<a name="supported-query-syntax"></a>

쿼리 구문은 다음 기능을 지원합니다.
+ 용어 및 구
+ 필드 검색
+ 접두사 검색
+ 범위 검색
+ 부울 연산자 `AND`, `OR`, `NOT` 및 `–`. 하이픈은 검색 결과에서 일부를 제외하는데 사용됩니다(예: `thingName:(tv* AND -plasma)`).
+ 그룹화
+ 필드 그룹화
+ 특수 문자의 이스케이프 처리(예: *\$1* 사용)
+ 선행 와일드카드 사용은 쿼리당 쿼리 용어 1개로 제한됩니다. 예를 들어 `thingName:*my` 및 `thingGroupNames:*echo` 모두를 동일한 쿼리에서 검색할 수는 없습니다. 선행 와일드카드가 포함된 쿼리의 최대 쿼리 길이는 100자입니다.
**참고**  
 플릿 인덱싱 쿼리 API 제한이 초당 요청 30개를 초과하는 계정은 선행 와일드카드 쿼리 용어를 사용할 때 제한이 적용됩니다. 이 requests-per-second 30개 한도는 모든 플릿 인덱싱 쿼리 APIs의 계정 수준에서 적용됩니다.

## 지원되지 않는 기능
<a name="unsupported-query-syntax"></a>

쿼리 구문은 다음 기능을 지원하지 않습니다.
+ 정규식
+ 부스팅
+ 순위 결정
+ 퍼지 검색
+ 근접 검색
+ 정렬
+ 집계
+ 특수 문자: ```, `@`, `#`, `%`, `\`, `/`, `'`, `;` 및 `,`. `,`는 지오쿼리에서만 지원됩니다.

## 참고
<a name="query-syntax-limitations"></a>

쿼리 언어에 대해서 알아야 할 몇 가지가 있습니다.
+ 기본 연산자는 AND입니다. `"thingName:abc thingType:xyz"`에 대한 쿼리는 `"thingName:abc AND thingType:xyz"`와 같습니다.
+ 필드가 지정되지 않은 경우는 모든 레지스트리, 디바이스 섀도우 및 디바이스 디펜더 필드의 용어를 AWS IoT 검색합니다.
+ 모든 필드 이름은 대/소문자를 구분합니다.
+ 검색은 대/소문자를 구분하지 않습니다. 단어는 Java의 `Character.isWhitespace(int)`에 의해 정의된 대로 공백 문자로 구분됩니다.
+ 디바이스 섀도우 데이터(이름 없는 섀도우 및 명명된 섀도우)의 인덱싱에는 보고된 섹션, 원하는 섹션, 델타 섹션 및 메타데이터 섹션이 포함됩니다.
+ 디바이스 섀도우 및 레지스트리 버전은 검색할 수 없지만 응답에 표시됩니다.
+ 쿼리 1개의 최대 용어 수는 12개입니다.
+ 특수 문자 `,`는 지오쿼리에서만 지원됩니다.