команда трассировки базы данных

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

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

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

Shell

codeql database trace-command [--threads=<num>] [--ram=<MB>] [--extractor-option=<extractor-option-name=value>] <options>... -- <database> <command>...

Описание

[Сантехника] Выполнение одной команды в рамках трассировки сборки.

При этом выполняется одна заданная командная строка в трассировке, что, возможно, выполняет некоторое извлечение, но не завершает итоговую базу данных CodeQL.

Основные параметры

`<database>`

[Обязательно] Путь к строяемой базе данных CodeQL. Он должен быть подготовлен для извлечения с помощью инициализации базы данных codeql.

--db-cluster Если параметр задан, это не сама база данных, а каталог, содержащий базы данных, и все эти базы данных будут обрабатываться вместе.

`<command>...`

Выполняемая команда Он может состоять из одного или нескольких аргументов, которые используются для создания процесса. Рекомендуется передать аргумент "--" перед перечислением аргументов команды, чтобы избежать путаницы между ее аргументами и нашими аргументами.

Ожидается, что команда завершит работу с кодом состояния 0. Любой другой код выхода интерпретируется как сбой.

Команда может быть опущена при --index-traceless-dbs указании.

`-j, --threads=<num>`

Попросите средство извлечения использовать это количество потоков. Этот параметр передается в средство извлечения в виде предложения. Если задана переменная среды CODEQL_THREADS, значение переменной среды имеет приоритет над этим параметром.

Вы можете передать 0, чтобы использовать один поток на каждое ядро на компьютере, или -N , чтобы оставить N ядер неиспользуемых (за исключением использования по крайней мере одного потока).

`-M, --ram=<MB>`

Попросите средство извлечения использовать этот объем памяти. Этот параметр передается в средство извлечения в виде предложения. Если задана переменная среды ОЗУ CODEQL_, значение переменной среды имеет приоритет над этим параметром.

`--[no-]db-cluster`

Указывает, что каталог, заданный в командной строке, не является самой базой данных, а каталогом, содержащим одну или несколько создаваемых баз данных. Эти базы данных будут обрабатываться вместе.

`--no-tracing`

[Дополнительно] Не отслеживайте указанную команду, а полагайтесь на нее для получения всех необходимых данных напрямую.

`--extra-tracing-config=<tracing-config.lua>`

[Дополнительно] Путь к файлу конфигурации трассировки. Его можно использовать для изменения поведения трассировки сборки. Его можно использовать для выбора процессов компилятора, которые выполняются как часть команды сборки, и запуска выполнения других средств. Средства извлечения предоставляют файлы конфигурации трассировки по умолчанию, которые должны работать в большинстве ситуаций.

`--[no-]index-traceless-dbs`

В дополнение к указанной команде запустите скрипт main для средств извлечения, которые не зависят от трассировки процесса сборки. Если вы создаете базы данных для нескольких языков с --db-clusterпомощью , этот параметр следует предоставить ровно одному вызову команды trace-базы данных codeql.

`--working-dir=<dir>`

[Дополнительно] Каталог, в котором должна выполняться указанная команда. Если этот аргумент не указан, команда выполняется в значении , переданном --source-root в создание базы данных codeql, если оно существует. Если аргумент не --source-root указан, команда выполняется в текущем рабочем каталоге.

`--no-run-unnecessary-builds`

[Дополнительно] Выполняйте указанные команды сборки, только если в строящихся базах данных используется средство извлечения, зависящее от трассировки процесса сборки. Если этот параметр не задан, команда будет выполняться даже в том случае, если codeQL не требуется, при условии, что ее побочные эффекты нужны по другим причинам.

Параметры управления поведением средства извлечения

`-O, --extractor-option=<extractor-option-name=value>`

Задайте параметры для средств извлечения CodeQL. extractor-option-name значение должно иметь имя средства извлечения_формы.имя группы1.group2.option_или имя параметра group1.group2.option_. Если extractor_option_name начинается с имени средства извлечения, указанный метод извлечения должен объявить имя параметра group1.group2.option_. В противном случае для любого средства извлечения, объявляющего имя параметра group1.group2.option_, будет задан параметр . value может быть любой строкой, которая не содержит новую строку.

Этот параметр командной строки можно использовать несколько раз, чтобы задать несколько параметров средства извлечения. Если вы укаживаете несколько значений для одного и того же параметра средства извлечения, поведение зависит от типа, ожидаемого параметром средства извлечения. В параметрах строки будет использоваться последнее указанное значение. Параметры массива будут использовать все указанные значения по порядку. Параметры средства извлечения, указанные с помощью этого параметра командной строки, обрабатываются после получения параметров средства извлечения с помощью --extractor-options-file.

При передаче в инициализацию базы данных codeql или codeql database begin-tracingпараметры будут применяться только к непрямой среде трассировки. Если рабочий процесс также вызывает команду trace-command базы данных codeql , при необходимости необходимо передать туда параметры.

Дополнительные https://codeql.github.com/docs/codeql-cli/extractor-options сведения о параметрах средства извлечения CodeQL, в том числе о том, как вывести список параметров, объявленных каждым методом извлечения.

`--extractor-options-file=<extractor-options-bundle-file>`

Укажите файлы пакета параметров извлечения. Файл пакета параметров извлечения — это JSON-файл (расширение .json) или YAML-файл (расширение .yaml или .yml), который задает параметры средства извлечения. Файл должен иметь ключ карты верхнего уровня "extractor" и, под ним, имена средств извлечения в виде ключей карты второго уровня. Дополнительные уровни карт представляют вложенные группы средств извлечения, а параметры строки и массива — это записи карты со значениями строк и массивов.

Файлы пакета параметров извлечения считываются в указанном порядке. Если разные файлы пакета параметров извлечения указывают один и тот же параметр средства извлечения, поведение зависит от типа, который ожидает параметр средства извлечения. В параметрах строки будет использоваться последнее указанное значение. Параметры массива будут использовать все указанные значения по порядку. Параметры средства извлечения, указанные с помощью этого параметра командной строки, обрабатываются до того, как параметры средства извлечения предоставляются с помощью --extractor-option.