跳至主要内容

resolve ram

[深度管道] 准备 RAM 选项。

谁可以使用此功能?

CodeQL 可用于以下代码库类型

本文内容

此内容描述了 CodeQL CLI 的最新版本。有关此版本的更多信息,请参阅 https://github.com/github/codeql-cli-binaries/releases

要在早期版本中查看此命令可用的选项的详细信息,请在终端中使用 --help 选项运行该命令。

概要

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

描述

[深度管道] 准备 RAM 选项。

此深度管道命令准备合适的命令行选项以启动一个子命令,该子命令将执行 QL 查询评估器。它知道用于确定是否将某些已配置内存保留在 Java 堆之外的适当启发式方法。

特别是,在基于所需的 RAM 量启动查询服务器之前,应使用此方法查找合适的 -J-Xmx--off-heap-ram 选项。

选项

主要选项

--format=<fmt>

选择输出格式。选项包括

lines (默认):在每一行上打印命令行参数。

json:将它们打印为 JSON 数组。

来自调用命令的命令行的选项

-M, --ram=<MB>

查询评估器将尽力将其总内存占用保持在该值以下。(但是,对于大型数据库,文件支持的内存映射可能会超过阈值,在内存压力的情况下,这些内存映射可以交换到磁盘)。

该值应至少为 2048 MB;较小的值将被透明地向上舍入。

--dataset=<directory>

[高级] 为查询给定数据集适当地调整 RAM 设置,同时考虑随数据库大小缩放的 RAM 使用组件。如果未提供此设置,则将假定通用默认大小。

常用选项

-h, --help

显示此帮助文本。

-J=<opt>

[高级] 为运行命令的 JVM 提供选项。

(注意,包含空格的选项将无法正确处理。)

-v, --verbose

逐步增加打印的进度消息的数量。

-q, --quiet

逐步减少打印的进度消息的数量。

--verbosity=<level>

[高级] 将详细程度级别显式设置为错误、警告、进度、进度+、进度++、进度+++ 之一。覆盖 -v-q

--logdir=<dir>

[高级] 将详细日志写入给定目录中的一个或多个文件中,生成的文件名包含时间戳和正在运行的子命令的名称。

(要使用您完全控制的名称写入日志文件,请改用 --log-to-stderr 并根据需要重定向 stderr。)

--common-caches=<dir>

[高级] 控制磁盘上缓存数据的存储位置,这些数据会在 CLI 的多次运行之间持续存在,例如下载的 QL 包和编译后的查询计划。如果未显式设置,则默认为用户主目录中的名为 .codeql 的目录;如果该目录不存在,则会创建它。

v2.15.2 版本起可用。