From 7820f10856c0bf414d445fb9ea6cf5ff1bd19859 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D1=80=D0=B8=D0=B3=D0=BE=D1=80=D0=B8=D0=B9=20=D0=A1?= =?UTF-8?q?=D0=B0=D1=84=D1=80=D0=BE=D0=BD=D0=BE=D0=B2?= Date: Tue, 21 Jul 2026 18:52:07 +0000 Subject: [PATCH] Update README.md --- README.md | 45 +++++++++++++++++++++++++++++++++++++++------ 1 file changed, 39 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 1615570..a51858f 100644 --- a/README.md +++ b/README.md @@ -1369,9 +1369,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed 2. semi_auto — основная миграция вручную, дельта-синхронизация автоматическая 3. auto — полностью автоматическая непрерывная миграция +

-**Команды управления:** +### Команды управления: * migration start [db] [collection] — запуск миграции * migration status [task_id] — статус миграции @@ -1382,8 +1383,9 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed * migration queue — состояние очереди изменений
+
-**Компоненты системы** +### Компоненты системы | Компонент | Описание | Настройки | |-----------|----------|-----------| @@ -1394,7 +1396,9 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | **Checkpoint & Resume** | Чекпоинты для возобновления миграции | `checkpoint_interval_sec` | | **Delta Sync** | Синхронизация изменений после основной миграции | `interval_sec, max_lag_sec` | | **Validation** | Проверка целостности данных | `sample_percent, max_errors` | +--- +

### Жизненный цикл миграции @@ -1407,6 +1411,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | **DELTA_SYNC** | Синхронизация изменений, произошедших во время миграции | Автоматически после синхронизации | `migration pause`, `migration status` | | **VALIDATING** | Проверка целостности данных (контрольные суммы) | Автоматически после валидации | `migration status` | | **COMPLETED** | Миграция успешно завершена | — | `migration validate`, `migration list` | +--- + +
+
### Обработка исключительных состояний @@ -1420,6 +1428,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | **DELTA_SYNC** | Критическая ошибка | → **FAILED** | Сетевой сбой, отказ узла, таймаут | | **PREPARING** | Критическая ошибка | → **FAILED** | Недоступность источника или цели | | **VALIDATING** | Ошибка валидации | → **COMPLETED** | Ошибки логируются, миграция завершается | +--- + +
+
### Таблица переходов состояний @@ -1441,6 +1453,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | COMPLETED | — | — | | FAILED | `migration resume` (после исправления) | MIGRATING | | FAILED | `migration cancel` | FAILED | +--- + +
+
### Временные метрики этапов @@ -1451,7 +1467,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | **DELTA_SYNC** | Зависит от количества изменений | Интенсивность записи во время миграции, `interval_sec` | | **VALIDATING** | 5-30% от времени миграции | `sample_percent`, размер документов | | **PAUSED** | Неограниченно | Время до возобновления пользователем | +--- +
+
### Поток данных @@ -1465,6 +1484,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | 6 | Дельта-синхронизация | CDC изменения | | 7 | Валидация | SHA-256 контрольные суммы | | 8 | Завершение | Обновление статуса | +--- + +
+
**Режимы работы** @@ -1473,6 +1496,10 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | **manual** | Полностью ручное управление | Нет | | **semi_auto** | Основная миграция вручную, дельта автоматическая | Частичная | | **auto** | Полностью автоматическая непрерывная миграция | Полная | +--- + +
+
**Пример конфигурации** @@ -1513,6 +1540,7 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed max_errors = 100 ```
+
### Команды управления миграцией @@ -1531,9 +1559,11 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | `migration config` | Вывод текущей конфигурации мигратора из config.toml | `migration config` | | `migration queue` | Отображение состояния очереди изменений (размер, LSN) | `migration queue` | | `migration validate ` | Запуск валидации данных для завершённой миграции | `migration validate mig_1734567890_dc-primary` | - --- +
+
+ ### Статусы миграции | Статус | Описание | Индикатор | Возможные действия | @@ -1546,9 +1576,11 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | `completed` | Миграция успешно завершена, все данные перенесены | 🟢 Зелёный | `migration validate`, `migration list` | | `failed` | Миграция завершилась с ошибкой, требуется вмешательство | 🔴 Красный | `migration status` (просмотр ошибки), `migration resume` (после исправления), `migration cancel` | | `paused` | Миграция приостановлена пользователем | 🟠 Оранжевый | `migration resume`, `migration cancel` | - --- +
+
+ ### Метрики мониторинга | Метрика | Описание | Единица измерения | Способ получения | @@ -1568,8 +1600,9 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | `failed_docs` | Количество документов с ошибкой миграции | количество | `migration status` | | `elapsed_time` | Время, прошедшее с начала миграции | секунды | `migration status` | | `validation_errors` | Количество ошибок валидации | количество | `migration status` | - --- +
+
### Обработка ошибок @@ -1585,7 +1618,7 @@ Idle → Preparing → Migrating → Delta Sync → Validating → Completed | **Ошибка валидации** | Контрольная сумма документа не совпадает | Логирование ошибки, продолжение миграции | Проверить целостность данных, при необходимости перезапустить миграцию | | **Прерывание пользователем** | Пользователь выполнил `migration cancel` | Немедленная остановка, переход в статус `failed` | — | | **Таймаут дельта-синхронизации** | Задержка превысила `max_lag_sec` | Увеличение интервала или ручная синхронизация | Настроить `interval_sec` и `max_lag_sec`, проверить пропускную способность канала | - +--- **Гарантии целостности**