# desagrupación de base de datos

Extrae un archivo de base de datos CodeQL.

> \[!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 database unbundle <options>... -- <archive>
```

## Description

Extrae un archivo de base de datos CodeQL.

Este comando extrae un archivo de base de datos CodeQL creado por el [conjunto de bases de datos codeql](/es/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-bundle). Es similar al uso de descomprimir para extraer la base de datos, pero funciona mejor en determinados escenarios (por ejemplo, descomprimir es muy lento en Windows) y admite opciones adicionales, como configurar el nombre de la base de datos extraída.

## Options

### Opciones principales

#### `<archive>`

```
          \[Obligatorio] Ruta de acceso al archivo de base de datos CodeQL para descomprimir.
```

#### `--name=<name>`

Nombre que se va a asignar a la base de datos CodeQL creada. Si no se proporciona, coincidirá con el nombre que tenga la base de datos en el archivo.

#### `--target=<target>`

Directorio en el que se va a descomprimir la base de datos CodeQL. Si no se proporciona, este valor predeterminado será el directorio de trabajo actual.

### 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`.