Skip to main content
affpapa.org
RU EN
skill CX Codex

db-dump-dt — Claude Code skill: dump a 1C infobase to a DT file

This skill dumps a whole 1C infobase into a single DT file: configuration plus data. Handy for backups and rollback points before an update.

Install into Claude Code · Plugin marketplace All methods and platforms ↓ 
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Open on GitHub

What db-dump-dt does

The /db-dump-dt slash command runs scripts/db-dump-dt.ps1, which drives 1cv8.exe or ibcmd.exe. You get one .dt holding the entire base: data, settings, users. If you only need the configuration, this is the wrong skill — use /db-dump-cf.

Connection details come from .v8-project.json in the project root. Name a database and the skill looks it up by id, alias or name. Leave it out and it matches the current Git branch against databases[].branches, falling back to default. The platform path is the v8path of the matched entry, otherwise the root one. When neither is set, -V8Path is skipped. No .v8-project.json at all? The skill suggests /db-list add.

A file infobase needs just -InfoBasePath; a server one needs -InfoBaseServer and -InfoBaseRef together. Credentials are optional. Extra launch keys go through -AdditionalV8Arguments or -AdditionalIbcmdArguments. The dump reads the whole base, so expect a long run on a large infobase — that is a reason to schedule it outside working hours.

What it helps with

  • back up a 1C infobase before an update
  • get a rollback point that includes data and user settings
  • dump a server infobase into one DT file
  • move a database to another machine with its data
  • run a dump from the agent without opening the configurator

Example prompts for the agent

  • /db-dump-dt dev backup.dt
  • /db-dump-dt — dump the default database, name the file after the base and date
  • Back up the MyApp_Dev infobase to C:\backup\base.dt

How to install db-dump-dt

1Plugin marketplace

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

This installs the whole 1c-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-dump-dt -a claude-code

3Manually: put the files in place

~/.claude/skills/db-dump-dt/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/db-dump-dt/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about db-dump-dt

How do I install db-dump-dt in Claude?

Through the marketplace: run /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then /plugin install 1c-skills@cc-1c-skills. Alternatively, npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-dump-dt -a claude-code.

What does db-dump-dt do?

It dumps a 1C infobase in full to a DT file: configuration along with data, settings and users. That snapshot works as a backup or a rollback point.

How is db-dump-dt different from db-dump-cf?

/db-dump-cf exports the configuration only, with no data. /db-dump-dt captures the whole base, so it fits backups rather than metadata exports.

Source text

SKILL.md · MIT 
---
name: db-dump-dt
description: Выгрузка информационной базы 1С в DT-файл (вся база — конфигурация + данные). Используй когда нужно выгрузить информационную базу, выгрузить архив базы, сделать бэкап, выгрузить dt
argument-hint: "[database] [output.dt]"
allowed-tools:
  - Bash
  - Read
  - Glob
  - AskUserQuestion
---

# /db-dump-dt — Выгрузка информационной базы в DT-файл

Выгружает информационную базу целиком (конфигурация **+ данные**) в DT-файл — полный снимок ИБ.

> В отличие от `/db-dump-cf` (только конфигурация), `.dt` содержит **всю базу**: данные,
> настройки, пользователей. Это бэкап/точка отката, а не выгрузка метаданных.

## Usage

```
/db-dump-dt [database] [output.dt]
/db-dump-dt dev backup.dt
/db-dump-dt                          — база по умолчанию, имя файла по базе и дате
```

## Параметры подключения

Прочитай `.v8-project.json` из корня проекта и разреши базу:
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
4. Если ветка не совпала — используй `default`
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
Если файла нет — предложи `/db-list add`.
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-dt.ps1" <параметры>
```

### Параметры скрипта

| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-OutputFile <путь>` | да | Путь к выходному DT-файлу |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |

> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`

## Примеры

```powershell
# Выгрузка ИБ (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-dt.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\base.dt"

# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-dt.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "base.dt"
```

## Связанные навыки

- `/db-load-dt` — загрузка ИБ из DT (обратная операция)
- `/db-dump-cf` — выгрузка только конфигурации (без данных)
- `/db-create` — создать новую базу (в т.ч. из DT-шаблона)

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Similar skills

SKILL.md skills catalog →
convex-backup convex Sets up Convex snapshot exports and runs a restore drill into a throwaway preview, so you find out whether recovery actually works. CX Codex +1 35,900installs databases mrgoonie A skill that bundles MongoDB and PostgreSQL references: schemas, queries, indexes, migrations, backups and admin tasks. CX Codex +1 435installs postgresql devops-skills Guides PostgreSQL database administration, streaming replication, backups, and performance tuning. Useful when deploying or optimizing database instances. CX Codex +1 419installs mysql devops-skills A skill that walks your agent through MySQL and MariaDB work: install, InnoDB tuning, backups, source-replica replication. Useful when the agent touches a live database. CX Codex +1 350installs postgres-pro VoltAgent Community A PostgreSQL subagent for query tuning, replication design, backups, and database troubleshooting. Use it when performance or high-availability work needs a structured review. 897installs supabase-backup-manager davila7 A Claude slash command that runs Supabase database backups: takes snapshots, validates restores and manages the schedule. 812installs

From the same set14

epf-build Builds a 1C external data processor into an EPF or ERF file from XML sources, checking modules before the build. CX Codex 47installs erf-init Generates the minimal XML source set for a 1C external report: a root metadata file and the report directory. Useful when you start a new report and don't want to build the skeleton by hand. CX Codex 46installs form-compile Compiles a 1C managed form into Form.xml from a JSON definition or straight from object metadata. Useful when you need a form from scratch or a standard one. CX Codex 45installs web-publish Writes default.vrd, edits httpd.conf and starts Apache so a 1C infobase opens in the browser. Running it again just refreshes the config. CX Codex 44installs db-update Applies changes from the main 1C configuration to the database configuration. Useful when loading XML or a Git branch and applying the update are separate steps. CX Codex 44installs web-unpublish Deletes a 1C web publication from Apache: the block in httpd.conf and the publish/{appname} directory. Useful when a database should stop being reachable over the web. CX Codex 43installs db-load-cf Loads a 1C configuration from a binary CF file into an infobase. Useful when restoring a database from a backup or standing up a config on a test server. CX Codex 43installs meta-decompile Reads a 1C metadata object XML and emits a compact JSON draft in the meta-compile format. Useful when a new object is easier to build from an existing one than to write from scratch. CX Codex 36installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor