{"meta":{"title":"générer des modifications de superposition","intro":"[Plomberie] Générez un fichier pouvant être utilisé avec","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/generate-overlay-changes","title":"générer des modifications de superposition"}],"documentType":"article"},"body":"# générer des modifications de superposition\n\n\\[Plomberie] Générez un fichier pouvant être utilisé avec\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 generate overlay-changes [--source-root=<dir>] [--output=<file>] <options>... -- <database>\n```\n\n## Descriptif\n\n```\n          \\[Plomberie] Générez un fichier pouvant être utilisé avec l’option `--overlay-changes` pour [codeql database create](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-create) lors de l’extraction d’une base de données en superposition.\n```\n\nCette commande est principalement destinée aux tests manuels ou automatisés. Elle n’est pas particulièrement efficace. Pour une utilisation en production, envisagez de dériver le fichier de modifications à partir d’un élément tel que `git diff --name-only`.\n\n## Options\n\n### Options principales\n\n#### `<database>`\n\n```\n          \\[Obligatoire] Chemin d’accès vers la base de données _de base_ dans laquelle la superposition sera extraite.\n```\n\n#### `-s, --source-root=<dir>`\n\nRépertoire contenant le code source à extraire comme superposition.\nSi aucun chemin n’est indiqué, le répertoire de travail en cours sera utilisé.\n\n#### `-o, --output=<file>`\n\nLe fichier de modifications sera écrit à cet emplacement. Si ce n’est pas spécifié, les modifications seront écrites dans la sortie standard.\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 est créé.\n```\n\nDisponible depuis `v2.15.2`."}