{"meta":{"title":"exportación de diagnóstico de base de datos","intro":"[Experimental] Exporta la información de diagnóstico de una base de datos para un análisis con errores.","product":"Seguridad y calidad del código","breadcrumbs":[{"href":"/es/code-security","title":"Seguridad y calidad del código"},{"href":"/es/code-security/reference","title":"Referencia"},{"href":"/es/code-security/reference/code-scanning","title":"Análisis de código"},{"href":"/es/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/es/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manual de la CLI de CodeQL"},{"href":"/es/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-export-diagnostics","title":"exportación de diagnóstico de base de datos"}],"documentType":"article"},"body":"# exportación de diagnóstico de base de datos\n\n\\[Experimental] Exporta la información de diagnóstico de una base de datos para un análisis con errores.\n\n> \\[!NOTE]\n> 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>.\n>\n> 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.\n\n## Sinopsis\n\n```shell copy\ncodeql database export-diagnostics --format=<format> [--output=<output>] <options>... -- <database>\n```\n\n## Description\n\n```\n          \\[Experimental] Exporta la información de diagnóstico de una base de datos para un análisis con errores.\n```\n\nDisponible desde la versión `v2.12.6`.\n\n## Options\n\n### Opciones principales\n\n#### `<database>`\n\n```\n          \\[Obligatorio] Ruta de acceso a la base de datos CodeQL en construcción. Debe haberse preparado para la extracción con [codeql database init](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-init).\n```\n\nSi se proporciona la opción `--db-cluster`, no es una base de datos propiamente dicha, sino un directorio que *contiene* bases de datos y todas esas bases de datos se procesarán juntas.\n\n#### `--format=<format>`\n\n```\n          \\[Obligatorio] Formato en el que se van a escribir los resultados. Uno de los valores siguientes:\n\n          `raw`: lista de mensajes de diagnóstico sin procesar y no interpretados como objetos JSON.\n\n          `sarif-latest`: formato de intercambio de resultados de análisis estático (SARIF), un formato basado en JSON para describir los resultados del análisis estático. Esta opción de formato usa la versión admitida más reciente (v2.1.0). Esta opción no es adecuada para su uso en la automatización, ya que generará diferentes versiones de SARIF entre diferentes versiones de CodeQL.\n\n          `sarifv2.1.0`: SARIF v2.1.0.\n\n          `text`: lista de viñetas de mensajes de diagnóstico.\n```\n\n#### `--[no-]db-cluster`\n\nIndica que el directorio especificado en la línea de comandos no es una base de datos propiamente dicha, sino un directorio que *contiene* una o varias bases de datos en construcción. Esas bases de datos se procesarán juntas.\n\n#### `-o, --output=<output>`\n\nRuta de acceso de salida en la que se va a escribir información de diagnóstico.\n\n#### `--sarif-exit-code=<sarifExitCode>`\n\n```\n          \\[Solo formatos SARIF] Código de salida del proceso con errores.\n```\n\n#### `--sarif-exit-code-description=<sarifExitCodeDescription>`\n\n```\n          \\[Solo formatos SARIF] Motivo por el que se ha cerrado el proceso con errores.\n```\n\n#### `--sarif-category=<category>`\n\n```\n          \\[Solo formatos SARIF] \\[Recomendado] Especifica una categoría para este análisis para incluirlo en la salida de SARIF. Puede usarse una categoría para distinguir análisis múltiples realizados en la misma confirmación y repositorio, pero en lenguajes diferentes o en partes diferentes del código.\n```\n\nSi analizas la misma versión de una base de código de varias maneras diferentes (por ejemplo, para distintos lenguajes) y cargas los resultados en GitHub para su presentación en el análisis de código, este valor debe variar entre cada uno de los análisis, lo que indica al análisis de código que los análisis se *complementan* en lugar de *sustituirse* entre sí. (Los valores deben ser coherentes entre ejecuciones del mismo análisis para *diferentes* versiones del código base).\n\nEste valor aparecerá (con una barra diagonal final anexada si aún no está presente) como la propiedad `<run>.automationDetails.id`.\n\n### Opciones comunes\n\n#### `-h, --help`\n\nMuestra este texto de ayuda.\n\n#### `-J=<opt>`\n\n```\n          \\[Avanzado] Asigna la opción a la JVM que ejecuta el comando.\n```\n\n(Ten en cuenta que las opciones que contienen espacios no se administrarán correctamente).\n\n#### `-v, --verbose`\n\nAumenta incrementalmente el número de mensajes de progreso impresos.\n\n#### `-q, --quiet`\n\nReduce incrementalmente el número de mensajes de progreso impresos.\n\n#### `--verbosity=<level>`\n\n```\n          \\[Avanzado] Establece explícitamente el nivel de detalle en errores, advertencias, progreso, progreso+, progreso++, progreso+++. Invalida `-v` y `-q`.\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[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.\n```\n\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).\n\n#### `--common-caches=<dir>`\n\n```\n          \\[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.\n```\n\nDisponible desde la versión `v2.15.2`."}