Note
Это содержимое описывает последний выпуск данных CodeQL CLI. Дополнительные сведения об этом выпуске см. в статье https://github.com/github/codeql-cli-binaries/releases.
Чтобы просмотреть сведения о параметрах, доступных для этой команды в предыдущем выпуске, выполните команду с --help параметром в терминале.
Краткие сведения
codeql dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...
codeql dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...
Description
[Сантехника] Импорт набора файлов TRAP в необработанный набор данных.
Создайте набор данных, заполняя его файлами TRAP или добавляя данные из ФАЙЛОВ TRAP в существующий набор данных. Обновление набора данных возможно только в том случае, если он имеет правильный dbscheme и его пул идентификаторов был сохранен из первоначального импорта.
Параметры
Основные параметры
<dataset>
[Обязательный] Путь к необработанному набору данных QL для создания или обновления. Каталог будет создан, если он еще не существует.
<trap>...
Пути к файлам .trap(.gz) для импорта или в каталоги, которые будут рекурсивно сканированы для файлов .trap(.gz). Если файлы отсутствуют, будет создан пустой набор данных.
-S, --dbscheme=<file>
[Обязательно] Определение dbscheme, описывающее файлы TRAP, которые необходимо импортировать.
-j, --threads=<num>
Используйте это множество потоков для операции импорта.
По умолчанию равен 1. Вы можете передать 0 для использования одного потока на ядро на компьютере или -N, чтобы оставить неиспользуемые ядра N (за исключением того, что по-прежнему используется хотя бы один поток).
--[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, но занимает много места в наборе данных.
--[no-]linkage-aware-import
[Дополнительно] Определяет, поддерживается ли импорт набора данных codeql с учетом компоновки (по умолчанию). В проектах, где эта часть создания базы данных потребляет слишком много памяти, отключение этого параметра может помочь им выполняться за счет полноты базы данных.
Доступно с момента v2.15.3.
Распространенные параметры
-h, --help
Отображение этого текста справки.
-J=<opt>
[Дополнительно] Укажите параметр JVM, выполняя команду.
(Убедитесь, что параметры, содержащие пробелы, не будут обрабатываться правильно.)
-v, --verbose
Постепенно увеличьте число отображаемых сообщений о ходе выполнения.
-q, --quiet
Постепенно уменьшайте количество отображаемых сообщений о ходе выполнения.
--verbosity=<level>
[Дополнительно] Явным образом задайте уровень детализации на одну из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет -v и -q.
--logdir=<dir>
[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющегося подкоманда.
(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого предоставьте --log-to-stderr и перенаправите stderr по мере необходимости.)
--common-caches=<dir>
[Дополнительно] Управляет расположением кэшированных данных на диске, которые будут сохраняться между несколькими запусками интерфейса командной строки, такими как скачанные пакеты QL и скомпилированные планы запросов. Если этот параметр не задан явным образом, по умолчанию используется каталог с именем .codeql в домашнем каталоге пользователя; он будет создан, если он еще не существует.
Доступно с момента v2.15.2.