Настройка параметров

О настройках в расширении CodeQL для Visual Studio Code

Вы можете изменить множество настроек для CodeQL расширения Visual Studio Code , включая:

Какую версию CodeQL CLI расширения использует?
Как расширение отображает предыдущие запросы.
Как расширение выполняет запросы.

Настройки редактирования CodeQL расширения

Откройте просмотр «Расширения» и кликните правой кнопкой CodeQL мыши, затем нажмите «Настройки расширения».
В окне "Параметры" измените параметры по мере необходимости. Новые параметры сохраняются автоматически.

Совет

В качестве альтернативы можно отредактировать настройки в формате JSON, открыв VS Code Command Palette и выбрав Preferences: Open User Settings (JSON)».

Выбор версии CodeQL CLI

Чтобы обойти стандартное поведение и использовать конкретную версию CodeQL CLI, вы можете указать CodeQL CLI «Исполняемый путь» в настройках расширения и указать его на вашу существующую копию CodeQL CLI. То есть файл с именем codeql (Linux и macOS) или codeql.exe (Windows). Дополнительные сведения о поведении по умолчанию см. в разделе Управление CLI CodeQL в расширении VS Code.

Изменение меток элементов журнала запросов

Параметр журнала запросов "Формат" определяет, как расширение перечисляет запросы в журнале запросов. По умолчанию каждый элемент имеет метку со следующим форматом:

QUERY-NAME on DATABASE-NAME - QUERY-STATUS NUMBER-OF-RESULTS [QUERY-RUNTIME]

Чтобы переопределить метку по умолчанию, можно указать другой формат для элементов журнала запросов.

Изменение срока хранения элементов журнала запросов

По умолчанию элементы в представлении "Журнал запросов" хранятся в течение 30 дней. Можно задать другое время жизни (TTL), изменив параметр "Журнал запросов: Ttl". Чтобы сохранить элементы на неопределенный срок, задайте значение 0.

Настройка параметров локального выполнения запросов

В разделе "Выполнение запросов" существует ряд параметров. Например, если запросы выполняются слишком медленно и часто истекает время ожидания, может потребоваться увеличить память, изменив параметр "Выполнение запросов: память".

Если вы хотите проверить производительность запросов, включите параметр "Выполнение запросов: отладка", чтобы включить количество времени и кортежей. Это будет отображаться в логах на CodeQL вкладке «Сервер запросов» в виде «Вывод». Количество кортежей полезно, так как оно указывает размер предикатов , вычисляемых запросом.

Чтобы сохранить журналы сервера запросов в пользовательском расположении, измените параметр "Выполнение запросов: Пользовательский каталог журналов". Если вы используете пользовательский каталог журналов, расширение сохраняет журналы безвозвратно, а не автоматически удаляет их после каждого сеанса рабочей области. Это полезно, если вы хотите исследовать эти журналы, чтобы повысить производительность запросов.

Настройка параметров для анализа вариантов

В разделе «Анализ вариантов» есть несколько настроек, которые можно использовать для определения или редактирования списков GitHub репозиториев для анализа вариантов и изменения в другой репозиторий контроллеров. Сведения о назначении и требованиях для репозитория контроллера см. в разделе Выполнение запросов CodeQL в масштабе с помощью анализа вариантов с несколькими репозиториями.

Вы также можете редактировать элементы, отображаемые в виде «Репозитории анализа вариантов», отредактировав файл в вашем Visual Studio Code рабочем пространстве под названием databases.json. Этот файл содержит представление JSON всех элементов, отображаемых в представлении. Чтобы открыть databases.json файл в окне редактора, щелкните значок { } в правом верхнем углу представления "Репозитории анализа вариантов". Затем в представлении можно увидеть структурированное представление репозиториев, организаций и списков. Рассмотрим пример.

{
  "version": 1,
  "databases": {
    "variantAnalysis": {
      "repositoryLists": [
        {
          "name": "My favorite JavaScript repos",
          "repositories": [
            "facebook/react",
            "babel/babel",
            "angular/angular"
          ]
        }
      ],
      "owners": [
        "microsoft"
      ],
      "repositories": [
        "apache/hadoop"
      ]
    }
  },
  "selected": {
    "kind": "variantAnalysisSystemDefinedList",
    "listName": "top_10"
  }
}

Вы можете изменить элементы, отображаемые в представлении, или добавить новые элементы, напрямую изменив этот файл.

Настройка параметров для добавления баз данных

Чтобы автоматически добавить папки источника базы данных в рабочую область, можно включить параметр "Добавление баз данных: добавление источника базы данных в рабочую область".

Этот флажок по умолчанию снят. Можно включить параметр, если вы регулярно просматриваете исходный код баз данных (например, чтобы просмотреть абстрактное дерево синтаксиса кода). Дополнительные сведения см. в разделе Изучение структуры исходного кода.

Примечание.

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

Перед включением этого параметра рекомендуется сохранить рабочую область в качестве много корневой рабочей области. Для получения дополнительной информации см. раздел «Многокорневые рабочие пространства » в Visual Studio Code документации.

        [Настройки пользователя и рабочего пространства](https://code.visualstudio.com/docs/configure/settings) в Visual Studio Code документации

В этой статье