# gerar alterações de sobreposição

\[Canalização] Gerar um arquivo que pode ser usado para o

> \[!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 generate overlay-changes [--source-root=<dir>] [--output=<file>] <options>... -- <database>
```

## Description

```
          \[Canalização] Gerar um arquivo que possa ser usado para a opção `--overlay-changes` para a [criação de banco de dados codeql](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-create) ao extrair um banco de dados de sobreposição.
```

Esse comando se destina a ser usado principalmente para testes manuais ou automatizados. Não é particularmente eficiente. Para uso em produção, considere se o arquivo de alterações pode ser derivado de algo como `git diff --name-only`.

## Opções

### Opções principais

#### `<database>`

```
          \[Obrigatório] Caminho para o banco de dados de _base_ para o qual a sobreposição será extraída.
```

#### `-s, --source-root=<dir>`

O diretório que contém o código-fonte a ser extraído como uma sobreposição.
Se não for fornecido, o diretório de trabalho atual será usado.

#### `-o, --output=<file>`

O arquivo de alterações será gravado neste local. Se não for especificado, as alterações serão gravadas na saída padrão.

### 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 de forma incremental 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`.