数据集度量

注意

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

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

概要

Shell

codeql dataset measure --output=<file> [--threads=<num>] <options>... -- <dataset>

codeql dataset measure --output=<file> [--threads=<num>] <options>... -- <dataset>

描述

[底层实现] 收集特定数据集中关系的统计信息。

此命令通常仅在开发 CodeQL 提取器时使用，在影响数据库模式的更改之后，需要同时更改查询优化器使用的统计信息。

选项

主要选项

`<dataset>`

[必需] 要测量的原始 QL 数据集的路径。

`-o, --output=<file>`

[必需] 用于写入统计信息的输出文件，通常使用 '.dbscheme.stats' 扩展名。

`-j, --threads=<num>`

要使用的并发线程数。

默认值为 1。可以传入 0 以在机器上每个核心使用一个线程，或者使用 -N 来保留 N 个核心不使用（但仍会使用至少一个线程）。

常用选项

`-h, --help`

显示此帮助文本。

`-J=<opt>`

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

（请注意，包含空格的选项将无法正确处理。）

`-v, --verbose`

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

`-q, --quiet`

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

`--verbosity=<level>`

[高级] 将详细程度显式设置为以下之一：errors、warnings、progress、progress+、progress++、progress+++。会覆盖 -v 和 -q。

`--logdir=<dir>`

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

（若希望自行完全控制日志文件名，请改用 --log-to-stderr 并按需重定向 stderr。）

`--common-caches=<dir>`

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

自 v2.15.2 起可用。

谁可以使用此功能？

本文内容

概要

描述

选项