{"meta":{"title":"importation de jeu de données","intro":"[Plomberie] Importe un ensemble de fichiers TRAP dans un jeu de données brut.","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/dataset-import","title":"importation de jeu de données"}],"documentType":"article"},"body":"# importation de jeu de données\n\n[Plomberie] Importe un ensemble de fichiers TRAP dans un jeu de données brut.\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 dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...\n```\n\n## Descriptif\n\n              \\[Plomberie] Importe un ensemble de fichiers TRAP dans un jeu de données brut.\n\nCréez un jeu de données en le remplissant avec des fichiers TRAP ou ajoutez des données à partir de fichiers TRAP à un jeu de données existant. La mise à jour d’un jeu de données n’est possible que s’il a le schéma de base de données correct _et_ que son pool d’ID a été conservé depuis l’importation initiale.\n\n## Options\n\n### Options principales\n\n#### `<dataset>`\n\n              \\[Obligatoire] Chemin du jeu de données QL brut à créer ou à mettre à jour. Le répertoire est créé s’il n’existe pas déjà.\n\n#### `<trap>...`\n\nChemins des fichiers .trap(.gz) à importer ou des répertoires où sont recherchés les fichiers .trap(.gz) au moyen d’une analyse récursive. Si aucun fichier n’est fourni, un jeu de données vide est créé.\n\n#### `-S, --dbscheme=<file>`\n\n              \\[Obligatoire] Définition du schéma de base de données qui décrit les fichiers TRAP à importer.\n\n#### `-j, --threads=<num>`\n\nUtilise le nombre de threads spécifié pour l’opération d’importation.\n\nLa valeur par défaut est de 1. Vous pouvez passer 0 pour utiliser un thread par cœur sur la machine ou -_N_ pour laisser _N_ cœurs inutilisés (sauf si au moins un thread est toujours utilisé).\n\n#### `--[no-]check-undefined-labels`\n\n              \\[Avancé] Signale les erreurs pour les étiquettes non définies.\n\n#### `--[no-]check-unused-labels`\n\n              \\[Avancé] Signale les erreurs pour les étiquettes non utilisées.\n\n#### `--[no-]check-repeated-labels`\n\n              \\[Avancé] Signale les erreurs pour les étiquettes répétées.\n\n#### `--[no-]check-redefined-labels`\n\n              \\[Avancé] Signale les erreurs pour les étiquettes redéfinies.\n\n#### `--[no-]check-use-before-definition`\n\n              \\[Avancé] Signale les erreurs pour les étiquettes utilisées avant leur définition.\n\n#### `--[no-]fail-on-trap-errors`\n\n              \\[Avancé] Sort une valeur non nulle si une erreur se produit lors de l’importation d’un fichier TRAP.\n\n#### `--[no-]include-location-in-star`\n\n              \\[Avancé] Construit des ID d’entité qui encodent l’emplacement dans le fichier TRAP dont ils proviennent. Peut être utile pour le débogage des générateurs TRAP, mais prend beaucoup d’espace dans le jeu de données.\n\n#### `--[no-]linkage-aware-import`\n\n              \\[Avancé] Contrôle si l’importation du jeu de données codeql prend en compte les liaisons _(par défaut)_ ou non. Sur les projets dans lesquels cette partie de la création de base de données consomme trop de mémoire, la désactivation de cette option peut contribuer à progresser au détriment de l’exhaustivité de la base de données.\n\nDisponible depuis `v2.15.3`.\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 est créé.\n\nDisponible depuis `v2.15.2`."}