# limpeza do banco de dados

Compacte um banco de dados CodeQL em disco.

> [!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 database cleanup <options>... -- <database>
```

## Description

Compacte um banco de dados CodeQL em disco.

Exclui os dados temporários e, geralmente, torna um banco de dados o menor possível no disco sem degradar a utilidade futura dele.

## Opções

### Opções principais

#### `<database>`

              \[Obrigatório] Caminho para o banco de dados CodeQL a ser limpo.

### Opções de limpeza de conjunto de dados de baixo nível

#### `--max-disk-cache=<MB>`

Defina a quantidade máxima de espaço que pode ser usada pelo cache de disco para os resultados intermediários da consulta.

Se esse tamanho não for configurado explicitamente, o avaliador tentará usar uma quantidade "razoável" de espaço em cache, com base no tamanho do conjunto de dados e na complexidade das consultas. Se você definir explicitamente um limite mais alto do que esse uso padrão, isso habilitará o cache adicional, que pode acelerar as consultas posteriores.

#### `--min-disk-free=<MB>`

              \[Avançado] Defina a quantidade de destino de espaço livre no sistema de arquivos.

Se `--max-disk-cache` não for fornecido, o avaliador tentará reduzir o uso do cache de disco se o espaço livre no sistema de arquivos ficar abaixo desse valor.

#### `--min-disk-free-pct=<pct>`

              \[Avançado] Defina a fração de destino de espaço livre no sistema de arquivos.

Se `--max-disk-cache` não for fornecido, o avaliador tentará reduzir o uso do cache de disco se o espaço livre no sistema de arquivos ficar abaixo desse percentual.

#### `--cache-cleanup=<mode>`

Selecione o nível de agressividade de corte do cache. As opções incluem:

              `clear`: remova todo o cache, reduzindo-o ao estado de um conjunto de dados recém-extraído

              `trim`
              _(padrão)_ : corte tudo, exceto os predicados explicitamente "armazenados em cache".

              `fit`: verifique se os limites de tamanho definidos para o cache de disco são observados, excluindo quantos intermediários forem necessários.

              `overlay`: corte apenas os dados que serão úteis ao avaliar uma sobreposição.

#### `--cleanup-upgrade-backups`

Exclua todos os diretórios de backup resultantes das atualizações de banco de dados.

### Opções comuns

#### `-h, --help`

Mostre este texto de ajuda.

#### `-J=<opt>`

              \[Avançado] Dê opções à 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 para um dos seguintes: erros, avisos, progresso, progresso+, progresso++, progresso+++. Substitui `-v` e `-q`.

#### `--logdir=<dir>`

              \[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.

(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] 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.

Disponível desde `v2.15.2`.