

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.

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

# QueryInsights
<a name="API_query_QueryInsights"></a>

 `QueryInsights`는 쿼리를 최적화하여 비용을 절감하고 성능을 개선하는 데 도움이 되는 성능 튜닝 기능입니다. `QueryInsights`를 사용하면 쿼리의 정리 효율성을 평가하고 쿼리 성능 향상을 위한 개선 영역을 파악할 수 있습니다. `QueryInsights`를 사용하면 시간 및 공간 정리 측면에서 쿼리의 효과를 분석하고 성능을 개선할 기회를 식별할 수도 있습니다. 특히 쿼리가 시간 기반 및 파티션 키 기반 인덱싱 전략을 얼마나 잘 활용하여 데이터 검색을 최적화하는지 평가할 수 있습니다. 쿼리 성능을 최적화하려면 쿼리 실행을 제어하는 시간적 및 공간적 파라미터를 모두 미세 조정하는 것이 필수적입니다.

`QueryInsights`에서 제공하는 주요 지표는 `QuerySpatialCoverage`와 `QueryTemporalRange`입니다. `QuerySpatialCoverage`는 쿼리가 공간 축을 얼마나 많이 스캔하는지를 나타내며, 값이 낮을수록 효율성이 높습니다. `QueryTemporalRange`는 스캔한 시간 범위를 보여주며, 범위가 좁을수록 성능이 향상됩니다.

 **QueryInsights의 이점** 

다음은 `QueryInsights` 사용에 따른 주요 이점입니다.
+  **비효율적인 쿼리 식별** - `QueryInsights`는 쿼리에서 액세스하는 테이블의 시간 기반 및 속성 기반 정리에 대한 정보를 제공합니다. 이 정보는 액세스 효율이 낮은 테이블을 식별하는 데 도움이 됩니다.
+  **데이터 모델 및 파티셔닝 최적화** - `QueryInsights` 정보를 사용하여 데이터 모델 및 파티셔닝 전략에 액세스하고 미세 조정할 수 있습니다.
+  **쿼리 튜닝** - `QueryInsights`는 인덱스를 보다 효과적으로 사용할 수 있는 기회를 강조합니다.

**참고**  
`QueryInsights`가 활성화된 상태에서 수행할 수 있는 최대 `Query` API 요청 수는 초당 쿼리(QPS) 1개입니다. 이 쿼리 속도를 초과하면 스로틀링이 발생할 수 있습니다.

## 내용
<a name="API_query_QueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_QueryInsights-Mode"></a>
`QueryInsights`를 활성화하기 위한 다음 모드를 제공합니다.  
+  `ENABLED_WITH_RATE_CONTROL` - 처리 중인 쿼리에 대해 `QueryInsights`를 활성화합니다. 이 모드에는 `QueryInsights` 기능의 초당 쿼리(QPS) 수를 1개로 제한하는 속도 제어 메커니즘도 포함되어 있습니다.
+  `DISABLED` - `QueryInsights`를 비활성화합니다.
타입: 문자열  
유효 값: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
필수 여부: 예

## 참고
<a name="API_query_QueryInsights_SeeAlso"></a>

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) 