Histórico de consultas
funcionalPesquise no log de execução local, mantenha trechos fixados e envie qualquer instrução de volta para o editor.
Um navegador do log de execução local, dividido em Fixado e
Recente. Cada linha mostra uma prévia do SQL em uma linha (ou o nome do pin, se você colocou um) com o servidor, o banco de dados, quando rodou, se deu certo, quanto tempo levou, quantas vezes já rodou e as linhas afetadas. A caixa de busca aceita texto simples ou filtros estruturados - server:prod db:sales outcome:failed min:1s - mais
after:/before: datas, max:, e tag:.
- Abrir em nova aba envia o script completo de volta para o editor para revisão; Executar o reexecuta em um passo, uma exceção deliberada à pausa de revisão, já que é SQL que você já executou.
- Pins são consultas salvas - uma entrada fixada ganha editores em linha para nome, descrição e tag, sobrevive à limpeza por retenção e pode ser exportada e importada como JSON ou escrita na Biblioteca de SQL como
.sqlarquivos. - Analisar com IA entrega a entrada, ou as últimas cinco visíveis - para o painel de IA, e entradas que armazenaram SQL de reversão oferecem Copiar SQL de rollback.


O histórico fica em um arquivo local, como o resto da sua configuração do SQLly: é seu para guardar, pesquisar e fazer backup. A lista é paginada em blocos, e o rodapé conta o que a retenção já removeu.
Abrindo isso
Clique com o botão direito em qualquer banco de dados e escolha Ferramentas › Histórico de Consultas..., ou execute Histórico de consultas do paleta de comandos. De qualquer forma, você recebe o log inteiro de todas as conexões, do mais novo para o mais antigo, com a caixa de busca em foco para você começar a digitar na hora. Use ↑ e ↓ para navegar pela lista e, ou um clique duplo, para abrir a instrução selecionada em uma nova aba.
Encontrando a consulta do relatório que falhou na semana passada
- Tipo
db:reporting outcome:failed after:2026-09-28. Os filtros se combinam, então todos precisam corresponder. - Adicione uma palavra da consulta, como
invoice. Palavras comuns correspondem em qualquer lugar no SQL, servidor, banco de dados, tags, nome ou descrição. - Selecione a entrada e pressione Abrir em nova aba para corrigir, ou Fixar para mantê-lo por perto.
| Filtro | Correspondências |
|---|---|
server: (ou connection:) | Nome do servidor contendo o texto. |
db: (ou database:) | Nome do banco de dados contendo o texto. |
outcome: (ou status:) | succeeded, failed, ou cancelled. |
after: / before: | Roda a partir de / até uma data escrita YYYY-MM-DD. |
min: / max: | Limites de duração: 500ms, 1s, 2.5s, ou um número simples de milissegundos. |
tag: | Pins com uma tag contendo o texto. |
A correspondência de texto ignora maiúsculas e minúsculas. Um token com prefixo desconhecido é tratado como texto de pesquisa comum.
O que cada linha diz
Abaixo da pré-visualização, uma linha de metadados lista o servidor e o banco de dados, um tempo relativo (agora mesmo, há 5 min, há 3 h, há 2 dias, depois a data), o resultado, a duração, ×N quando a mesma instrução foi executada mais de uma vez, e linhas afetadas. Instruções provenientes da IA ou de uma ferramenta são marcadas ia ou ferramenta; uma entrada recente que também está fixada diz fixado; linhas fixadas mostram seu #tags e descrição.
Ações
| Botão | O que faz |
|---|---|
| Abrir em nova aba | Abre a instrução completa em uma nova aba de consulta e fecha o navegador. |
| Executar | Abre em uma nova aba e a executa imediatamente na ativo conexão - não necessariamente o servidor registrado na entrada. Parâmetros, verificações de segurança e revisão de mutação ainda se aplicam. |
| Fixar / Desafixar | Move a entrada para dentro ou fora da seção Fixada. |
| Analisar com IA | Envia o SQL da entrada, destino, tempo e resultado para o painel de IA como um prompt. |
| Analisar os últimos 5 visíveis com IA | O mesmo vale para as cinco primeiras linhas Recentes sob o filtro atual. |
| Copiar SQL de rollback | Copia a instrução de rollback guardada junto ao registro. Edições salvas na grade vêm com uma. |
| Exportar itens fixados… | Salva todos os pins em um arquivo JSON (query-pins.json por padrão). |
| Exportar itens fixados para a Biblioteca | Escreve cada pin como um .sql arquivo na pasta Pinned da Biblioteca SQL; nomes duplicados recebem um sufixo estilo (2), como sufixo. |
| Importar itens fixados… | Mescla pins de um arquivo JSON exportado, ignorando os que você já possui. |
Retenção
A limpeza é executada cada vez que o Histórico de Consultas é aberto. Duas configurações na seção Configurações › Editor › Histórico de consultas, no Navegador de histórico de execução a controlam: Reter execuções por dias (padrão 90; 0 mantém tudo) e Máximo de entradas de execução (padrão 10.000). As instruções fixadas são armazenadas separadamente e nunca são removidas pela retenção.