Как узнать идентификатор базы 1С на сервере

Идентификатор информационной базы (GUID) нужен администратору при настройке публикации на веб-сервере, подключении через COM-соединение, написании скриптов администрирования, работе с консолью кластера и диагностике проблем с сеансами. В клиент-серверном варианте 1С каждая база, зарегистрированная в кластере, имеет уникальный UUID, который не совпадает с именем базы и не виден в обычном списке баз стартера.

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

Важно различать два разных идентификатора: GUID базы в кластере серверов 1С и внутренний идентификатор информационной базы, который хранится в самой базе и используется, например, при обменах данными. Они не совпадают, и путаница между ними — частая причина ошибок при настройке интеграций.

Что такое идентификатор базы и где он используется

При регистрации информационной базы в кластере серверов 1С ей присваивается уникальный идентификатор в формате UUID — строка вида «a1b2c3d4-5678-90ab-cdef-1234567890ab». Этот идентификатор генерируется автоматически и не зависит от имени базы в кластере или имени базы данных в СУБД. Даже если переименовать базу, GUID останется прежним.

Идентификатор используется во внутренних механизмах платформы: привязка сеансов и соединений к конкретной базе, журнал регистрации на уровне кластера, блокировки, фоновые задания. Администратору GUID нужен при вызове методов COM-соединителя V83.COMConnector, при работе с утилитой rac, при настройке публикации в default.vrd и при разборе технологического журнала.

Способ 1. Консоль кластера серверов 1С

Самый наглядный способ — оснастка «Администрирование серверов 1С Предприятия». Она устанавливается вместе с сервером 1С и доступна на машине, где развёрнут кластер, либо на компьютере администратора при сетевом доступе к агенту сервера.

1. 1
   Откройте оснастку «Администрирование серверов 1С Предприятия» (1CV8 Servers.msc).
2. 2
   Разверните нужный сервер, затем ветку «Кластеры» → локальный кластер → «Информационные базы».
3. 3
   Найдите базу по имени в списке справа.
4. 4
   Дважды щёлкните по базе или откройте контекстное меню → «Свойства».
5. 5
   Скопируйте значение поля с идентификатором (UUID).

Если список баз пуст, хотя базы точно зарегистрированы, проверьте, что вы подключились к правильному кластеру (порт агента по умолчанию 1540, рабочие порты 1560–1591) и что у вашей учётной записи есть права администратора кластера или базы. Без административных прав оснастка покажет структуру, но свойства могут быть недоступны.

Ограничение способа: оснастка работает только в Windows. Для сервера на Linux её можно запустить на отдельной Windows-машине и подключиться к кластеру по сети, указав адрес сервера при добавлении в консоль.

Способ 2. Утилита командной строки rac

Утилита rac входит в состав сервера 1С и лежит в каталоге bin соответствующей версии платформы. Она позволяет получить список баз с идентификаторами без графического интерфейса, что удобно для скриптов и удалённого администрирования по SSH.

"C:\Program Files\1cv8\8.3.22.1709\bin\rac.exe" infobase summary list --cluster=<GUID-кластера> --cluster-user=Администратор --cluster-pwd=пароль

Сначала получите GUID кластера командой «rac cluster list», затем запросите список баз. В выводе для каждой базы будет строка «infobase» со значением UUID — это и есть искомый идентификатор. Команда «rac infobase info --infobase=GUID» покажет подробные свойства конкретной базы.

Типичная ошибка — путать GUID кластера и GUID базы: в параметре --cluster указывается идентификатор кластера, а в --infobase — идентификатор базы. Если перепутать, утилита вернёт ошибку о том, что объект не найден.

Способ 3. Файл списка баз и реестр кластера

Кластер хранит перечень зарегистрированных баз в файле 1CV8Clst.lst, который находится в каталоге служебных данных кластера (обычно «C:\Program Files\1cv8\srvinfo» на Windows или /home/usr1cv8/.1cv8/1C/1cv8 на Linux). Файл текстовый, его можно открыть обычным редактором.

Внутри для каждой базы указаны имя, GUID, параметры подключения к СУБД и другие настройки. Найдите имя нужной базы и скопируйте идущий рядом UUID. Способ работает даже когда сервер остановлен, но требует прямого доступа к файловой системе сервера.

Способ 4. Программно: COM-коннектор и встроенный язык

Если нужно получить GUID из скрипта или другой базы 1С, используйте COM-соединение с агентом сервера. Последовательность такая: подключиться к агенту (COM-объект V83.COMConnector), получить агент через ConnectAgent, получить список кластеров GetClusters, затем рабочий процесс и перебрать информационные базы методом GetInfoBases. У каждого объекта базы есть свойство с UUID.

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

Как проверить, что идентификатор правильный

После получения GUID убедитесь, что он соответствует именно той базе, которая вам нужна. Самый надёжный способ — сопоставить в консоли кластера или выводе rac три параметра: имя базы в кластере, имя базы данных в СУБД и GUID. Если все три относятся к нужной системе, идентификатор верный.

Дополнительная проверка — выполнить «rac infobase info» с полученным GUID и сверить описание, имя базы данных и сервер СУБД в выводе с ожидаемыми значениями. Это исключает ошибку копирования и перепутывание похожих баз (например, рабочей и тестовой копии).

Частые вопросы