{"meta":{"title":"Выходные данные CODEQL CLI SARIF","intro":"Вы можете выводить SARIF из CodeQL CLI системы и делиться результатами статического анализа с другими системами.","product":"Безопасность и качество кода","breadcrumbs":[{"href":"/ru/enterprise-cloud@latest/code-security","title":"Безопасность и качество кода"},{"href":"/ru/enterprise-cloud@latest/code-security/reference","title":"Reference"},{"href":"/ru/enterprise-cloud@latest/code-security/reference/code-scanning","title":"Проверка кода"},{"href":"/ru/enterprise-cloud@latest/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/ru/enterprise-cloud@latest/code-security/reference/code-scanning/codeql/codeql-cli","title":"CodeQL CLI"},{"href":"/ru/enterprise-cloud@latest/code-security/reference/code-scanning/codeql/codeql-cli/sarif-output","title":"Выход SARIF"}],"documentType":"article"},"body":"# Выходные данные CODEQL CLI SARIF\n\nВы можете выводить SARIF из CodeQL CLI системы и делиться результатами статического анализа с другими системами.\n\n## Сведения о выходных данных SARIF\n\nSARIF предназначен для представления выходных данных широкого спектра статических средств анализа, и существует множество функций в спецификации SARIF, которые считаются \"необязательными\". В этом документе подробно описаны выходные данные, созданные при использовании типа `sarifv2.1.0`формата, соответствующего спецификации SARIF версии 2.1.0.csd1. Дополнительные сведения о выборе формата файла для результатов анализа см. в разделе [анализ базы данных](/ru/enterprise-cloud@latest/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-analyze).\n\n## Спецификация и схема SARIF\n\nЭта статья предназначена для чтения вместе с подробной спецификацией SARIF. Дополнительные сведения о спецификации и схеме SARIF см. в [документации](https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html) по спецификации SARIF.\n\n## Сведения об изменениях\n\n### Изменения между версиями\n\n| CodeQL версия | Тип формата | Changes |\n| ------------- | ------------- | ---------------------------- |\n| 2.0.0 | `sarifv2.1.0` | Первая версия этого формата. |\n\n### Будущие изменения выходных данных\n\nВыход, создаваемый для определённого типа формата (например, `sarifv2.1.0`) может меняться в будущих CodeQL релизах. Мы будем стремиться обеспечить обратную совместимость с потребителями созданного SARIF, гарантируя следующее:\n\n* Поля, помеченные как всегда создаваемые, никогда не будут удалены.\n\n* Для полей, помеченных как не всегда создаваемые, обстоятельства, при которых создаются поля, могут измениться. Потребители CodeQL продукции SARIF должны быть устойчивы к наличию или отсутствию этих полей.\n\nНовые выходные поля могут быть добавлены в будущих выпусках в том же типе формата. Они не считаются разрывом обратной совместимости, и потребители должны быть надежными в присутствии новых добавленных полей.\n\nВ будущих версиях CodeQLмогут быть добавлены новые типы аргументов формата — например, для поддержки новых версий SARIF. Они не гарантируют обратную совместимость, если только явно не описаны.\n\n## Созданные объекты SARIF\n\nЭти сведения содержат сведения о каждом компоненте SARIF, который может быть создан вместе с любыми конкретными обстоятельствами. Мы опустим все свойства, которые никогда не создаются.\n\n### объект `sarifLog`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `$schema` | | Предоставляет ссылку на схему [](https://docs.oasis-open.org/sarif/sarif/v2.1.0/errata01/os/schemas/sarif-schema-2.1.0.json)SARIF. |\n| `version` | | Версия SARIF, используемая для создания выходных данных. |\n| `runs` | | Массив, содержащий один объект запуска для одного языка. |\n\n### объект `run`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |\n| `tool` | | None |\n| `artifacts` | | Массив, содержащий по крайней мере один объект артефакта для каждого файла, на который ссылается результат. |\n| `results` | | None |\n| `newLineSequences` | | None |\n| `columnKind` | | None |\n| `properties` | | Словарь свойств будет содержать `semmle.formatSpecifier`, который определяет спецификатор формата, переданный в CodeQL CLI. |\n\n### объект `tool`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |\n| `driver` | | None |\n\n### объект `toolComponent`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | | Установите «CodeQL командную строку инструментов» для вывода CodeQL CLI из инструментов. Обратите внимание, что если выходные данные были созданы с помощью другого инструмента, сообщается другое `name` , а формат может быть не так, как описано здесь. |\n| `organization` | | Задайте для параметра GitHub значение GitHub. |\n| `version` | | Установите версию CodeQL релиза, например, «2.0.0». |\n| `rules` | | Массив объектов `reportingDescriptor`, представляющих правила. Этот массив будет содержать как минимум все правила, выполняемые во время этого анализа, но могут содержать правила, которые были доступны, но не выполняются. Дополнительные сведения о включении запросов см. в статье `defaultConfiguration`. |\n\n### `reportingDescriptor` объект (для правила)\n\n`reportingDescriptor` объекты могут использоваться в нескольких местах в спецификации SARIF. Если объект `reportingDescriptor` включен в массив `toolComponent` правил объекта, он имеет следующие свойства.\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `id` | | Будет содержать `@id` свойство, указанное в запросе, определяющее правило, которое обычно является форматом `language/rule-name` (например `cpp/unsafe-format-string`). Если ваша организация определяет `@opaqueid` свойство в запросе, оно будет использоваться. |\n| `name` | | Будет содержать свойство, указанное `@id` в запросе. Пример см. в приведенном `id` выше свойстве. |\n| `shortDescription` | | Будет содержать `@name` свойство, указанное в запросе, определяющее правило. |\n| `fullDescription` | | Будет содержать `@description` свойство, указанное в запросе, определяющее правило. |\n| `defaultConfiguration` | | |\n| `reportingConfiguration` Объект с включенным свойством, равным true или false, и свойством `@severity` уровня, заданным в запросе, определяющим правило. Опущен, если `@severity` свойство не указано. | | |\n\n### объект `artifact`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `location` | | Объект `artifactLocation` . |\n| `index` | | Индекс объекта `artifact`. |\n| `contents` | | Если результаты создаются с помощью `--sarif-add-file-contents` флага, и исходный код доступен во время создания ФАЙЛА SARIF, `contents` свойство заполняется `artifactContent` объектом с набором `text` свойств. |\n\n### объект `artifactLocation`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `uri` | | None |\n| `index` | | None |\n| `uriBaseId` | | Если файл относится к известному абстрактному расположению, например корневому исходному расположению на компьютере анализа, это будет установлено. |\n\n### объект `result`\n\nСостав результатов зависит от вариантов, предоставленных .CodeQL По умолчанию результаты группируются по уникальной строке формата сообщений и основному расположению. Таким образом, два результата, происходящие в одном расположении с одинаковым базовым сообщением, будут отображаться в виде одного результата в выходных данных. Это поведение можно отключить с помощью флага `--ungroup-results`, в котором результаты не группируются.\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `ruleId` | | См. описание `id` свойства в `reportingDescriptor` объекте (для правила). |\n| `ruleIndex` | | None |\n| `message` | | Сообщение, описывающее проблемы, возникающие в этом расположении. Это сообщение может быть SARIF \"Сообщение с заполнителем\", содержащее ссылки, ссылающиеся на расположения в свойстве `relatedLocations` . |\n| `locations` | | Массив, содержащий один `location` объект. |\n| `partialFingerprints` | | Словарь от именованных типов отпечатков до отпечатка. Он будет содержать как минимум значение для `primaryLocationLineHash`, которое предоставляет отпечаток на основе контекста основного расположения. |\n| `codeFlows` | | Этот массив может быть заполнен одним или несколькими `codeFlow` объектами, если запрос, определяющий правило для этого результата `@kind path-problem`. |\n| `relatedLocations` | | Этот массив будет заполнен, если запрос, определяющий правило для этого результата, содержит сообщение с параметрами заполнителя. Каждое уникальное расположение включается один раз. |\n| `suppressions` | | Если результат подавляется, он будет содержать один `suppression` объект, для `@kind` свойства задано значение `IN_SOURCE`. Если этот результат не подавляется, но есть хотя бы один результат, имеющий подавление, то этот результат будет установлен на пустой массив, в противном случае он не будет задан. |\n\n### объект `location`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |\n| `physicalLocation` | | None |\n| `id` | | |\n| `location` Объекты, отображаемые `relatedLocations` в массиве `result` объекта, могут содержать `id` свойство. | | |\n| `message` | | |\n| `location` Объекты могут содержать свойство, `message` если:— Они отображаются в `relatedLocations` массиве `result` объекта, может содержать `message` свойство.— они отображаются в свойстве `threadFlowLocation.location` . | | |\n\n### объект `physicalLocation`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `artifactLocation` | | None |\n| `region` | | Если данный `physicalLocation` объект существует в текстовом файле, например в файле исходного кода, `region` то это свойство может присутствовать. |\n| `contextRegion` | | Может присутствовать, если это расположение имеет связанное `snippet`. |\n\n### объект `region`\n\nСуществует два типа объектов, производящихся `region` в:CodeQL\n\n* Области смещения строк и столбцов\n\n* Области смещения символов и длины\n\nЛюбой регион, производимый CodeQL , может быть указан в любом из этих форматов, и потребители должны надёжно работать с любым из этих типов.\n\nДля регионов смещения строк и столбцов будут заданы следующие свойства:\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |\n| `startLine` | | None |\n| `startColumn` | | Не включен, если равно значению по умолчанию 1. |\n| `endLine` | | Не включен, если идентичен `startLine`. |\n| `endColumn` | | None |\n| `snippet` | | None |\n\nДля областей смещения символов и длины будут заданы следующие свойства:\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |\n| `charOffset` | | Указано, если `startLine``startColumn`, `endLine`и `endColumn` не заполняются. |\n| `charLength` | | Указано, если `startLine``startColumn`, `endLine`и `endColumn` не заполняются. |\n| `snippet` | | None |\n\n### объект `codeFlow`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |\n| `threadFlows` | | None |\n\n### объект `threadFlow`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |\n| `locations` | | None |\n\n### объект `threadFlowLocation`\n\n| Имя свойства JSON | Всегда создается? | Примечания. |\n| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |\n| `location` | | None |"}