跳至主要内容

数据库解包

提取 CodeQL 数据库存档。

谁可以使用此功能?

CodeQL 可用于以下存储库类型

本文档包含以下内容

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

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

摘要

Shell
codeql database unbundle <options>... -- <archive>

描述

提取 CodeQL 数据库存档。

此命令提取由 codeql database bundle 创建的 CodeQL 数据库存档。它类似于使用 unzip 解压缩数据库,但在某些情况下性能更好(例如,unzip 在 Windows 上非常慢)并且支持其他选项,例如设置提取的数据库的名称。

选项

主要选项

<archive>

[必填] 要解压缩的 CodeQL 数据库存档的路径。

--name=<name>

要赋予创建的 CodeQL 数据库的名称。如果未提供,则将与存档中数据库的名称匹配。

--target=<target>

要在其中解压缩 CodeQL 数据库的目录。如果未提供,则默认为当前工作目录。

常用选项

-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 起可用。