К статье
Практический материал

Администрирование · 10 мин

Как работать с консолью 1С: практическое руководство

Как открыть и использовать консоль администрирования серверов 1С, консоль запросов и командную строку: типовые задачи, ошибки и меры безопасности.

Термин «консоль 1С» используется в трёх разных смыслах, и путаница между ними — частая причина ошибок. Первый вариант — оснастка «Администрирование серверов 1С:Предприятия», которая устанавливается вместе с сервером и позволяет управлять кластером: базами, сеансами, соединениями и рабочими процессами. Второй — консоль запросов, обработка для режима «Предприятие», в которой разработчики и аналитики пишут и проверяют запросы на встроенном языке запросов. Третий — командная строка операционной системы, через которую платформа запускается с параметрами для пакетных операций.

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

Все три инструмента работают с реальными данными, поэтому базовое правило одно: любые эксперименты выполняйте на копии базы. Особенно это касается консоли администрирования, где одна команда может принудительно завершить сеансы всех пользователей, и консоли запросов в режиме изменения данных.

Консоль администрирования серверов 1С

Оснастка устанавливается вместе с компонентом «Сервер 1С:Предприятия» и находится в меню «Пуск» в папке платформы. Если сервер развёрнут на Linux, оснастку можно установить на отдельной Windows-машине и подключаться к серверу удалённо по сети — для этого агент сервера должен быть доступен по стандартному порту (по умолчанию 1540).

После первого запуска консоль пуста: нужно зарегистрировать центральный сервер. Через контекстное меню добавьте сервер, указав его сетевое имя или IP-адрес. Далее в дереве появятся кластеры, а внутри — информационные базы, сеансы, соединения и рабочие процессы. Если подключение не устанавливается, проверьте, запущена ли служба агента сервера, и не блокирует ли брандмауэр порты диапазона 1540–1591.

Первое подключение к серверу
  1. 1
    Убедитесь, что служба «Агент сервера 1С:Предприятия» запущена на сервере
  2. 2
    Откройте оснастку «Администрирование серверов 1С:Предприятия»
  3. 3
    В контекстном меню выберите добавление центрального сервера и укажите его имя
  4. 4
    Разверните ветку кластера и проверьте, что отображаются информационные базы
  5. 5
    Откройте список сеансов и убедитесь, что видны активные подключения

Управление сеансами и блокировка базы

Самая частая операция — завершение зависшего сеанса. В списке сеансов видны пользователь, компьютер, время начала и активность. Зависший сеанс обычно не проявляет активности длительное время, при этом пользователь уже закрыл программу. Сеанс удаляется через контекстное меню. Перед удалением убедитесь, что это действительно «мёртвый» сеанс: принудительное завершение активной работы приведёт к потере несохранённых данных пользователя.

Для регламентных работ используется блокировка сеансов в свойствах информационной базы. Там же задаётся сообщение, которое увидят пользователи, и код разрешения — строка, с которой можно войти в заблокированную базу через параметр запуска. Не забудьте снять блокировку после завершения работ: это типичная забывчивость, из-за которой утром пользователи не могут войти в систему.

Работа с консолью запросов

Консоль запросов — это внешняя обработка (файл с расширением .epf), которую открывают в режиме «Предприятие» через меню «Файл — Открыть». Готовые варианты входят в состав типовых инструментов разработчика, также существуют открытые реализации. Важно понимать: консоль запросов — не штатный элемент конфигурации, а вспомогательный инструмент, поэтому её наличие и внешний вид зависят от используемой версии обработки.

Основной сценарий — отладка запроса перед вставкой в код. Текст запроса пишется в редакторе, параметры задаются в отдельной таблице, результат выводится в виде таблицы или дерева. Это позволяет проверить корректность выборки, соединений и группировок до того, как запрос попадёт в отчёт или процедуру. Многие версии консоли показывают также время выполнения, что помогает оценить производительность.

Типичные приёмы отладки

Если запрос в программе работает не так, как ожидалось, скопируйте его текст в консоль и подставьте реальные значения параметров. Часто оказывается, что проблема не в запросе, а в параметре: например, передаётся пустая ссылка или дата без времени. Сравнение результата в консоли с результатом в программе — самый быстрый способ локализовать ошибку.

Для сложных запросов разбивайте текст на части: сначала проверьте выборку из одной таблицы, затем добавляйте соединения и условия по одному. Так проще найти место, где данные «теряются» — обычно это левое соединение с условием в секции ГДЕ, которое фактически превращает его во внутреннее.

Командная строка платформы

Платформа 1С поддерживает запуск с параметрами командной строки, что открывает возможности автоматизации: пакетное обновление конфигурации, выгрузка и загрузка баз, запуск обработок по расписанию. Исполняемый файл конфигуратора — 1cv8.exe, тонкого клиента — 1cv8c.exe, они находятся в каталоге bin установленной версии платформы.

bat
"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" DESIGNER /F"D:\Bases\Trade" /N"Администратор" /P"пароль" /DumpIB"D:\Backup\trade.dt"

