# bqrs decode

Converta os dados de resultado do BQRS em outros formatos.

> \[!NOTE]
> 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 <span style="white-space: nowrap;">`--help`</span> no terminal.

## Sinopse

```shell copy
codeql bqrs decode [--output=<file>] [--result-set=<name>] [--sort-key=<col>[,<col>...]] <options>... -- <file>
```

## Description

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](/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual/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.

          `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](/code-security/reference/code-scanning/codeql/codeql-cli-manual/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`.