쿼리 구문 - AWS IoT Core
지원 기능지원되지 않는 기능참고

쿼리 구문

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

지원 기능

쿼리 구문은 다음 기능을 지원합니다.

  • 용어 및 구

  • 필드 검색

  • 접두사 검색

  • 범위 검색

  • 부울 연산자 AND, OR, NOT 및 –. 하이픈은 검색 결과에서 일부를 제외하는데 사용됩니다(예: thingName:(tv* AND -plasma)).

  • 그룹화

  • 필드 그룹화

  • 특수 문자의 이스케이프 처리(예: \ 사용)

  • 선행 와일드카드 사용은 쿼리당 쿼리 용어 1개로 제한됩니다. 예를 들어 thingName:*my 및 thingGroupNames:*echo 모두를 동일한 쿼리에서 검색할 수는 없습니다. 선행 와일드카드가 포함된 쿼리의 최대 쿼리 길이는 100자입니다.

    참고

    플릿 인덱싱 API에 대해 높은 제한 증가가 부여된 경우 제한이 감소할 때까지 해당 API에 대해 선행 와일드카드 기능을 사용하지 못할 수 있습니다.

지원되지 않는 기능

쿼리 구문은 다음 기능을 지원하지 않습니다.

  • 정규식

  • 부스팅

  • 순위 결정

  • 퍼지 검색

  • 근접 검색

  • 정렬

  • 집계

  • 특수 문자: `, @, #, %, \, /, ', ; 및 ,. ,는 지오쿼리에서만 지원됩니다.

참고

쿼리 언어에 대해서 알아야 할 몇 가지가 있습니다.

  • 기본 연산자는 AND입니다. "thingName:abc thingType:xyz"에 대한 쿼리는 "thingName:abc AND thingType:xyz"와 같습니다.

  • 필드가 지정되지 않은 경우 AWS IoT는 모든 레지스트리, 디바이스 섀도우 및 Device Defender 필드에서 해당 용어를 검색합니다.

  • 모든 필드 이름은 대/소문자를 구분합니다.

  • 검색은 대/소문자를 구분하지 않습니다. 단어는 Java의 Character.isWhitespace(int)에 의해 정의된 대로 공백 문자로 구분됩니다.

  • 디바이스 섀도우 데이터(이름 없는 섀도우 및 명명된 섀도우)의 인덱싱에는 보고된 섹션, 원하는 섹션, 델타 섹션 및 메타데이터 섹션이 포함됩니다.

  • 디바이스 섀도우 및 레지스트리 버전은 검색할 수 없지만 응답에 표시됩니다.

  • 쿼리 1개의 최대 용어 수는 12개입니다.

  • 특수 문자 ,는 지오쿼리에서만 지원됩니다.