{"meta":{"title":"Формат запроса","intro":"Исходный код автоформата QL.","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/query-format","title":"Формат запроса"}],"documentType":"article"},"body":"# Формат запроса\n\nИсходный код автоформата QL.\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 query format [--output=<file>] [--in-place] [--backup=<ext>] <options>... -- <file>...\n```\n\n## Description\n\nИсходный код автоформата QL.\n\n## Options\n\n### Основные параметры\n\n#### `<file>...`\n\nОдин или `.ql` несколько исходных `.qll` файлов для автоформатирования. Дефис можно указать для чтения из стандартных входных данных.\n\n#### `-o, --output=<file>`\n\nЗапишите форматированный код QL в этот файл вместо стандартного выходного потока. Не следует указывать, если имеется несколько входных данных.\n\n#### `-i, --[no-]in-place`\n\nПерезапись каждого входного файла с форматированными версиями содержимого.\n\n#### `--[no-]check-only`\n\nВместо записи выходных данных выйдите из состояния 1, если входные файлы _отличаются_ от правильного форматирования. Сообщение, указывающее, какие файлы отличаются, будут напечатаны на стандартную ошибку, если вы также не предоставите `-qq`.\n\n#### `-b, --backup=<ext>`\n\nПри записи файла, который уже существует, переименуйте существующий файл в резервную копию, добавив это расширение к его имени. Если файл резервной копии уже существует, он будет автоматически удален.\n\n#### `--no-syntax-errors`\n\nЕсли входной файл не является синтаксически правильным QL, притворяется, что он уже правильно отформатирован. (Обычно такой файл вызывает завершение команды с сообщением об ошибке.\n\n### Распространенные параметры\n\n#### `-h, --help`\n\nОтображение этого текста справки.\n\n#### `-J=<opt>`\n\n              \\[Дополнительно] Укажите параметр JVM, выполняя команду.\n\n(Убедитесь, что параметры, содержащие пробелы, не будут обрабатываться правильно.)\n\n#### `-v, --verbose`\n\nПостепенно увеличьте число отображаемых сообщений о ходе выполнения.\n\n#### `-q, --quiet`\n\nПостепенно уменьшайте количество отображаемых сообщений о ходе выполнения.\n\n#### `--verbosity=<level>`\n\n              \\[Дополнительно] Явным образом задайте уровень детализации на одну из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет `-v` и `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющегося подкоманда.\n\n(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого предоставьте `--log-to-stderr` и перенаправите stderr по мере необходимости.)\n\n#### `--common-caches=<dir>`\n\n              \\[Дополнительно] Управляет расположением кэшированных данных на диске, которые будут сохраняться между несколькими запусками интерфейса командной строки, такими как скачанные пакеты QL и скомпилированные планы запросов. Если этот параметр не задан явным образом, по умолчанию используется каталог с именем `.codeql` в домашнем каталоге пользователя; он будет создан, если он еще не существует.\n\nДоступно с момента `v2.15.2`."}