{"meta":{"title":"diagnostics d'exportation de base de données","intro":"[Expérimental] Exporte les informations de diagnostic d’une base de données pour une analyse ayant échoué.","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-export-diagnostics","title":"diagnostics d'exportation de base de données"}],"documentType":"article"},"body":"# diagnostics d'exportation de base de données\n\n\\[Expérimental] Exporte les informations de diagnostic d’une base de données pour une analyse ayant échoué.\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 export-diagnostics --format=<format> [--output=<output>] <options>... -- <database>\n```\n\n## Descriptif\n\n```\n          \\[Expérimental] Exporte les informations de diagnostic d’une base de données pour une analyse ayant échoué.\n```\n\nDisponible depuis `v2.12.6`.\n\n## Options\n\n### Options principales\n\n#### `<database>`\n\n```\n          \\[Obligatoire] Chemin de la base de données CodeQL en cours de construction. Doit avoir été préparé pour l’extraction avec [codeql database init](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-init).\n```\n\nSi l’option `--db-cluster` est donnée, il ne s’agit pas de la base de données elle-même, mais d’un répertoire qui *contient* des bases de données, et toutes ces bases de données sont traitées ensemble.\n\n#### `--format=<format>`\n\n```\n          \\[Obligatoire] Format dans lequel écrire les résultats. L'un des:\n\n          `raw` : liste de messages de diagnostic bruts non interprétés sous forme d’objets JSON.\n\n          `sarif-latest` : Format SARIF (Static Analysis Results Interchange Format), basé sur JSON pour décrire les résultats d’analyse statique. Cette option de format utilise la version prise en charge la plus récente (v2.1.0). Cette option ne convient pas dans le cadre d’une automatisation, car elle produit différentes versions de format SARIF entre les différentes versions de CodeQL.\n\n          `sarifv2.1.0` : SARIF v2.1.0.\n\n          `text` : liste à puces des messages de diagnostic.\n```\n\n#### `--[no-]db-cluster`\n\nIndique que le répertoire donné sur la ligne de commande n’est pas la base de données elle-même, mais un répertoire qui *contient* une ou plusieurs bases de données en cours de construction. Ces bases de données sont traitées ensemble.\n\n#### `-o, --output=<output>`\n\nChemin de sortie dans lequel écrire des informations de diagnostic.\n\n#### `--sarif-exit-code=<sarifExitCode>`\n\n```\n          \\[Formats SARIF uniquement] Code de sortie du processus défaillant.\n```\n\n#### `--sarif-exit-code-description=<sarifExitCodeDescription>`\n\n```\n          \\[Format SARIF uniquement] Raison de la fermeture du processus défaillant.\n```\n\n#### `--sarif-category=<category>`\n\n```\n          \\[Formats SARIF uniquement] \\[Recommandé] Spécifie une catégorie pour cette analyse à inclure dans la sortie SARIF. Une catégorie peut être utilisée pour distinguer plusieurs analyses effectuées sur le même commit et le même dépôt, mais dans différents langages ou différentes parties du code.\n```\n\nSi vous analysez la même version d’une base de code de différentes manières (par exemple, pour différents langages) et que vous chargez les résultats sur GitHub pour les présenter dans l’Analyse du code, cette valeur doit différer entre chacune des analyses pour indiquer à l’Analyse du code que les analyses *se complètent* plutôt qu’elles ne *se remplacent*. (Les valeurs doivent être cohérentes entre les exécutions de la même analyse pour *différentes* versions de la base de code.)\n\nCette valeur s’affiche (avec une barre oblique de fin qui doit être ajoutée si elle n’est pas déjà présente) en tant que propriété `<run>.automationDetails.id`.\n\n### Options courantes\n\n#### `-h, --help`\n\nAffiche ce texte d’aide.\n\n#### `-J=<opt>`\n\n```\n          \\[Avancé] Donne une option à l’environnement JVM exécutant la commande.\n```\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```\n          \\[Avancé] Définit explicitement le niveau de détail sur errors, warnings, progress, progress+, progress++ ou progress+++. Remplace `-v` et `-q`.\n```\n\n#### `--logdir=<dir>`\n\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\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```\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```\n\nDisponible depuis `v2.15.2`."}