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.
Para ver os detalhes das opções disponíveis para esse comando em uma versão anterior, execute o comando com a opção --help
no terminal.
Sinopse
codeql bqrs decode [--output=<file>] [--result-set=<name>] [--sort-key=<col>[,<col>...]] <options>... -- <file>
codeql bqrs decode [--output=<file>] [--result-set=<name>] [--sort-key=<col>[,<col>...]] <options>... -- <file>
Descrição
Converta os dados de resultado do BQRS em outros formatos.
A saída decodificada será gravada na saída padrão, a menos que a opção --output
seja especificada.
Opções
Opções principais
<file>
[Obrigatório] Arquivo BQRS a ser decodificado.
-o, --output=<file>
O arquivo no qual a saída desejada será gravada.
-r, --result-set=<name>
Selecione um conjunto de resultados específico no arquivo BQRS para decodificação. Os conjuntos de resultados disponíveis podem ser listados por codeql bqrs info.
Se nenhum conjunto de resultados for selecionado, todos os conjuntos de resultados serão decodificados, desde que o formato de saída selecionado e as opções de processamento deem suporte a isso. Caso contrário, ocorrerá um erro.
-k, --sort-key=<col>[,<col>...]
Classifique o conjunto de resultados selecionado pelas colunas indicadas.
--sort-direction=<direction>[,<direction>...]
Classifique o conjunto de resultados selecionado usando as instruções de classificação indicadas.
Se as instruções de classificação não forem especificadas, a ordem ascendente será usada para todas as colunas.
Opções de formato de saída
--format=<fmt>
Selecione o formato de saída. As opções incluem:
text
(padrão) : uma tabela de texto sem formatação legível por humanos.
csv
: valores separados por vírgula.
json
: streaming de JSON.
bqrs
: BQRS. Isso precisa ser usado com --output
. Mais útil com --sort-key
.
--no-titles
Omitir os títulos de colunas para formatos text
e csv
--entities=<fmt>[,<fmt>...]
[Avançado] Controle como as colunas de resultados do tipo de entidade são mostradas. Uma lista separada por vírgula das seguintes opções:
url
: uma URL referente a um local de origem, caso a consulta tenha sido compilada para produzir essas URLs para tipos de entidades.
string
: uma cadeia de caracteres computada pelo método toString() em QL, caso a consulta tenha sido compilada para produzir essas cadeias de caracteres para a coluna.
id
: a ID interna da entidade, que pode não ser informativa.
all
: mostre as colunas com todas as informações fornecidas pelo arquivo BQRS.
Todas as opções selecionadas são mostradas, se possível.
Opções de paginação (para uso dos front-ends interativos)
--rows=<num>
[Avançado] Gere esse número de linhas com base no conjunto de resultados selecionado, começando no início ou no local fornecido por --start-at
.
--start-at=<offset>
[Avançado] Comece imprimindo a linha definida em um deslocamento de bytes específico no arquivo BQRS. O deslocamento precisa ser obtido de codeql bqrs info ou do ponteiro "next" encontrado na saída JSON de uma invocação anterior com --rows
definido. É provável que outros deslocamentos produzam saídas sem sentido e/ou erros explícitos.
Sempre precisa ser usado com --rows
e é incompatível com --sort-key
.
Opções comuns
-h, --help
Mostre este texto de ajuda.
-J=<opt>
[Avançado] Forneça a opção para a JVM que executa o comando.
(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)
-v, --verbose
Aumente incrementalmente o número de mensagens de progresso impressas.
-q, --quiet
Diminua incrementalmente o número de mensagens de progresso impressas.
--verbosity=<level>
[Avançado] Defina explicitamente o nível de detalhamento como erros, avisos, progresso, progresso+, progresso++ ou progresso+++. Substitui -v
e -q
.
--logdir=<dir>
[Avançado] Escreva logs detalhados em um ou mais arquivos no diretório fornecido, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.
(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.)
--common-caches=<dir>
[Avançado] Controle a localização dos dados armazenados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilada. 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.
Disponível desde v2.15.2
.