About db-load-dt
A skill for loading a complete 1C information base, including configuration and data, from a DT file. It is intended for developers restoring a database; because loading overwrites its contents, the workflow requires a backup and explicit confirmation first.
Key features
- 01Restore configuration and data from DT
- 02Support file and server databases
- 03Resolve databases from project settings
- 04Require backup and confirmation before loading
Use cases
- 01Restore an existing database from a DT backup
- 02Replace a database with a saved full snapshot
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/db-load-dtin Claude Code to confirm it loaded.
Bundled filesscripts/db-load-dt.ps1scripts/db-load-dt.py
Details
From the project README/db-load-dt — Загрузка информационной базы из DT-файла
Восстанавливает информационную базу целиком (конфигурация + данные) из DT-файла.
⚠️ Необратимая операция. Загрузка
.dtполностью перезаписывает базу — и конфигурацию, и все данные. Текущее содержимое базы будет потеряно. После загрузки/db-updateне нужен — конфигурация БД уже синхронна внутри снимка.
Когда НЕ использовать
- Нужно создать новую базу из
.dt→ используй/db-create(из DT-шаблона), а не загрузку в существующую. - Нужно обновить только конфигурацию (без данных) →
/db-load-cfили/db-load-xml.
Usage
/db-load-dt <input.dt> [database]
/db-load-dt backup.dt dev
Порядок действий перед загрузкой
- Предложи пользователю сначала сделать
/db-dump-dtтекущего состояния базы — это точка отката (восстановиться будет нечем, если не сохранить). - Запроси явное подтверждение: вся база (данные + конфигурация) будет перезаписана.
- Только после подтверждения выполняй загрузку.
Параметры подключения
Прочитай .v8-project.json из корня проекта и разреши базу:
- Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
defaultПлатформа —v8pathнайденной записи базы, иначе корневойv8path. Не задан ни там, ни там —-V8Pathне передавай. Если файла нет — предложи/db-list add. Если использованная база не зарегистрирована — после выполнения предложи добавить через/db-list add.
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-dt.ps1" <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> | нет | Каталог bin платформы, или полный путь к 1cv8.exe / ibcmd.exe |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Имя пользователя |
-Password <пароль> | нет | Пароль |
-InputFile <путь> | да | Путь к DT-файлу |
-JobsCount <N> | нет | Число фоновых заданий загрузки (0 = по числу процессоров) |
-UnlockCode <код> | нет | Код разблокировки (/UC), если заблокировано начало сеансов |
-AdditionalV8Arguments <список> | нет | Доп. аргументы запуска 1cv8.exe через запятую, напр. /UseHwLicenses+ |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— нужен либо-InfoBasePath, либо пара-InfoBaseServer+-InfoBaseRef
После выполнения
Если база занята (активные сеансы), загрузка не выполнится — для серверной базы можно
передать -UnlockCode; иначе освободи базу и повтори.
Примеры
# Файловая база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-dt.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\base.dt"
# Серверная база с ускорением загрузки
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-dt.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "base.dt" -JobsCount 4
Связанные навыки
/db-dump-dt— выгрузка ИБ в DT (обратная операция, точка отката перед загрузкой)/db-create— создать новую базу (в т.ч. из DT-шаблона)