# generar superposición-cambios

\[Asociaciones] Generar un archivo que se pueda usar para el

> \[!NOTE]
> En este contenido se describe la versión más reciente de CodeQL CLI. Para obtener más información sobre esta versión, consulta <https://github.com/github/codeql-cli-binaries/releases>.
>
> Para ver detalles de las opciones disponibles para este comando en una versión anterior, ejecuta el comando con la opción <span style="white-space: nowrap;">`--help`</span> en el terminal.

## Sinopsis

```shell copy
codeql generate overlay-changes [--source-root=<dir>] [--output=<file>] <options>... -- <database>
```

## Description

```
          \[Asociaciones] Genera un archivo que se puede usar para la opción `--overlay-changes` para [codeql database create](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-create) al extraer una base de datos superpuesta.
```

Este comando está pensado para usarse principalmente para pruebas manuales o automatizadas. No es especialmente eficaz. Para su uso en producción, considera si el archivo de cambios se puede derivar de algo como `git diff --name-only`.

## Options

### Opciones principales

#### `<database>`

```
          \[Obligatorio] Ruta de acceso a la base de datos _base_ en la que se extraerá la superposición.
```

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

Directorio que contiene el código fuente que se va a extraer como una superposición.
Si no se proporciona, se usa el directorio de trabajo actual.

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

El archivo de cambios se escribirá en esta ubicación. Si no se especifica, los cambios se escribirán en la salida estándar.

### Opciones comunes

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

Muestra este texto de ayuda.

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

```
          \[Avanzado] Asigna la opción a la JVM que ejecuta el comando.
```

(Ten en cuenta que las opciones que contienen espacios no se administrarán correctamente).

#### `-v, --verbose`

Aumenta incrementalmente el número de mensajes de progreso impresos.

#### `-q, --quiet`

Reduce incrementalmente el número de mensajes de progreso impresos.

#### `--verbosity=<level>`

```
          \[Avanzado] Establece explícitamente el nivel de detalle en errores, advertencias, progreso, progreso+, progreso++, progreso+++. Invalida `-v` y `-q`.
```

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

```
          \[Avanzado] Escribe registros detallados en uno o varios archivos del directorio especificado, con nombres generados que incluyen marcas de tiempo y el nombre del subcomando en ejecución.
```

(Para escribir un archivo de registro con un nombre sobre el que tienes control total, proporciona `--log-to-stderr` y redirige stderr como quieras).

#### `--common-caches=<dir>`

```
          \[Avanzado] Controla la ubicación de los datos en caché del disco que se conservarán entre varias ejecuciones de la CLI, como paquetes QL descargados y planes de consulta compilada. Si no se define explícitamente, se toma como predeterminado un directorio denominado `.codeql` en el directorio principal del usuario, que se creará en caso de que no exista.
```

Disponible desde la versión `v2.15.2`.