Note
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.
Pour voir les dĂ©tails des options disponibles pour cette commande dans une version antĂ©rieure, exĂ©cutez la commande avec lâoption --help
dans votre terminal.
Synopsis
codeql dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...
codeql dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...
Description
[Plomberie] Importe un ensemble de fichiers TRAP dans un jeu de données brut.
CrĂ©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.
Options
Options principales
<dataset>
[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Ă .
<trap>...
Chemins 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Ă©Ă©.
-S, --dbscheme=<file>
[Obligatoire] Définition du schéma de base de données qui décrit les fichiers TRAP à importer.
-j, --threads=<num>
Utilise le nombre de threads spĂ©cifiĂ© pour lâopĂ©ration dâimportation.
La 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Ă©).
--[no-]check-undefined-labels
[Avancé] Signale les erreurs pour les étiquettes non définies.
--[no-]check-unused-labels
[Avancé] Signale les erreurs pour les étiquettes non utilisées.
--[no-]check-repeated-labels
[Avancé] Signale les erreurs pour les étiquettes répétées.
--[no-]check-redefined-labels
[Avancé] Signale les erreurs pour les étiquettes redéfinies.
--[no-]check-use-before-definition
[Avancé] Signale les erreurs pour les étiquettes utilisées avant leur définition.
--[no-]fail-on-trap-errors
[AvancĂ©] Sort une valeur non nulle si une erreur se produit lors de lâimportation dâun fichier TRAP.
--[no-]include-location-in-star
[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.
--[no-]linkage-aware-import
[AvancĂ©] ContrĂŽle si lâimportation de 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 les aider Ă progresser au dĂ©triment de la complĂ©tion de la base de donnĂ©es.
Disponible depuis v2.15.3
.
Options courantes
-h, --help
Affiche ce texte dâaide.
-J=<opt>
[AvancĂ©] Donne une option Ă lâenvironnement JVM exĂ©cutant la commande.
(Attention, les options contenant des espaces ne sont pas gérées correctement.)
-v, --verbose
Augmente de façon incrémentielle le nombre de messages de progression affichés.
-q, --quiet
Diminue de façon incrémentielle le nombre de messages de progression affichés.
--verbosity=<level>
[Avancé] Définit explicitement le niveau de détail sur errors, warnings, progress, progress+, progress++ ou progress+++. Remplace -v
et -q
.
--logdir=<dir>
[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.
(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.)
--common-caches=<dir>
[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Ă©Ă©.
Disponible depuis v2.15.2
.