Выгрузка базы 1С:Предприятие в файл DT

Задача с типом Выгрузка базы 1С:Предприятие в файл DT выгружает информационную базу 1С:Предприятия в файл DT. Конфигуратор 1С запускает служба QmbService на своей машине; перед выгрузкой задача может отключить пользователей от базы. Поддерживаются файловые и клиент-серверные базы.

Задача выполняется в составе сценария или по команде Выполнить задачу из контекстного меню списка серверов. MS SQL не задействован в выгрузке, поэтому задачу можно включать в состав сценария на любом сервере MS SQL. Однако рекомендуется помещать задачу выгрузки в DT именно в те сценарии, которые обеспечивают обслуживание этой серверной базы. Это позволит исключить конфликты между операциями обслуживания и выгрузки.

Требования к машине службы QmbService

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

толстый клиент 1С:Предприятия (1cv8.exe) той же версии, что и сервер 1С;
для отключения пользователей клиент-серверной базы нужны утилиты ras.exe и rac.exe той же версии. Для установки в инсталляторе платформы 1С необходимо включить компонент «Администрирование сервера 1С:Предприятия» — сам сервер 1С при этом не устанавливается;
лицензия 1С, доступная учётной записи службы: программная «для всех пользователей компьютера», сетевой ключ или лицензия, которую выдаёт сервер 1С;
сетевой доступ к серверу 1С: к агенту кластера (по умолчанию порт 1540), менеджеру кластера (1541) и рабочим процессам (по умолчанию 1560–1591);
пользователь 1С с правами администратора информационной базы, а если в кластере заведены администраторы, — и администратор кластера;
для файловой базы — доступ к каталогу базы. Для принудительного завершения работы пользователей (жёсткое отключение от файлов) каталог должен находиться на машине службы, а учётной записи службы нужны права локального администратора.

Держать сервер администрирования ras на сервере 1С не обязательно: по умолчанию QMB запускает свой ras на машине службы на время выгрузки.

Вкладка «Информационная база»

Клиент-серверная / Файловая — вид информационной базы. Для клиент-серверной базы задаются Сервер 1С (имя или IP-адрес), Порт менеджера кластера (по умолчанию 1541) и Имя базы в кластере. Для файловой — Каталог базы, в котором лежит файл 1Cv8.1CD, локальный или сетевой.

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

Платформа 1С — путь к папке или 1cv8.exe требуемой версии платформы 1С. В списке — платформы, установленные на машине службы; Обновить заново запрашивает их у службы. Вы также можете вписать путь вручную.

Пути на всех вкладках указываются так, как они видны с машины службы QmbService.

Вкладка «Файл выгрузки»

Папка — папка для файла DT, локальная или сетевая. Если папки нет, служба её создаёт.

Имя файла — имя файла DT, по умолчанию %infobase%_%timestamp%.dt. Существующий файл с тем же именем перезаписывается. Файл пишется под временным именем и получает итоговое только после успешной выгрузки. Допустимы макросы:

Макрос	Что подставляется
%infobase%	имя информационной базы: у клиент-серверной — имя в кластере, у файловой — имя каталога базы
%date%	дата в формате ГГГГ-ММ-ДД
%timestamp%	дата и время в формате ГГГГ-ММ-ДД_ЧЧММСС
%date2%	дата в формате ДД-ММ-ГГГГ
%timestamp2%	дата и время в формате ДД-ММ-ГГГГ_ЧЧММСС
%weeknumber%	номер недели в году

Доступ к сетевым папкам — учётная запись, от имени которой служба обращается к сетевым путям папки выгрузки и каталога файловой базы.

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

Вкладка «Отключение пользователей»

Для выгрузки DT конфигуратору требуется монопольный доступ к базе. Флаг Отключать пользователей перед выгрузкой позволяет настроить параметры принудительного отключения пользователей. Состав полей вкладки зависит от вида базы — клиент-серверная или файловая.

Клиент-серверная база

Отключение пользователей клиент-серверной базы

Пользователей отключает кластер серверов 1С:

Задача устанавливает блокировку начала сеансов, которая вступает в силу через заданное время ожидания. Типовые конфигурации предупреждают пользователей и сами завершают их сеансы.
В процессе ожидания выполняется проверка сеансов. Как только сеансов не останется, начинается выгрузка. Оставшиеся сеансы — в том числе конфигуратора, COM-соединений и фоновых заданий — завершаются принудительно.
После выгрузки, при любом её исходе, возвращается прежнее состояние блокировки БД (блокировка начала сеансов и регламентных заданий).

