

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á.

# CloudTrail Consultas sobre o lago
<a name="cloudtrail-lake-queries"></a>

**nota**  
AWS CloudTrail O Lake não estará mais aberto a novos clientes a partir de 31 de maio de 2026. Se você gostaria de usar o CloudTrail Lake, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [CloudTrail Alteração na disponibilidade do lago](cloudtrail-lake-service-availability-change.md).

As consultas no CloudTrail Lake são criadas em SQL. Você pode criar uma consulta na guia CloudTrail Lake **Editor** escrevendo a consulta em SQL do zero, abrindo uma consulta salva ou de amostra e editando-a ou usando o gerador de consultas para produzir uma consulta a partir de um prompt em inglês. Você não pode sobrescrever uma consulta de exemplo incluída por suas alterações, mas você pode salvá-la como uma nova consulta. Para obter mais informações sobre a linguagem de consulta SQL permitida, consulte [CloudTrail Restrições do Lake SQL](query-limitations.md).

Uma consulta ilimitada (como `SELECT * FROM {{edsID}}`) verifica todos os dados no armazenamento de dados do seu evento. Para ajudar a controlar os custos, recomendamos que você restrinja as consultas adicionando carimbos de data/hora `eventTime` de início e término nas consultas. Veja a seguir um exemplo que pesquisa todos os eventos em um armazenamento de dados de eventos especificado, onde a hora do evento é depois de (`>`) 5 de janeiro de 2023 às 13h51 e antes de (`<`) 19 de janeiro de 2023 às 13h51. Como um armazenamento de dados de eventos tem um período de retenção mínimo de sete dias, o intervalo de tempo mínimo entre valores `eventTime` de início e término também é de sete dias.

```
SELECT *
FROM {{eds-ID}}
WHERE
     eventtime >='2023-01-05 13:51:00' and eventtime < ='2023-01-19 13:51:00'
```

Para obter mais informações sobre como otimizar as consultas, consulte [Otimize as consultas CloudTrail do Lake](lake-queries-optimization.md).

**Topics**
+ [Ferramentas do editor de consultas](#query-editor-format-controls)
+ [Crie consultas CloudTrail do Lake a partir de solicitações em linguagem natural](lake-query-generator.md)
+ [Veja exemplos de consultas com o console CloudTrail](lake-console-queries.md)
+ [Crie ou edite uma consulta com o CloudTrail console](query-create-edit-query.md)
+ [Executar uma consulta e salvar os resultados de consulta com o console](query-run-query.md)
+ [Visualizar resultados da consulta com o console](query-results.md)
+ [Resumir os resultados da consulta em linguagem natural](query-results-summary.md)
+ [Baixar resultados de consulta salva](view-download-cloudtrail-lake-query-results.md)
+ [Validar os resultados da consulta salva pelo CloudTrail Lake](cloudtrail-query-results-validation.md)
+ [Otimize as consultas CloudTrail do Lake](lake-queries-optimization.md)
+ [Execute e gerencie consultas do CloudTrail Lake com o AWS CLI](lake-queries-cli.md)

## Ferramentas do editor de consultas
<a name="query-editor-format-controls"></a>

Uma barra de ferramentas no canto superior direito do editor de consultas oferece comandos para ajudar a criar e formatar sua consulta de SQL.

![Barra de ferramentas do editor de consultas](http://docs.aws.amazon.com/pt_br/awscloudtrail/latest/userguide/images/query-editor-toolbar.png)


As seções a seguir descreve os comandos da barra de ferramentas.
+ **Undo** (Desfazer): reverte a última alteração de conteúdo feita no editor de consultas.
+ **Redo** (Refazer): repete a última alteração de conteúdo feita no editor de consultas.
+ **Format selected** (Formatar seleção): organiza o conteúdo do editor de consultas de acordo com as convenções de formatação e espaçamento de SQL.
+ **Comentar/descomentar seleção**: comenta a parte selecionada da consulta, caso ela ainda não tenha sido comentada. Se a parte selecionada já estiver comentada, escolher essa opção removerá o comentário.