Holkas
Написать в поддержку Поддержка

Задача / по шагам

Перенос завершился ошибкой, а часть изменений уже в базе

Операция неуспешна, но некоторые команды выполнились. Разберём, что записано в приёмник, что пропущено и почему, как устранить причину и довести перенос новым планом.

На этой странице
  1. 01
    Исходы команд

    Что выполнено, что нет

  2. 02
    Причина отказа

    Первая ошибка и её исправление

  3. 03
    Новый план

    Только оставшиеся отличия

Учебный прогон на двух базах PostgreSQL с Парусом: переносим две функции, одна из которых читает таблицу, отсутствующую в приёмнике. Отказ намеренный; режим одной транзакции выключен.

Учебный пример

Вы применили план, операция завершилась ошибкой, но часть команд успела выполниться: в приёмнике появилось одно и не появилось другое. Нужно понять, что записано на самом деле, устранить причину отказа и довести перенос — не возвращая базу назад и не повторяя уже сделанное.

Какие команды выполняются, а какие пропускаются

В обычном режиме Holkas выполняет команды по очереди, без общей транзакции. Когда база отказывает в одной команде, происходит три вещи:

  • Ошибка записывается в исход этой команды.
  • Пропускаются оставшиеся команды того же объекта и все команды, которые ждут упавшую по зависимостям плана. Например, после отказа в создании таблицы не запускается создание её внешнего ключа.
  • Остальные команды выполняются дальше.

Итог операции неуспешный, но выполненные изменения остаются в базе. Поэтому после ошибки приёмник нельзя считать нетронутым.

Исход командыЧто произошло в приёмнике
исполненоИзменение записано и осталось.
вне планаКоманды не было в сохранённом плане, она понадобилась при применении и исполнена.
не удалосьБаза отказала. Причина — в сообщении об ошибке и в журнале.
пропущеноКоманда не запускалась; в пояснении — какая команда её остановила.
не лечитсяИзвестный отказ Паруса, который повтор не исправит. Остальному не мешает.
исход неизвестенФиксация не подтвердилась. Состояние покажет только новый план.

Журнал подводит итог ещё и по объектам: применено, частично, не применено, без изменений. У одного объекта бывает несколько команд, поэтому «частично» означает, что из команд объекта выполнилась только часть, а счётчики объектов и команд не совпадают.

Чем отличается режим одной транзакции

Для приёмника PostgreSQL на шаге «Параметры» можно включить «Перенести одной транзакцией». Тогда отказ любой команды откатывает все изменения плана, и частичного результата в базе не остаётся.

Обычный режимОдна транзакция (PostgreSQL)
Успешные команды после отказаОстаются в базеОткатываются; в исходе «Откачена»
Команды после упавшейНезависимые выполняютсяНе запускаются; в исходе «Не выполнялась»
Что делать дальшеРазобрать исходы, построить новый планУстранить причину, повторить весь план

Откат не отменяет записи журналов Паруса и внешние эффекты скриптов. Для Oracle такого режима нет. Пример отката и повтора.

JFP

hksite_v30_good

Независимая функция. Возвращает 30.

JFP

hksite_v30_needs_table

Функция на LANGUAGE sql. Читает таблицу, которой нет в приёмнике.

TBP

hksite_v30_ready

Таблица есть в источнике, но в первый набор не включена.

Перед началом

  • 01

    Неуспешная операция применения

    У вас открыта операция с красным сообщением «Ошибка: …» — или её ID, чтобы найти её в истории. Старый план повторно не запускайте: приёмник уже изменился.

  • 02

    Режим применения

    Порядок ниже относится к обычному режиму, в котором общего отката нет. Если в шапке операции стоит метка «одной транзакцией», при отказе откатился весь план — чем это отличается.

  • 03

    Права и копия приёмника

    Для нового плана нужно чтение обеих сторон, для применения — запись в приёмник. Если результат нужно отменить целиком, понадобится резервная копия базы-приёмника, сделанная до переноса.

Как возникает частичный перенос

В наборе две функции базы PostgreSQL (JFP), в плане — две команды Create. Функция hksite_v30_needs_table написана на LANGUAGE sql и читает таблицу parus.hksite_v30_ready. PostgreSQL проверяет такое тело уже при создании. Таблицы нет ни в наборе, ни в приёмнике, и план об этом не предупреждает: Holkas не предлагает таблицу, которую читает SQL-функция. На шаге «Параметры» флажок «Перенести одной транзакцией» выключен. После «Применить» первая функция создаётся, вторая получает отказ базы.

Перед применением прочитайте SQL команд, которые обращаются к другим объектам, и сверьте, что эти объекты есть в наборе или в приёмнике. На рабочей базе намеренный отказ не повторяйте.

Прочитайте исход каждой команды

Откройте неуспешную операцию. Сообщение «Ошибка: …» называет номер команды и объект, на котором она возникла; кнопка «Показать команду» открывает эту команду. На вкладке «План» у каждой строки свой исход. «Исполнено» — изменение записано в приёмник и там осталось. «Не удалось» — база отказала; причина есть в сообщении об ошибке и в журнале. «Пропущено» — команда не запускалась, и в её пояснении назван номер команды, которая её остановила. В примере hksite_v30_good исполнена, hksite_v30_needs_table не удалась.

