{"meta":{"title":"résoudre le chemin d’accès à la bibliothèque","intro":"[Plomberie profonde] Détermine le chemin de la bibliothèque QL et le schéma de base de données pour une requête.","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/resolve-library-path","title":"résoudre le chemin d’accès à la bibliothèque"}],"documentType":"article"},"body":"# résoudre le chemin d’accès à la bibliothèque\n\n[Plomberie profonde] Détermine le chemin de la bibliothèque QL et le schéma de base de données pour une requête.\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 resolve library-path (--query=<qlfile> | --dir=<dir> | --root-pack=<pkgname>) <options>...\n```\n\n## Descriptif\n\n              \\[Plomberie profonde] Détermine le chemin de la bibliothèque QL et le schéma de base de données pour une requête.\n\nDétermine le chemin de la bibliothèque QL où une requête particulière doit être compilée. Ce calcul est implicite dans plusieurs sous-commandes qui peuvent avoir besoin de compiler des requêtes. Elle est exposée en tant que commande de plomberie distincte pour (a) aider à résoudre les problèmes et (b) fournir un point de départ pour modifier le chemin dans des cas extraordinaires où un contrôle précis est nécessaire.\n\nLa commande détecte également un langage et un schéma de base de données avec lesquels compiler une requête, car ceux-ci peuvent également dépendre de la détection automatique du langage d’une requête QL.\n\n              **La commande est profondément interne et son comportement ou son existence peut changer sans trop faire de bruit à mesure que l’écosystème du langage QL évolue.**\n\n## Options\n\n### Options principales\n\n#### `--[no-]find-extractors`\n\n              \\[Avancé] Inclut dans la sortie un résumé des champs `extractor` des packs QL dont dépend la requête. Utilisée uniquement pour quelques cas internes rares, elle peut demander plus de travail pour le calcul, donc elle n’est pas activée par défaut.\n\n#### `--format=<fmt>`\n\nSélectionne le format de sortie. Les options sont les suivantes :\n\n              `lines`\n              _(par défaut)_  : Affiche les arguments de ligne de commande sur une ligne chacun.\n\n              `json` : Affiche un objet JSON avec toutes les données.\n\n              `path` : Affiche juste le chemin de la bibliothèque calculée.\n\n              `dbscheme` : Affiche juste le schéma de base de données détecté.\n\n              `cache` : Affiche l’emplacement du cache de compilation par défaut, ou rien s’il n’y en a pas.\n\n### Options de la ligne de commande de la commande appelante\n\n#### `--search-path=<dir>[:<dir>...]`\n\nListe des répertoires sous lesquels les packs QL peuvent être trouvés. Chaque répertoire peut être un pack QL (ou un bundle de packs contenant un fichier `.codeqlmanifest.json` à la racine) ou le parent immédiat d’un ou plusieurs de ces répertoires.\n\nSi le chemin contient plusieurs répertoires, leur ordre définit la priorité entre eux : quand un nom de pack qui doit être résolu est mis en correspondance dans plusieurs arborescences de répertoires, celle donnée en premier gagne.\n\nLe pointage de ce chemin vers une extraction du dépôt CodeQL open source devrait fonctionner lors de l’interrogation d’un des langages qui y résident.\n\nSi vous avez extrait le dépôt CodeQL en tant que frère de la chaîne d’outils CodeQL décompressée, vous n’avez pas besoin de donner cette option ; ces répertoires frères sont toujours recherchés pour les packs QL qui ne peuvent pas être trouvés autrement. (Si cette valeur par défaut ne fonctionne pas, il est fortement recommandé de configurer `--search-path` une fois pour toutes dans un fichier de configuration par utilisateur).\n\n(Remarque : Sur Windows, le séparateur de chemin est `;`.)\n\n#### `--additional-packs=<dir>[:<dir>...]`\n\nSi cette liste de répertoires est donnée, des packs y sont recherchés avant ceux indiqués dans `--search-path`. L’ordre entre eux n’a pas d’importance ; il s’agit d’une erreur si un nom de pack est trouvé dans deux répertoires différents de cette liste.\n\nCette option est utile si vous développez temporairement une nouvelle version d’un pack qui apparaît aussi dans le chemin par défaut. En revanche, il n’est _pas recommandé_ de remplacer cette option dans un fichier de configuration ; certaines actions internes ajoutent cette option à la volée, remplaçant toute valeur configurée.\n\n(Remarque : Sur Windows, le séparateur de chemin est `;`.)\n\n#### `--library-path=<dir>[:<dir>...]`\n\n              \\[Avancé] Liste facultative des répertoires qui sont ajoutés au chemin de recherche d’importation brut pour les bibliothèques QL. Doit être utilisé seulement si vous utilisez des bibliothèques QL qui n’ont pas été empaquetées en tant que packs QL.\n\n(Remarque : Sur Windows, le séparateur de chemin est `;`.)\n\n#### `--dbscheme=<file>`\n\n              \\[Avancé] Définit explicitement les requêtes de schéma de base de données à compiler. Ne doit être donné que par les appelants qui sont extrêmement sûrs de ce qu’ils font.\n\n#### `--compilation-cache=<dir>`\n\n              \\[Avancé] Spécifie un répertoire supplémentaire à utiliser comme cache de compilation.\n\n#### `--no-default-compilation-cache`\n\n              \\[Avancé] N’utilise pas de caches de compilation dans des emplacements standard, comme dans le pack QL contenant la requête ou dans le répertoire de la chaîne d’outils CodeQL.\n\n### Options pour configurer le gestionnaire de package CodeQL\n\n#### `--registries-auth-stdin`\n\nPermet de vous authentifier auprès des registres de conteneurs GitHub Enterprise Server en passant une liste de paires \\<registry\\_url>=\\<token> séparées par des virgules.\n\nPar exemple, vous pouvez passer `https://containers.GHEHOSTNAME1/v2/=TOKEN1,https://containers.GHEHOSTNAME2/v2/=TOKEN2`\npour vous authentifier auprès de deux instances GitHub Enterprise Server.\n\nCela remplace les variables d’environnement CODEQL\\_REGISTRIES\\_AUTH et GITHUB\\_TOKEN. Si vous avez seulement besoin de vous authentifier auprès du registre de conteneurs github.com, vous pouvez vous authentifier en utilisant l’option plus simple `--github-auth-stdin`.\n\n#### `--github-auth-stdin`\n\nPermet de vous authentifier auprès du registre de conteneurs github.com en passant un jeton github.com GitHub Apps ou un jeton d’accès personnel via une entrée standard.\n\nPour vous authentifier auprès des registres de conteneurs GitHub Enterprise Server, passez `--registries-auth-stdin` ou utilisez la variable d’environnement CODEQL\\_REGISTRIES\\_AUTH.\n\nCela remplace la variable d’environnement GITHUB\\_TOKEN.\n\n### Options pour spécifier ce que nous sommes sur le point de compiler\n\nExactement l’une de ces options doit être donnée.\n\n#### `--query=<qlfile>`\n\nChemin du fichier QL que nous voulons compiler.\n\nSon répertoire et les répertoires parents feront l’objet de recherches pour trouver les fichiers qlpack.yml ou les fichiers queries.xml hérités afin de déterminer les packs nécessaires.\n\n#### `--dir=<dir>`\n\nRépertoire racine du pack contenant les requêtes à compiler.\n\n#### `--root-pack=<pkgname>`\n\n              \\[Avancé] Nom déclaré d’un pack à utiliser comme racine pour la résolution des dépendances.\n\nUtilisé lorsque le pack peut être trouvé par nom quelque part dans le chemin de recherche. Si vous connaissez l’_emplacement du disque_ de votre package racine souhaité, faites comme s’il contenait un fichier .ql et utilisez `--query` à la place.\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`."}