Criar uma consulta personalizada

Você pode trabalhar em um modelo para escrever seu próprio código para criar uma consulta personalizada para analisar uma linguagem específica.

Neste artigo

Sobre consultas personalizadas

Note

A criação de uma consulta personalizada é opcional, e o repositório github/codeql contém um grande número de consultas de exemplo que você pode usar.

Você cria um novo arquivo de consulta de um modelo para uma determinada linguagem, que importa as bibliotecas padrão para analisar essa linguagem. Para saber mais, confira Sobre as consultas do CodeQL na documentação do CodeQL.

Criar uma consulta personalizada

  1. Na barra lateral da extensão, abra o modo de exibição "Consultas" e clique no ícone de Criar consulta.

  2. No VS Code Command Palette, selecione a linguagem de destino para sua consulta.. Se você optou por não criar sua consulta personalizada em um diretório existente, selecionar uma linguagem vai gerar automaticamente um diretório rotulado codeql-custom-queries-LANGUAGE, em que LANGUAGE é o nome da linguagem selecionada. Um modelo de consulta rotulado example.ql será adicionado ao diretório existente ou gerado automaticamente.

  3. No modelo, escreva sua consulta personalizada e salve o arquivo. Quando a consulta estiver concluída, você poderá executá-la no modo de exibição "Consultas".

Leitura adicional

Você pode ler sobre como criar consultas para linguagens compatíveis na documentação do CodeQL: