{"meta":{"title":"diagnostic d'extension de base de données","intro":"[Expérimental] Ajoute des informations de diagnostic à une base de données.","product":"Sécurité et qualité du code","breadcrumbs":[{"href":"/fr/code-security","title":"Sécurité et qualité du code"},{"href":"/fr/code-security/reference","title":"Reference"},{"href":"/fr/code-security/reference/code-scanning","title":"Analyse du code"},{"href":"/fr/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/fr/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manuel de l’interface CLI CodeQL"},{"href":"/fr/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-add-diagnostic","title":"diagnostic d'extension de base de données"}],"documentType":"article"},"body":"# diagnostic d'extension de base de données\n\n[Expérimental] Ajoute des informations de diagnostic à une base de données.\n\n> [!NOTE]\n> Ce contenu décrit la version la plus récente de CodeQL CLI. Pour plus d’informations sur cette version, consultez https://github.com/github/codeql-cli-binaries/releases.\n>\n> Pour voir les détails des options disponibles pour cette commande dans une version antérieure, exécutez la commande avec l’option <span style=\"white-space: nowrap;\">`--help`</span> dans votre terminal.\n\n## Synopsis\n\n```shell copy\ncodeql database add-diagnostic --source-id=<id> --source-name=<name> <options>... -- <database>\n```\n\n## Descriptif\n\n              \\[Expérimental] Ajoute des informations de diagnostic à une base de données.\n\nDisponible depuis `v2.12.6`.\n\n## Options\n\n### Options principales\n\n#### `<database>`\n\n              \\[Obligatoire] Chemin vers la base de données CodeQL à mettre dans un bundle.\n\n#### `--markdown-message=<markdownMessage>`\n\nMessage pour le diagnostic, au format Markdown avec saveur GitHub.\n\n#### `--plaintext-message=<plaintextMessage>`\n\nMessage pour le diagnostic, en texte brut. Cette option ne doit être utilisée que si le remplissage d’un message Markdown avec --markdown-message n’est pas pratique.\n\n#### `--severity=<severity>`\n\nGravité du diagnostic. Peut être « error », « warning » ou « note ».\n\n#### `--help-link=<helpLinks>`\n\nLiens d’aide pertinents pour le diagnostic.\n\n#### `--attributes-json=<attributesJson>`\n\nMétadonnées structurées pertinentes pour le diagnostic.\n\n### Options indiquant où le message de diagnostic peut être affiché\n\n#### `--ready-for-status-page`\n\nIndique que le diagnostic peut être affiché sur la page d’état.\n\n#### `--ready-for-cli-summary-table`\n\nIndique que le diagnostic peut être affiché dans le tableau récapitulatif des diagnostics généré par des commandes telles que `database analyze`.\n\n### Options décrivant la source du diagnostic\n\n#### `--source-id=<id>`\n\n              \\[Obligatoire] Identificateur de la source de ce diagnostic.\n\n#### `--source-name=<name>`\n\n              \\[Obligatoire] Description explicite de la source de ce diagnostic.\n\n#### `--extractor-name=<extractorName>`\n\nNom de l’extracteur CodeQL, si ce diagnostic a été produit par un extracteur CodeQL.\n\n### Options décrivant l’emplacement du diagnostic\n\n#### `--file-path=<file>`\n\nChemin du fichier auquel le diagnostic s’applique, par rapport à la racine source.\n\n#### `--start-line=<startLine>`\n\nNuméro de ligne de base 1 (inclus) où commence l’emplacement du diagnostic.\n\n#### `--start-column=<startColumn>`\n\nNuméro de colonne de base 1 (inclus) où commence l’emplacement du diagnostic.\n\n#### `--end-line=<endLine>`\n\nNuméro de ligne de base 1 (inclus) où se termine l’emplacement du diagnostic.\n\n#### `--end-column=<endColumn>`\n\nNuméro de colonne de base 1 (inclus) où se termine l’emplacement du diagnostic.\n\n### Options courantes\n\n#### `-h, --help`\n\nAffiche ce texte d’aide.\n\n#### `-J=<opt>`\n\n              \\[Avancé] Donne une option à l’environnement JVM exécutant la commande.\n\n(Attention, les options contenant des espaces ne sont pas gérées correctement.)\n\n#### `-v, --verbose`\n\nAugmente de façon incrémentielle le nombre de messages de progression affichés.\n\n#### `-q, --quiet`\n\nDiminue de façon incrémentielle le nombre de messages de progression affichés.\n\n#### `--verbosity=<level>`\n\n              \\[Avancé] Définit explicitement le niveau de détail sur errors, warnings, progress, progress+, progress++ ou progress+++. Remplace `-v` et `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[Avancé] Écrit des journaux détaillés dans un ou plusieurs fichiers du répertoire donné, avec des noms générés qui incluent des horodatages et le nom de la sous-commande en cours d’exécution.\n\n(Pour écrire un fichier journal avec un nom sur lequel vous avez un contrôle total, donnez plutôt `--log-to-stderr` et redirigez stderr comme vous le souhaitez.)\n\n#### `--common-caches=<dir>`\n\n              \\[Avancé] Contrôle l’emplacement des données en cache sur le disque qui persisteront entre plusieurs exécutions de l’interface CLI, telles que les packs QL téléchargés et les plans de requête compilés. S’il n’est pas défini explicitement, il s’agit par défaut d’un répertoire nommé `.codeql` dans le répertoire de base de l’utilisateur. S’il n’existe pas déjà, il sera créé.\n\nDisponible depuis `v2.15.2`."}