Ждать самостоятельного выхода, мин — сколько ждать, пока пользователи завершат работу сами; 0 — отключать сразу.

Сообщение пользователям — текст, который пользователи увидят при блокировке и при завершении сеанса.

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

Блокировать регламентные задания на время выгрузки — на время выгрузки регламентные задания запрещаются, после выгрузки прежний режим возвращается.

Запускать сервер администрирования (ras) на машине службы QmbService — служба запускает свой ras на свободном порту и останавливает его после выгрузки. Адрес агента кластера подставляется по серверу и порту с вкладки Информационная база: порт агента на единицу меньше порта менеджера.

Использовать работающий ras — адрес уже запущенного ras в формате сервер:порт, например зарегистрированного на сервере 1С (стандартный порт 1545).

Администратор кластера, Пароль — заполняются, если в кластере заведены администраторы.

Если служба QmbService остановится во время выгрузки, прежнее состояние блокировки вернётся при её следующем запуске. Кроме того, блокировка ставится с ограниченным сроком действия и снимется сама.

Файловая база

Отключение пользователей файловой базы

Для файловой БД используются две возможности отключения пользователей:

Мягкое — путём запуска конфигурации в пользовательском режиме с параметром /C"ЗавершитьРаботуПользователей" (параметр должна поддерживать конфигурация) с ожиданием выхода пользователей. Отключение не гарантируется на 100%.
Жёсткое — путём отключения пользователей от файлов БД. Доступно, только если файлы БД располагаются на машине службы QmbService.

Отключение выполняется по следующему алгоритму:

Запуск 1С с параметрами — установка блокировки базы и режима завершения работы пользователей.
Ожидание выхода пользователей с попыткой выгрузки БД каждые 30 секунд, но не дольше, чем Ждать выхода пользователей, мин. Если к концу ожидания команда не завершилась по каким-либо причинам, её процесс принудительно снимается.
По истечении времени ожидания, если остались подключения, выполняется принудительное (жёсткое) отключение пользователей от файлов БД (если включено По истечении ожидания принудительно завершить работу пользователей) и выполняется выгрузка БД в режиме конфигуратора.
После выгрузки запустить — выполняется запуск 1С:Предприятия в пользовательском режиме для снятия блокировки. Выполняется при любом исходе выгрузки.

В командах можно использовать макросы, значения берутся с вкладки Информационная база:

Макрос	Что подставляется
%platform%	каталог выбранной платформы 1С
%infobase%	каталог базы
%user%	пользователь 1С
%password%	пароль пользователя 1С, в журнале он скрыт

Кнопки По умолчанию подставляют команды для типовых конфигураций:

отключение: "%platform%\1cv8.exe" ENTERPRISE /F"%infobase%" /N"%user%" /P"%password%" /C"ЗавершитьРаботуПользователей"
разблокировка: "%platform%\1cv8.exe" ENTERPRISE /F"%infobase%" /N"%user%" /P"%password%" /UCКодРазрешения /C"РазрешитьРаботуПользователей"

Разные версии БСП могут принимать различные параметры для установки режима блокировки пользователей. Убедитесь, что конфигурация принимает указанные параметры. Настоятельно рекомендуется выполнять предварительное тестирование на копии БД.

Для завершения работы пользователей мягким способом типовым конфигурациям требуется около 2 мин. Если поле Запустить 1С с параметрами пустое, команда не выполняется. Пока идёт ожидание, задача периодически пробует выгрузить БД.

Код разрешения из команды разблокировки (ключ /UC) конфигуратор использует и для входа в заблокированную базу, поэтому он должен совпадать с кодом, которым блокирует команда отключения. У типовых конфигураций, если код не задан явно, это КодРазрешения.

Принудительное завершение доступно, только если каталог базы расположен на машине службы, и требует там прав локального администратора.

При принудительном завершении пользователи не получают предупреждения, несохранённые данные теряются.

Проверка параметров

Проверка параметров выгрузки

Проверить... — выполняется проверка параметров задачи на стороне службы QmbService: платформы 1С, утилит ras и rac, доступа к кластеру и базе, прав администратора базы, текущих сеансов, процессов, которые держат файлы файловой базы, команд файловой базы с подставленными макросами, папки выгрузки и свободного места на диске.

Вывод конфигуратора при выгрузке базы записывается в журнал обслуживания и показывается в окне выполнения.

Смотрите также

Задача

Сценарий

Меню Задачи

Меню Журнал обслуживания

Общая информация

Часто задаваемые вопросы