Sobre o teste de consultas em VS Code
Para garantir que suas CodeQL consultas produzam os resultados esperados, você pode executar testes que comparam os resultados de consulta esperados com os resultados reais.
A extensão CodeQL se registra automaticamente na visão "Testing". Esse modo de exibição mostra todos os testes encontrados em seu espaço de trabalho atual e fornece uma interface do usuário para explorar e executar testes em seu espaço de trabalho.
Para obter mais informações sobre como criar CodeQL testes, consulte Testar consultas personalizadas.
Para ver resultados mais detalhados da execução dos testes de unidade, abra o CodeQL registro dos testes. Para obter informações, consulte Acessando logs em CodeQL em Visual Studio Code.
Testar os resultados de suas consultas
-
In Visual Studio Code, abra a exibição "Teste" na barra lateral.
-
Para executar um teste específico, passe o mouse sobre o nome do arquivo ou pasta e clique no botão de reprodução. Para executar todos os testes em seu espaço de trabalho, clique no botão de reprodução na parte superior do modo de exibição. Se um teste demorar muito tempo para ser executado, você pode clicar no botão parar na parte superior do modo de exibição para cancelar o teste.
-
Os ícones mostram se um teste teve êxito ou falhou. Se falhar, clique no teste em "Resultados de Teste" para exibir as diferenças entre a saída esperada e a saída real.
-
Compare os resultados. Se você quiser atualizar o teste com a saída real, clique com o botão direito do mouse no teste no modo de exibição "Testes" e clique em Aceitar Saída de Teste.
Monitorar o desempenho das consultas
O desempenho da consulta é importante quando você deseja executar uma consulta em bancos de dados grandes ou como parte do seu sistema de integração contínua.
Se você quiser examinar o desempenho da consulta, habilite a configuração "Consultas em Execução: Depurar" para incluir contagens de tempo e tuplas. Em seguida, isso será mostrado nos logs na CodeQL guia "Servidor de Consultas" do painel "Saída". A contagem de tuplas é útil porque indica o tamanho dos predicados computados pela consulta. Para obter mais informações sobre configurações de alterações, confira Configurações personalizadas.
Quando uma consulta é avaliada, o servidor de consulta armazena em cache os predicados calculados. Portanto, quando você quiser comparar o desempenho de duas avaliações, deverá executar CodeQL: Limpar Cache para limpar o cache do servidor de consulta antes de cada execução. Isso garante que você esteja comparando dados equivalentes.
Para obter mais informações sobre como monitorar o desempenho de suas CodeQL consultas, consulte Solução de problemas de desempenho de consulta e avaliação de programas de QL na CodeQL documentação.