{"meta":{"title":"adición de diagnóstico de base de datos","intro":"[Experimental] Agrega un fragmento de información de diagnóstico a una base de datos.","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-add-diagnostic","title":"adición de diagnóstico de base de datos"}],"documentType":"article"},"body":"# adición de diagnóstico de base de datos\n\n[Experimental] Agrega un fragmento de información de diagnóstico a una base de datos.\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 add-diagnostic --source-id=<id> --source-name=<name> <options>... -- <database>\n```\n\n## Description\n\n              \\[Experimental] Agrega un fragmento de información de diagnóstico a una base de datos.\n\nDisponible desde la versión `v2.12.6`.\n\n## Options\n\n### Opciones principales\n\n#### `<database>`\n\n              \\[Obligatorio] Ruta de acceso a la base de datos CodeQL que se va a agrupar.\n\n#### `--markdown-message=<markdownMessage>`\n\nMensaje para el diagnóstico, en formato Markdown con estilo GitHub.\n\n#### `--plaintext-message=<plaintextMessage>`\n\nMensaje para el diagnóstico, en texto sin formato. Esta opción solo debe utilizarse cuando rellenar un mensaje Markdown con --markdown-message no resulte práctico.\n\n#### `--severity=<severity>`\n\nGravedad del diagnóstico. Puede ser \"error\", \"advertencia\" o \"nota\".\n\n#### `--help-link=<helpLinks>`\n\nVínculos de ayuda pertinentes para el diagnóstico.\n\n#### `--attributes-json=<attributesJson>`\n\nMetadatos estructurados pertinentes para el diagnóstico.\n\n### Opciones que indican dónde se puede mostrar el mensaje de diagnóstico\n\n#### `--ready-for-status-page`\n\nIndica que el diagnóstico es adecuado para mostrarse en la página de estado.\n\n#### `--ready-for-cli-summary-table`\n\nIndica que el diagnóstico es adecuado para mostrarse en la tabla de resumen de diagnóstico impresa por comandos como `database analyze`.\n\n### Opciones que describen el origen del diagnóstico\n\n#### `--source-id=<id>`\n\n              \\[Obligatorio] Identificador del origen de este diagnóstico.\n\n#### `--source-name=<name>`\n\n              \\[Obligatorio] Una descripción legible del origen de este diagnóstico.\n\n#### `--extractor-name=<extractorName>`\n\nNombre del extractor de CodeQL, si este diagnóstico lo generó un extractor de CodeQL.\n\n### Opciones que describen la ubicación del diagnóstico\n\n#### `--file-path=<file>`\n\nRuta de acceso del archivo al que se aplica el diagnóstico, en relación con la raíz de origen.\n\n#### `--start-line=<startLine>`\n\nNúmero de línea basado en 1 (incluido) donde se inicia la ubicación del diagnóstico.\n\n#### `--start-column=<startColumn>`\n\nNúmero de columna basado en 1 (incluido) donde se inicia la ubicación del diagnóstico.\n\n#### `--end-line=<endLine>`\n\nNúmero de línea basado en 1 (incluido) donde finaliza la ubicación del diagnóstico.\n\n#### `--end-column=<endColumn>`\n\nNúmero de columna basado en 1 (incluido) donde finaliza la ubicación del diagnóstico.\n\n### Opciones comunes\n\n#### `-h, --help`\n\nMuestra este texto de ayuda.\n\n#### `-J=<opt>`\n\n              \\[Avanzado] Asigna la opción a la JVM que ejecuta el comando.\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              \\[Avanzado] Establece explícitamente el nivel de detalle en errores, advertencias, progreso, progreso+, progreso++, progreso+++. Invalida `-v` y `-q`.\n\n#### `--logdir=<dir>`\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(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              \\[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\nDisponible desde la versión `v2.15.2`."}