resolve ram

[Plomberie profonde] Prépare les options de mémoire RAM.

Qui peut utiliser cette fonctionnalité ?

CodeQL est disponible pour les types de référentiels suivants :

Dans cet article

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

Shell
codeql resolve ram [--ram=<MB>] <options>...

Description

[Plomberie profonde] Prépare les options de mémoire RAM.

Cette commande de plomberie profonde prépare les options de ligne de commande appropriées pour démarrer une sous-commande qui exécutera un évaluateur de requête QL. Elle connaît les heuristiques appropriées pour décider s’il faut conserver une partie de la mémoire configurée en dehors du segment de mémoire Java.

En particulier, cela doit être utilisé pour trouver les options -J-Xmx et --off-heap-ram appropriées avant de démarrer un serveur de requête en fonction d’une quantité totale de RAM souhaitée.

Options

Options principales

--format=<fmt>

Sélectionne le format de sortie. Les options sont les suivantes :

lines (par défaut)  : Affiche les arguments de ligne de commmande sur une ligne chacun.

json : Les affiche en tant que tableau JSON.

Options de la ligne de commande de la commande appelante

-M, --ram=<MB>

L'évaluateur de requêtes s'efforcera de maintenir son empreinte mémoire totale en dessous de cette valeur. (Toutefois, pour les grandes bases de données, il est possible que le seuil soit dépassé par les cartes mémoire sauvegardées sur fichier, qui peuvent être basculées sur disque en cas de sollicitation de la mémoire).

La valeur doit être d'au moins 2048 Mo ; les valeurs inférieures seront arrondies de manière transparente.

--dataset=<directory>

[Avancé] Adapte les paramètres de mémoire RAM à l'interrogation du jeu de données concerné, en tenant compte des composantes de l'utilisation de la mémoire RAM qui varient en fonction de la taille de la base de données. Dans le cas contraire, une taille générique par défaut sera prise en compte.

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.