В этом материале описывается последний выпуск Интерфейса командной строки CodeQL. Дополнительные сведения об этом выпуске см. в разделе https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в более раннем выпуске, выполните команду с параметром в терминале --help
.
Краткий обзор
codeql database import [--dbscheme=<file>] [--threads=<num>] [--ram=<MB>] <options>... -- <database> <additionalDbs>...
Описание
[Дополнительно] [Сантехника] Импорт неопределенных баз данных в другую неопределенную базу данных.
В результате выполнения этой команды целевая база данных (в первом аргументе) будет дополнена данными из всех переданных баз данных. В частности, будут импортированы файлы TRAP из других баз данных, а источники в них будут скопированы.
Обратите внимание, что в большинстве случаев эта команда, вероятно, не будет иметь желаемого эффекта. В частности, результирующая база данных может неправильно отслеживать поток данных между частичными базами данных, которые были объединены. Он предназначен только для использования в некоторых сложных сценариях, включающих распределенные системы сборки, в которых особое внимание было уделено способу разделения сборки, чтобы гарантировать, что итоговая база данных имеет смысл.
Основные параметры
<database>
[Обязательный] Путь к строяемой базе данных CodeQL. Он должен быть подготовлен для извлечения с помощью инициализации базы данных codeql.
--db-cluster
Если параметр задан, это не сама база данных, а каталог, содержащий базы данных, и все эти базы данных будут обрабатываться вместе.
<additionalDbs>...
[Обязательный] Пути к незавершенным базам данных, которые должны быть импортированы в первую базу данных.
--db-cluster
Если этот параметр задан, ожидается, что это будут кластеры баз данных, а не отдельные базы данных CodeQL.
--[no-]db-cluster
Указывает, что каталог, заданный в командной строке, является не самой базой данных, а каталогом, содержащим одну или несколько баз данных, которые строят. Эти базы данных будут обрабатываться вместе.
Параметры управления операцией импорта TRAP
-S, --dbscheme=<file>
[Дополнительно. Переопределите автоматически обнаруженное определение dbscheme, которому, как предполагается, соответствуют файлы TRAP. Как правило, он берется из средства извлечения базы данных.
-j, --threads=<num>
Используйте это количество потоков для операции импорта.
По умолчанию равен 1. Можно передать 0, чтобы использовать один поток на каждом ядре на компьютере, или -N , чтобы оставить N ядер неиспользуемых (за исключением использования хотя бы одного потока).
-M, --ram=<MB>
Используйте этот объем памяти для операции импорта.
Параметры проверки импортированных параметров TRAP
--[no-]check-undefined-labels
[Дополнительно] Сообщать об ошибках для неопределенных меток.
--[no-]check-unused-labels
[Дополнительно] Сообщать об ошибках для неиспользуемых меток.
--[no-]check-repeated-labels
[Дополнительно] Сообщать об ошибках для повторяющиеся метки.
--[no-]check-redefined-labels
[Дополнительно] Сообщать об ошибках для переопределенных меток.
--[no-]check-use-before-definition
[Дополнительно] Сообщите об ошибках для меток, используемых до их определения.
--[no-]fail-on-trap-errors
[Дополнительно] Выйдите из ненулевых, если во время импорта ловушки возникает ошибка.
--[no-]include-location-in-star
[Дополнительно] Создайте идентификаторы сущностей, которые кодируют расположение в файле TRAP, из чего они поступили. Может быть полезно для отладки генераторов TRAP, но занимает много места в наборе данных.
Общие параметры
-h, --help
Показать этот текст справки.
-J=<opt>
[Дополнительно] Предоставьте параметр виртуальной машине Java, запустив команду .
(Остерегайтесь, что параметры, содержащие пробелы, будут обрабатываться неправильно.)
-v, --verbose
Добавочное увеличение числа выводемых сообщений о ходе выполнения.
-q, --quiet
Постепенно уменьшайте количество выводемых сообщений о ходе выполнения.
--verbosity=<level>
[Дополнительно] Явно задайте уровень детализации для одной из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет -v
и -q
.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в заданном каталоге с созданными именами, включая метки времени и имя выполняющейся подкоманды.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого при необходимости предоставьте --log-to-stderr
и перенаправьте stderr.)