{"meta":{"title":"bundle de bases de données","intro":"Crée une archive relocalisable d’une base de données CodeQL.","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-bundle","title":"bundle de bases de données"}],"documentType":"article"},"body":"# bundle de bases de données\n\nCrée une archive relocalisable d’une base de données CodeQL.\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 bundle --output=<output> <options>... -- <database>\n```\n\n## Descriptif\n\nCrée une archive relocalisable d’une base de données CodeQL.\n\nCommande qui compresse les parties utiles de la base de données. Cela inclut uniquement les composants obligatoires, sauf si l’utilisateur demande spécifiquement que les résultats, journaux, TRAP ou similaires soient inclus.\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#### `-o, --output=<output>`\n\n              \\[Obligatoire] Fichier de sortie, généralement avec l’extension « .zip ».\n\n#### `--[no-]include-diagnostics`\n\nInclut des diagnostics dans le bundle.\n\nDisponible depuis `v2.16.0`.\n\n#### `--[no-]include-results`\n\nInclut tous les résultats de requête précalculés dans le bundle.\n\n#### `--[no-]include-logs`\n\nInclut le répertoire des journaux dans le bundle.\n\nDisponible depuis `v2.17.6`.\n\n#### `--[no-]include-temp`\n\nInclut le répertoire « temp », où se trouvent les packs, requêtes et suites générés.\n\nDisponible depuis `v2.13.3`.\n\n#### `--[no-]include-uncompressed-source`\n\nInclut une version non compressée du répertoire d’archive source. Nécessaire pour les plug-ins CodeQL hérités (comme CodeQL pour Eclipse).\n\n#### `--include=<include>`\n\n              \\[[Avancé] Chemins supplémentaires relatifs au répertoire de la base de données à inclure dans le bundle.\n\nDisponible depuis `v2.24.0`.\n\n#### `--name=<name>`\n\nNom du répertoire de niveau supérieur dans le bundle. S’il n’est pas spécifié, utilise par défaut le nom du répertoire de la base de données.\n\n### Options de nettoyage de jeu de données de bas niveau\n\n#### `--max-disk-cache=<MB>`\n\nDéfinit la quantité maximale d’espace que le cache de disque peut utiliser pour les résultats de requête intermédiaires.\n\nSi cette taille n’est pas configurée explicitement, l’évaluateur essaie d’utiliser une quantité « raisonnable » d’espace de cache en fonction de la taille du jeu de données et de la complexité des requêtes. La définition explicite d’une limite supérieure à cette utilisation par défaut permet une mise en cache supplémentaire qui peut accélérer les requêtes ultérieures.\n\n#### `--min-disk-free=<MB>`\n\n              \\[Avancé] Définit la quantité cible d’espace disponible sur le système de fichiers.\n\nSi `--max-disk-cache` n’est pas donné, l’évaluateur s’efforce de limiter l’utilisation du cache de disque si l’espace disponible sur le système de fichiers passe en dessous de cette valeur.\n\n#### `--min-disk-free-pct=<pct>`\n\n              \\[Avancé] Définit la fraction cible d’espace disponible sur le système de fichiers.\n\nSi `--max-disk-cache` n’est pas donné, l’évaluateur s’efforce de limiter l’utilisation du cache de disque si l’espace disponible sur le système de fichiers passe en dessous de ce pourcentage.\n\n#### `--cache-cleanup=<mode>`\n\nSélectionnez le degré de réduction du cache. Les options sont les suivantes :\n\n              `clear` : Supprime l’intégralité du cache en le réduisant à l’état d’un jeu de données qui vient d’être extrait\n\n              `trim`\n              _(par défaut)_  : Supprime tout, sauf les prédicats explicitement « mis en cache ».\n\n              `fit` : S’assure simplement que les limites de taille définies pour le cache de disque sont respectées, en supprimant autant d’intermédiaires que nécessaire.\n\n              `overlay` : Conserve uniquement les données qui seront utiles lors de l’évaluation par rapport à une superposition.\n\n#### `--cleanup-upgrade-backups`\n\nSupprime tous les répertoires de sauvegarde résultant des mises à niveau des bases de données.\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`."}