Одна функция выполнена, вторая завершилась ошибкой
Намеренный отказ на учебной базе: общий статус не отменяет успешную команду.

Статус операции говорит только о том, что не всё прошло. Что именно записано, видно по командам — сверьте имена и исходы по списку, включая пропущенные.

Найдите первый отказ в журнале

Нажмите «Лог». Строка «Исходы команд» даёт счётчики: исполнено, вне плана, пропущено, не удалось, не лечится, исход неизвестен. Ниже для каждого отказа есть строка «Команда N не исполнена» с ответом базы — здесь это сообщение PostgreSQL об отсутствующей таблице. Строка «Исход» считает уже объекты: применено, частично, не применено, без изменений; следом перечислены имена частично применённых и неприменённых. Исправлять нужно команду с исходом «не удалось». Пропущенные команды — её следствие, отдельной причины у них нет.

Журнал с итогом частичного применения
Журнал перечисляет фактические исходы и имя неприменённого объекта.

В обычном режиме общего отката нет. Убедитесь, что успешная функция действительно есть в приёмнике, — запросом к базе или новым планом.

Устраните причину

Причина здесь — отсутствующая таблица. Перенесите таблицу PostgreSQL (TBP) parus.hksite_v30_ready отдельной операцией и дождитесь успешного результата. Другой путь — включить таблицу в один набор с функциями: тогда команда функции на LANGUAGE sql ждёт команды таблицы своего набора, и порядок получается верным сам. Правило для SQL-функций.

Старый план не запускайте повторно: он построен для приёмника, которого уже нет. Одна из его команд выполнена.

Постройте новый план и примените оставшееся

В неуспешной операции нажмите «Повторить с изменениями» — откроется новый перенос с теми же подключениями и набором. Запустите план. Сравнение идёт с текущим состоянием приёмника, поэтому для hksite_v30_good команды уже нет. Остаётся одна команда — Create hksite_v30_needs_table. Проверьте её и нажмите «Применить».

Повтор после отдельной установки таблицы
Осталось создание функции, которая прежде не выполнилась; независимая функция уже совпадает.

Перенос таблицы создаёт её структуру, но не строки. Если функции нужны данные, перенесите их набором данных (DAT) или согласованным скриптом.

Убедитесь, что отличий не осталось

Ещё раз нажмите «Повторить с изменениями», добавьте в набор таблицу и запустите план для двух функций и таблицы. Он должен завершиться без команд. Просмотрите журнал последней операции и проверьте, что объекты есть в приёмнике.

Пустой план после устранения причины
Обе функции и таблица совпадают с источником.

Пустой план подтверждает совпадение выбранных объектов с источником. Работу доработки в Парусе проверьте отдельно.

Исходы разобраны

Про каждую команду неуспешной операции известно, записана она, отклонена базой или не запускалась.

Причина устранена

Команда, получившая отказ, выполнена в новой операции с исходом «исполнено».

Отличий не осталось

Сравнение всего набора завершается без команд, доработка проверена в Парусе.

Если что-то пошло не так

Почему план не предупредил о таблице

Holkas не предлагает таблицу, которую читает SQL-функция, если её нет в наборе. Функция на LANGUAGE sql ждёт только таблицу того же набора. Таблицу вне набора добавляйте сами или переносите заранее. О ссылках, известных из метаданных Паруса, план предупреждает — как их разобрать.

Пропущено больше команд, чем получило отказ

Так и должно быть. После отказа не запускаются оставшиеся команды того же объекта и все команды, которые ждут упавшую. В пояснении пропущенной команды сказано, на какой номер она опиралась: «Не выполнялась: в её объекте не выполнилась команда N» или «Не выполнялась: она ждёт неудавшуюся команду N». Команды, не связанные с отказом, выполняются дальше.

У команды исход «не лечится»

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

У команды «исход неизвестен»

Связь с приёмником оборвалась в момент фиксации, или база ответила на фиксацию ошибкой. Изменение могло сохраниться, а могло и нет. Постройте новый план по текущему состоянию приёмника: сохранившееся в него не попадёт, несохранившееся появится снова.

Оборвалась связь с базой-приёмником

Если соединение не удалось открыть заново, перенос останавливается сразу, без повторных попыток. Исходы выполненных команд сохраняются, остальные получают «Не выполнялась: нет связи с приёмником». Восстановите связь и постройте новый план.

Страница операции перестала обновляться

Потеря страницы не означает, что сервер остановил перенос. Восстановите связь с Holkas и откройте ту же операцию по ID в истории. Новый перенос запускайте только после того, как увидите её статус и журнал.

Нужно вернуть приёмник в исходное состояние

В обычном режиме Holkas выполненные команды не отменяет. Восстановите базу из резервной копии, сделанной до переноса. Чтобы следующий отказ откатывал всё сам, для PostgreSQL включите перенос одной транзакцией — с учётом блокировок, финализации и внешних эффектов.

В новом плане снова выполняется скрипт автора

Скрипт автора запускается заново, если у его объектов в новом плане остались команды. Проверьте, что его SQL можно выполнить повторно. Правила скрипта автора.