Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

Импорт базы данных

[Дополнительно][Сантехника] Импорт неопределенных баз данных в другую неопределенную базу данных.

GitHub CodeQL лицензируется для каждого пользователя после установки. CodeQL можно использовать только для определенных задач с ограничениями лицензии. Дополнительные сведения см. в разделе Сведения о CodeQL CLI.

Если у вас есть лицензия на GitHub Advanced Security, вы можете использовать CodeQL для автоматического анализа, непрерывной интеграции и непрерывной поставки. Дополнительные сведения см. в разделе Сведения о GitHub Advanced Security.

В этом материале описывается последний выпуск Интерфейса командной строки CodeQL. Дополнительные сведения об этом выпуске см. в разделе https://github.com/github/codeql-cli-binaries/releases.

Чтобы просмотреть сведения о параметрах, доступных для этой команды в более раннем выпуске, выполните команду с параметром в терминале --help .

Краткий обзор

Shell
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.)