Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](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 リクエストの最大数は、1 クエリ/秒 (QPS) です。このクエリレートを超えると、スロットリングが発生する可能性があります。

## 内容
<a name="API_query_QueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_QueryInsights-Mode"></a>
`QueryInsights` を有効にする次のモードを提供します。  
+  `ENABLED_WITH_RATE_CONTROL` – 処理中のクエリに対して `QueryInsights` を有効にします。このモードには、`QueryInsights` 機能を 1 クエリ/秒 (QPS) に制限するレート制御メカニズムも含まれています。
+  `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)