В примере выше платформа запускается в режиме конфигуратора, подключается к файловой базе по указанному пути и выполняет выгрузку в файл формата .dt. Аналогичные команды используются для загрузки (/RestoreIB), обновления конфигурации базы данных (/UpdateDBCfg) и других операций. Точный список параметров зависит от версии платформы и приведён в документации.

При автоматизации храните пароли с осторожностью: параметр /P передаёт пароль в открытом виде, и он может попасть в логи планировщика задач или историю команд. По возможности используйте аутентификацию операционной системы или ограничьте доступ к файлам скриптов на уровне прав NTFS.

Как выбрать нужный инструмент

Маршрут решения

Как выбрать действие

Нужно завершить зависший сеанс или заблокировать базуИспользуйте консоль администрирования серверов
Нужно проверить или отладить запрос к даннымОткройте консоль запросов в режиме «Предприятие»
Нужно автоматизировать выгрузку, обновление или запуск по расписаниюИспользуйте командную строку с параметрами платформы
Нужно изменить структуру метаданныхРаботайте в конфигураторе — консоль для этого не предназначена

Граница между инструментами простая: консоль администрирования управляет инфраструктурой (сеансами, процессами, блокировками), консоль запросов работает с данными и их выборкой, командная строка — со сценариями запуска. Пытаться решить задачу «не своим» инструментом — типичный источник лишней работы: например, искать зависший сеанс через скрипты, когда он виден в оснастке одним щелчком.

Частые ошибки и ограничения

Типичные ошибки
01
Завершение активного сеанса вместо зависшего — пользователь теряет несохранённые данные
02
Забытая блокировка базы после обновления — пользователи не могут войти
03
Пароль в командной строке в открытом виде — риск утечки через логи и планировщик
04
Запуск изменяющих запросов в рабочей базе без копии — необратимая порча данных
05
Подключение оснастки к серверу другой версии платформы — ошибки несовместимости

Отдельно стоит помнить про версии платформы. Оснастка администрирования должна соответствовать версии сервера: консоль от одного релиза может некорректно работать с сервером другого. Если на одной машине стоит несколько версий платформы, проверяйте, какую именно оснастку вы открываете — ярлыки в меню «Пуск» группируются по версиям.

Контрольные точки

Как проверить результат

Подключение к серверу
Норма

В дереве видны кластер, базы и сеансы

Тревожный признак

Ошибка соединения или пустое дерево — проверяйте службу агента и порты

Завершение сеанса
Норма

Сеанс исчез из списка после обновления

Тревожный признак

Сеанс появляется снова — пользователь переподключается, нужна блокировка

Запрос в консоли
Норма

Результат совпадает с ожидаемой выборкой

Тревожный признак

Пустой результат или лишние строки — проверяйте параметры и соединения

Пакетная команда
Норма

Код возврата 0, файл результата создан

Тревожный признак

Код возврата отличен от 0 — смотрите текст ошибки в выводе

FAQ

Консоль администрирования не видит сервер. Что проверить в первую очередь?

Убедитесь, что служба «Агент сервера 1С:Предприятия» запущена, затем проверьте доступность порта агента (по умолчанию 1540) с машины, где открыта консоль. Также сверьте версии: оснастка и сервер должны быть совместимы по версии платформы.

Можно ли работать с консолью запросов без прав администратора?

Для чтения данных достаточно обычных прав пользователя на соответствующие объекты — консоль выполняется в контексте вашей учётной записи. Однако для открытия внешней обработки может потребоваться отключённый режим защиты от опасных действий, что обычно настраивает администратор.

Чем консоль запросов отличается от конструктора запросов в конфигураторе?

Конструктор помогает составить текст запроса визуально, но не показывает результат на реальных данных. Консоль запросов выполняет запрос и выводит выборку, позволяя задавать параметры и оценивать время выполнения.

Как безопасно автоматизировать выгрузку базы по расписанию?

Используйте пакетный режим конфигуратора с командой /DumpIB и планировщик задач Windows. Запускайте задачу от отдельной учётной записи с минимально необходимыми правами, ограничьте доступ к файлу скрипта и регулярно проверяйте, что файлы выгрузки действительно создаются.

Что делать, если сеанс завершили, а пользователь снова подключается?

Завершение сеанса не запрещает новый вход. Чтобы остановить подключения на время работ, установите блокировку сеансов в свойствах информационной базы в консоли администрирования и снимите её после завершения.

Можно ли отменить действие, выполненное в консоли администрирования?

Нет, операции вроде завершения сеанса необратимы: несохранённые данные пользователя будут потеряны. Поэтому перед завершением сеанса проверяйте его активность и по возможности предупреждайте пользователя.

Итог

Что важно запомнить

Определите задачу и выберите подходящий инструмент: консоль администрирования для кластера и сеансов, консоль запросов для отладки выборок, командную строку для автоматизации. Работайте с копией базы при рискованных операциях, не храните пароли в открытом виде и всегда снимайте блокировку после регламентных работ.