Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 `QueryInsights` é um atributo de ajuste de desempenho que ajuda você a otimizar suas consultas, reduzir custos e melhorar o desempenho. Com o `QueryInsights`, você pode avaliar a eficiência da redução de suas consultas e identificar áreas de melhoria para aprimorar o desempenho das consultas. Com o `QueryInsights`, você também pode analisar a eficácia de suas consultas em termos de redução temporal e espacial e identificar oportunidades para melhorar o desempenho. Especificamente, você pode avaliar o quão bem suas consultas usam estratégias de indexação baseadas em tempo e chave de partição para otimizar a recuperação de dados. Para otimizar o desempenho da consulta, é essencial que você faça o ajuste fino dos parâmetros temporais e espaciais que governam a execução da consulta.

As principais métricas fornecidas pelo `QueryInsights` são `QuerySpatialCoverage` e `QueryTemporalRange`. `QuerySpatialCoverage` indica quanto do eixo espacial a consulta digitaliza, com valores mais baixos sendo mais eficientes. `QueryTemporalRange` mostra o intervalo de tempo escaneado, com intervalos mais estreitos tendo melhor desempenho.

 **Benefícios do QueryInsights** 

Os benefícios principais de usar o `QueryInsights` são os seguintes:
+  **Identificação de consultas ineficientes** — `QueryInsights` fornece informações sobre a remoção baseada em tempo e em atributos das tabelas acessadas pela consulta. Essas informações ajudarão você a identificar as tabelas que não são acessadas de forma ideal.
+  **Otimizar seu modelo de dados e particionamento** — Você pode usar as informações do `QueryInsights` para acessar e ajustar seu modelo de dados e sua estratégia de particionamento.
+  **Ajuste de consultas** — `QueryInsights` destaca as oportunidades de usar índices com mais eficiência.

**nota**  
O número máximo de solicitações de API `Query` que você pode fazer com o `QueryInsights` ativado é de 1 consulta por segundo (QPS). Se você exceder essa taxa de consulta, isso poderá resultar em um controle de utilização.

## Conteúdo
<a name="API_query_QueryInsights_Contents"></a>

 ** Mode **   <a name="timestream-Type-query_QueryInsights-Mode"></a>
Fornece os seguintes modos para ativar o `QueryInsights`:  
+  `ENABLED_WITH_RATE_CONTROL` – Ativa `QueryInsights` para as consultas que estão sendo processadas. Esse modo também inclui um mecanismo de controle de taxa, que limita o atributo `QueryInsights` a 1 consulta por segundo (QPS).
+  `DISABLED` – Desativa `QueryInsights`.
Tipo: String  
Valores Válidos: `ENABLED_WITH_RATE_CONTROL | DISABLED`   
Exigido: Sim

## Consulte também
<a name="API_query_QueryInsights_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
+  [AWS SDK para 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 para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights)