mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-07-22 12:41:02 +03:00
93 lines
5.3 KiB
Markdown
93 lines
5.3 KiB
Markdown
---
|
|
name: db-load-dt
|
|
description: Загрузка информационной базы 1С из DT-файла — полная перезапись базы (конфигурация + данные). Используй когда нужно загрузить архив информационной базы, восстановить базу, загрузить dt
|
|
disable-model-invocation: true
|
|
argument-hint: <input.dt> [database]
|
|
allowed-tools:
|
|
- Bash
|
|
- Read
|
|
- Glob
|
|
- AskUserQuestion
|
|
---
|
|
|
|
# /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
|
|
```
|
|
|
|
## Порядок действий перед загрузкой
|
|
|
|
1. Предложи пользователю сначала сделать `/db-dump-dt` текущего состояния базы — это точка
|
|
отката (восстановиться будет нечем, если не сохранить).
|
|
2. Запроси **явное подтверждение**: вся база (данные + конфигурация) будет перезаписана.
|
|
3. Только после подтверждения выполняй загрузку.
|
|
|
|
## Параметры подключения
|
|
|
|
Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу:
|
|
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
|
|
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
|
|
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
|
|
4. Если ветка не совпала — используй `default`
|
|
Если `v8path` не задан — скрипт сам попытается определить платформу (`.v8-project.json` → Program Files).
|
|
Если файла нет — предложи `/db-list add`.
|
|
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
|
|
|
|
## Команда
|
|
|
|
```powershell
|
|
python ".codeassistant/skills/db-load-dt/scripts/db-load-dt.py" <параметры>
|
|
```
|
|
|
|
### Параметры скрипта
|
|
|
|
| Параметр | Обязательный | Описание |
|
|
|----------|:------------:|----------|
|
|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
|
|
| `-InfoBasePath <путь>` | * | Файловая база |
|
|
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
|
|
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
|
|
| `-UserName <имя>` | нет | Имя пользователя |
|
|
| `-Password <пароль>` | нет | Пароль |
|
|
| `-InputFile <путь>` | да | Путь к DT-файлу |
|
|
| `-JobsCount <N>` | нет | Число фоновых заданий загрузки (0 = по числу процессоров) |
|
|
| `-UnlockCode <код>` | нет | Код разблокировки (`/UC`), если заблокировано начало сеансов |
|
|
|
|
> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
|
|
|
|
## После выполнения
|
|
|
|
Если база занята (активные сеансы), загрузка не выполнится — для серверной базы можно
|
|
передать `-UnlockCode`; иначе освободи базу и повтори.
|
|
|
|
## Примеры
|
|
|
|
```powershell
|
|
# Файловая база
|
|
python ".codeassistant/skills/db-load-dt/scripts/db-load-dt.py" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\base.dt"
|
|
|
|
# Серверная база с ускорением загрузки
|
|
python ".codeassistant/skills/db-load-dt/scripts/db-load-dt.py" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "base.dt" -JobsCount 4
|
|
```
|
|
|
|
## Связанные навыки
|
|
|
|
- `/db-dump-dt` — выгрузка ИБ в DT (обратная операция, точка отката перед загрузкой)
|
|
- `/db-create` — создать новую базу (в т.ч. из DT-шаблона)
|