此内容描述了 CodeQL CLI 的最新版本。有关此版本的更多信息,请参阅 https://github.com/github/codeql-cli-binaries/releases。
要在早期版本中查看此命令可用的选项的详细信息,请在终端中使用 --help
选项运行该命令。
概要
codeql resolve ram [--ram=<MB>] <options>...
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
版本起可用。