{"meta":{"title":"Завершение работы базы данных","intro":"[Сантехника] Заключительные шаги по созданию базы данных.","product":"Безопасность и качество кода","breadcrumbs":[{"href":"/ru/code-security","title":"Безопасность и качество кода"},{"href":"/ru/code-security/reference","title":"Reference"},{"href":"/ru/code-security/reference/code-scanning","title":"Проверка кода"},{"href":"/ru/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Руководство по cli CodeQL"},{"href":"/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-finalize","title":"Завершение работы базы данных"}],"documentType":"article"},"body":"# Завершение работы базы данных\n\n\\[Сантехника] Заключительные шаги по созданию базы данных.\n\n> \\[!NOTE]\n> Это содержимое описывает последний выпуск данных CodeQL CLI. Дополнительные сведения об этом выпуске см. в статье <https://github.com/github/codeql-cli-binaries/releases>.\n>\n> Чтобы просмотреть сведения о параметрах, доступных для этой команды в предыдущем выпуске, выполните команду с <span style=\"white-space: nowrap;\">`--help`</span> параметром в терминале.\n\n## Synopsis\n\n```shell copy\ncodeql database finalize [--dbscheme=<file>] [--threads=<num>] [--ram=<MB>] <options>... -- <database>\n```\n\n## Description\n\n```\n          \\[Сантехника] Заключительные шаги по созданию базы данных.\n```\n\nЗавершите создание базы данных с помощью [инициализации](/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-init) базы данных codeql и последующего заполнения данными анализа с помощью [команды trace-database](/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-trace-command) codeql. Это должно произойти до того, как новая база данных может быть запрошена.\n\n## Options\n\n### Основные параметры\n\n#### `<database>`\n\n```\n          \\[Обязательный] Путь к базе данных CodeQL в стадии разработки. Это должно быть подготовлено для извлечения с помощью [инициализации](/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-init) базы данных codeql.\n\n          `--db-cluster` Если этот параметр задан, это не сама база данных, а каталог, _содержащий_ базы данных, и все эти базы данных будут обрабатываться вместе.\n```\n\n#### `--[no-]db-cluster`\n\nУказывает, что каталог, указанный в командной строке, не является самой базой данных, а каталогом, *который содержит* одну или несколько баз данных в стадии создания. Эти базы данных будут обрабатываться вместе.\n\n#### `--additional-dbs=<database>[:<database>...]`\n\n```\n          \\[Дополнительно] Путь к дополнительным базам данных CodeQL в стадии разработки.\n```\n\nОни не будут завершены, но данные из них будут включены в созданную базу данных. Это расширенный вариант, который может не иметь требуемого эффекта во всех случаях. Дополнительные сведения см. в документации по импорту [](/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-import)базы данных codeql.\n\nЕсли этот `--db-cluster` параметр задан, ожидается, что они будут кластерами баз данных, а не отдельными базами данных CodeQL.\n\n(Примечание. В Windows разделитель путей имеет значение `;`).\n\n#### `--no-cleanup`\n\n```\n          \\[Дополнительно] Отключить очистку всех баз данных после завершения. Полезно для отладки.\n```\n\n#### `--no-pre-finalize`\n\n```\n          \\[Дополнительно] Пропустить любой скрипт предварительного завершения, указанный активным методом извлечения CodeQL.\n```\n\n#### `--[no-]skip-empty`\n\n```\n          \\[Дополнительно] Выводит предупреждение вместо сбоя, если база данных пуста, так как во время сборки не отображается исходный код. Пустая база данных останется неопределенной.\n```\n\n### Параметры управления операцией импорта TRAP\n\n#### `-S, --dbscheme=<file>`\n\n```\n          \\[Дополнительно] Переопределите определение dbscheme автоматически обнаруженных dbscheme, согласно которому предполагается, что файлы TRAP соответствуют. Обычно это происходит из средства извлечения базы данных.\n```\n\n#### `-j, --threads=<num>`\n\nИспользуйте это множество потоков для операции импорта.\n\nЗначение по умолчанию — 1. Вы можете передать 0 для использования одного потока на ядро на компьютере или -*N, чтобы оставить *неиспользуемые* ядра N* (за исключением того, что по-прежнему используется хотя бы один поток).\n\n#### `-M, --ram=<MB>`\n\nИспользуйте это много памяти для операции импорта.\n\n### Параметры очистки набора данных низкого уровня\n\n#### `--max-disk-cache=<MB>`\n\nЗадайте максимальное количество места, которое может использовать кэш диска для промежуточных результатов запроса.\n\nЕсли этот размер не настроен явным образом, вычислитель попытается использовать \"разумное\" пространство кэша на основе размера набора данных и сложности запросов. Явно устанавливая более высокий предел, чем это использование по умолчанию, позволит включить дополнительные кэширования, которые могут ускорить последующие запросы.\n\n#### `--min-disk-free=<MB>`\n\n```\n          \\[Дополнительно] Задайте целевой объем свободного места в файловой системе.\n```\n\nЕсли `--max-disk-cache` это не задано, средство оценки попытается ограничить использование кэша дисков, если свободное место в файловой системе снижается ниже этого значения.\n\n#### `--min-disk-free-pct=<pct>`\n\n```\n          \\[Дополнительно] Задайте целевую долю свободного места в файловой системе.\n```\n\nЕсли `--max-disk-cache` это не задано, средство оценки попытается ограничить использование кэша дисков, если свободное место в файловой системе снижается ниже этого процента.\n\n#### `--cache-cleanup=<mode>`\n\nВыберите, как агрессивно обрезать кэш. В число вариантов входят следующие варианты:\n\n```\n          `clear`: удалите весь кэш, обрезая состояние недавно извлеченного набора данных.\n\n          `trim`\n          _(по умолчанию)_: обрезать все, кроме явно кэшированных предикатов.\n\n          `fit`: просто убедитесь, что определенные ограничения размера кэша дисков наблюдаются, удаляя столько промежуточных, сколько необходимо.\n\n          `overlay`: обрезка только данных, которые будут полезны при оценке наложения.\n```\n\n#### `--cleanup-upgrade-backups`\n\nУдалите все каталоги резервных копий из-за обновлений базы данных.\n\n### Параметры проверки импортированной ЛОВУШКИ\n\n#### `--[no-]check-undefined-labels`\n\n```\n          \\[Дополнительно] Сообщить об ошибках для неопределенных меток.\n```\n\n#### `--[no-]check-unused-labels`\n\n```\n          \\[Дополнительно] Сообщить об ошибках для неиспользуемых меток.\n```\n\n#### `--[no-]check-repeated-labels`\n\n```\n          \\[Дополнительно] Сообщить об ошибках для повторяющихся меток.\n```\n\n#### `--[no-]check-redefined-labels`\n\n```\n          \\[Дополнительно] Сообщить об ошибках для переопределенных меток.\n```\n\n#### `--[no-]check-use-before-definition`\n\n```\n          \\[Дополнительно] Сообщить об ошибках для меток, используемых перед их определением.\n```\n\n#### `--[no-]fail-on-trap-errors`\n\n```\n          \\[Дополнительно] Выход ненулевых, если ошибка возникает во время импорта ловушки.\n```\n\n#### `--[no-]include-location-in-star`\n\n```\n          \\[Дополнительно] Создание идентификаторов сущностей, кодируемых расположением в файле TRAP, из который они были получены. Может быть полезно для отладки генераторов TRAP, но занимает много места в наборе данных.\n```\n\n#### `--[no-]linkage-aware-import`\n\n```\n          \\[Дополнительно] Определяет, поддерживается ли [импорт](/code-security/reference/code-scanning/codeql/codeql-cli-manual/dataset-import) набора данных codeql с учетом _компоновки (по умолчанию)._ В проектах, где эта часть создания базы данных потребляет слишком много памяти, отключение этого параметра может помочь им выполняться за счет полноты базы данных.\n```\n\nДоступно с момента `v2.15.3`.\n\n### Распространенные параметры\n\n#### `-h, --help`\n\nОтображение этого текста справки.\n\n#### `-J=<opt>`\n\n```\n          \\[Дополнительно] Укажите параметр JVM, выполняя команду.\n```\n\n(Убедитесь, что параметры, содержащие пробелы, не будут обрабатываться правильно.)\n\n#### `-v, --verbose`\n\nПостепенно увеличьте число отображаемых сообщений о ходе выполнения.\n\n#### `-q, --quiet`\n\nПостепенно уменьшайте количество отображаемых сообщений о ходе выполнения.\n\n#### `--verbosity=<level>`\n\n```\n          \\[Дополнительно] Явным образом задайте уровень детализации на одну из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет `-v` и `-q`.\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющегося подкоманда.\n```\n\n(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого предоставьте `--log-to-stderr` и перенаправите stderr по мере необходимости.)\n\n#### `--common-caches=<dir>`\n\n```\n          \\[Дополнительно] Управляет расположением кэшированных данных на диске, которые будут сохраняться между несколькими запусками интерфейса командной строки, такими как скачанные пакеты QL и скомпилированные планы запросов. Если этот параметр не задан явным образом, по умолчанию используется каталог с именем `.codeql` в домашнем каталоге пользователя; он будет создан, если он еще не существует.\n```\n\nДоступно с момента `v2.15.2`."}