В этом материале описывается последний выпуск Интерфейса командной строки CodeQL. Дополнительные сведения об этом выпуске см. в разделе https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в более раннем выпуске, выполните команду с параметром в терминале --help
.
Краткий обзор
codeql resolve upgrades --dbscheme=<file> <options>...
Описание
[Глубокая сантехника— определение обновлений для необработанного набора данных.
Определите, какие обновления необходимо выполнить для определенного необработанного набора данных QL, чтобы привести его в состояние настроенных библиотек QL. Это вычисление является частью того, что происходит во время обычного обновления базы данных, и предоставляется в виде отдельной команды сантехники, чтобы (а) помочь в устранении неполадок и (б) предоставить отправную точку для изменения пути в чрезвычайных случаях, когда требуется точное управление.
Основные параметры
--dbscheme=<file>
[Обязательно] Текущий dbscheme набора данных, который мы хотим обновить.
--format=<fmt>
Выберите формат вывода. Можно выбрать:
lines
(по умолчанию): печатайте скрипты обновления в одной строке.
json
: выводит массив JSON путей к скриптам обновления.
--just-check
Не выводите выходные данные, а завершите работу с кодом 0, если требуется выполнить обновления, и кодом 1, если их нет.
Параметры из командной строки вызывающей команды
--search-path=<dir>[:<dir>...]
Список каталогов, в которых можно найти пакеты QL, содержащие рецепты обновления. Каждый каталог может быть либо пакетом QL (или пакетом пакетов, .codeqlmanifest.json
содержащим файл в корне), либо непосредственным родительским элементом одного или нескольких таких каталогов.
Если путь содержит деревья каталогов, их порядок определяет приоритет между ними: если имя пакета, которое необходимо разрешить, совпадает в нескольких деревьях каталогов, первое из них побеждает.
Указание на это при извлечении репозитория CodeQL с открытым кодом должно работать при запросе одного из языков, которые там живут.
(Примечание. В Windows разделителем пути является ;
).
--additional-packs=<dir>[:<dir>...]
[Дополнительно] Если указан этот список каталогов, они будут искать обновления до тех, которые в --search-path
. Порядок между ними не имеет значения; Это ошибка, если имя пакета найдено в двух разных местах в этом списке.
Это полезно, если вы временно разрабатываете новую версию пакета, которая также отображается в пути по умолчанию. С другой стороны, не рекомендуется переопределять этот параметр в файле конфигурации; некоторые внутренние действия добавляют этот параметр на лету, переопределяя любое настроенное значение.
(Примечание. В Windows разделителем пути является ;
).
--target-dbscheme=<file>
Целевой dbscheme, до которого требуется выполнить обновление. Если это не задано, будет создан максимальный путь обновления.
--target-sha=<sha>
[Дополнительно] Альтернатива --target-dbscheme
, которая предоставляет внутренний хэш целевого dbscheme вместо файла dbscheme.
--[no-]allow-downgrades
Включение всех соответствующих переходов на более раннюю версию при отсутствии обновлений
Общие параметры
-h, --help
Показать этот текст справки.
-J=<opt>
[Дополнительно] Предоставьте параметр виртуальной машине JVM, выполняющую команду .
(Остерегайтесь, что параметры, содержащие пробелы, будут обрабатываться неправильно.)
-v, --verbose
Постепенно увеличивайте количество выводемых сообщений о ходе выполнения.
-q, --quiet
Постепенно уменьшайте количество выводемых сообщений о ходе выполнения.
--verbosity=<level>
[Дополнительно] Явно задайте уровень детализации для одной из ошибок, предупреждений, progress, progress+, progress++, progress+++. Переопределяет -v
и -q
.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющейся подкоманды.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого при необходимости предоставьте --log-to-stderr
и перенаправьте stderr.)