{"meta":{"title":"formato de consulta","intro":"Formate automaticamente o código-fonte QL.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/reference","title":"Referência"},{"href":"/pt/code-security/reference/code-scanning","title":"Varredura de código"},{"href":"/pt/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manual da CLI do CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual/query-format","title":"formato de consulta"}],"documentType":"article"},"body":"# formato de consulta\n\nFormate automaticamente o código-fonte QL.\n\n> [!NOTE]\n> Este conteúdo descreve a versão mais recente do CodeQL CLI. Para obter mais informações sobre essa versão, confira https://github.com/github/codeql-cli-binaries/releases.\n>\n> Para ver os detalhes das opções disponíveis para esse comando em uma versão anterior, execute o comando com a opção <span style=\"white-space: nowrap;\">`--help`</span> no terminal.\n\n## Sinopse\n\n```shell copy\ncodeql query format [--output=<file>] [--in-place] [--backup=<ext>] <options>... -- <file>...\n```\n\n## Description\n\nFormate automaticamente o código-fonte QL.\n\n## Opções\n\n### Opções principais\n\n#### `<file>...`\n\nUm ou mais arquivos de origem `.ql` ou `.qll` para formatação automática. Um traço pode ser especificado para leitura por meio da entrada padrão.\n\n#### `-o, --output=<file>`\n\nEscreva o código QL formatado nesse arquivo em vez do fluxo de saída padrão. Não deve ser fornecido se houver mais de uma entrada.\n\n#### `-i, --[no-]in-place`\n\nSubstitua cada arquivo de entrada por uma versão formatada do respectivo conteúdo.\n\n#### `--[no-]check-only`\n\nEm vez de gravar a saída, sai com O status 1 se algum arquivo de entrada for _diferente_ da formatação correta. Uma mensagem informando os arquivos diferentes será impressa no erro padrão, a menos que você também forneça `-qq`.\n\n#### `-b, --backup=<ext>`\n\nAo gravar um arquivo que já existe, renomeie o arquivo existente para um backup acrescentando essa extensão ao nome. Se o arquivo de backup já existir, ele será excluído silenciosamente.\n\n#### `--no-syntax-errors`\n\nSe um arquivo de entrada não estiver sintaticamente correto com o QL, finja que ele já está formatado corretamente. (Normalmente, esse arquivo faz com que o comando seja encerrado com uma mensagem de erro).\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n              \\[Avançado] Dê opções à JVM que executa o comando.\n\n(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)\n\n#### `-v, --verbose`\n\nAumente incrementalmente o número de mensagens de progresso impressas.\n\n#### `-q, --quiet`\n\nDiminua incrementalmente o número de mensagens de progresso impressas.\n\n#### `--verbosity=<level>`\n\n              \\[Avançado] Defina explicitamente o nível de detalhamento para um dos seguintes: erros, avisos, progresso, progresso+, progresso++, progresso+++. Substitui `-v` e `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[Avançado] Grava registros detalhados em um ou mais arquivos no diretório especificado, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.\n\n(Para gravar um arquivo de log com um nome sobre o qual você tem controle completo, forneça `--log-to-stderr` e redirecione stderr conforme desejado.)\n\n#### `--common-caches=<dir>`\n\n              \\[Avançado] Controla a localização dos dados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilados. Se não for definido explicitamente, o padrão corresponde a um diretório intitulado `.codeql` no diretório inicial do usuário; que será criado se ainda não existir.\n\nDisponível desde `v2.15.2`."}