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

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

Перенести записи закладки «Объекты» класса

Реестр объектов класса КОР Парус 8 — как перенести записи с их текстами и зависимостями и не спутать их с самими таблицами и процедурами базы.

На этой странице
  1. 01
    Реестр источника

    Записи закладки «Объекты»

  2. 02
    План

    Команды записей и их зависимостей

  3. 03
    Приёмник

    Реестр и база проверены раздельно

Пример выполнен на двух учебных базах PostgreSQL. Запись реестра HKSITE_V30_REG класса HKSiteV30 создана в приёмнике, её текст сверён запросом к обеим базам, повторный план пустой. Таблица с таким именем намеренно не переносилась.

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

У класса в Конструкторе отраслевых расширений есть закладка «Объекты» — реестр серверных объектов, которые реализуют раздел: таблиц, процедур, представлений. Каждая запись хранит наименование, вид и копию исходного текста. Эти тексты Парус использует в «Генерации сценария раздела» и «Синхронизации метаданных», поэтому в приёмнике реестр должен совпадать с разработкой.

В Holkas запись реестра — отдельный тип «Объект реестра класса» (CLO). Он переносит именно запись, а не объект базы. В учебном примере у класса HKSiteV30 в источнике есть запись о таблице HKSITE_V30_REG, в приёмнике её нет. Перенесём запись и убедимся, что таблица в базе приёмника от этого не появилась.

CLS

HKSiteV30

Класс-владелец. Его выбор раскрывает всё семейство, включая записи реестра.

CLO

HKSITE_V30_REG

Объект реестра класса — запись закладки «Объекты» с типом «Таблица», наименованием, видом и текстом создания.

TBP

Таблица базы

Сама таблица PostgreSQL — отдельный объект. В этом примере она не переносится.

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

  • 01

    Записи есть в реестре источника

    Откройте класс в Конструкторе и проверьте закладку «Объекты». Holkas переносит то, что в ней сохранено. Сам он записи не составляет и текст из таблицы или процедуры базы не читает.

  • 02

    Два подключения

    Нужны чтение источника и запись в приёмник — как настроить подключения. Перед переносом в рабочую базу подготовьте резервную копию.

  • 03

    Решение о самих объектах базы

    Таблицы, процедуры, представления и другие объекты, описанные в реестре, переносятся своими типами. Заранее решите, включать ли их в тот же перенос или они уже есть в приёмнике.

  • 04

    Записи приёмника не на исправлении

    Если запись в приёмнике захвачена для исправления другим пользователем, изменить её не получится. Попросите владельца закончить или отменить исправление в Конструкторе.

Выберите класс или одну запись

Откройте «Перенести», задайте источник и приёмник. На шаге «Объекты» во вкладке «Каталог» отметьте класс HKSiteV30 — вместе с ним в перенос попадут его записи реестра. Если нужна одна запись, перейдите на вкладку «Вручную», выберите тип «Объект реестра класса», введите имя HKSiteV30|TABLE:HKSITE_V30_REG и нажмите «Добавить». Заполните «Основание», чтобы потом узнать этот перенос в списке операций.

Адрес записи состоит из класса, типа и имени объекта. Сверьте класс: пара «тип и имя» уникальна во всём реестре базы, и одна и та же процедура не может числиться в двух классах. Если класса в приёмнике ещё нет, включите в перенос и его — запись создаётся после своего класса.

Постройте план и откройте запись

Перейдите на шаг «Параметры» и нажмите «Запустить план». На вкладке «План» найдите строку «Объект реестра класса» и откройте её. В блоке «Поля» сверьте наименование и вид объекта (0 — базовый, 1 — клиентский, 2 — полный клиентский). Если текст записи отличается от приёмника, ниже появится блок «Текст объекта» — было и стало. В блоке «Зависимости» видно, каких команд ждёт эта. Связи записи с другими записями реестра идут отдельными строками «Зависимость объекта реестра» (CLO.Dep).

Карточка команды создания объекта реестра класса HKSiteV30|TABLE:HKSITE_V30_REG
Наименование и вид записи реестра в сохранённом плане; команда ждёт создания класса. Физическая таблица этой командой не создаётся.

Текст create table в записи — содержимое реестра. Holkas сохраняет его как строку и не исполняет. Таблица в базе от этой команды не появится и не изменится.

Примените план

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

Отказ команды записи обычно означает одно из двух — объект с таким типом и именем уже числится в другом классе либо запись захвачена для исправления другим пользователем. Holkas не забирает чужую запись и не снимает захват; оба случая разобраны ниже.

Проверьте реестр и базу раздельно

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

Пустой план относится к реестру. Он не подтверждает, что таблица или процедура существует в базе и работает. «Генерацию сценария раздела» и «Синхронизацию метаданных» Holkas не запускает — эти инструменты Паруса используют перенесённые тексты позже, когда вы запустите их сами.

Записи на месте

На закладке «Объекты» класса в приёмнике есть нужные записи с тем же наименованием, видом и текстом.

Повторный план пустой

Новое сравнение того же состава не содержит команд.

Объекты базы учтены отдельно

Таблицы и процедуры перенесены своими типами либо вы осознанно оставили приёмник без них.

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

Применение отказало — объект числится в другом классе

Если процедура или таблица с таким типом и именем уже зарегистрирована в другом классе приёмника, создание записи отклоняется, и ошибка называет класс-владелец. Согласуйте, какому классу объект принадлежит на самом деле, и исправьте регистрацию средствами Конструктора. Не удаляйте чужую запись ради обхода проверки — у неё могут быть зависимости и история.

После переноса план снова показывает ту же разницу

Проверьте, не захвачена ли запись для исправления. Чужой захват не даёт изменить запись. Если захват принадлежит тому же пользователю, под которым подключён Holkas, правка может попасть в его черновик, а сравнение читает основную запись. Завершите или отмените исправление в Конструкторе и повторите перенос.

Источник на Oracle, приёмник на PostgreSQL или наоборот

Текст записи переносится как есть, без перевода на другой диалект SQL. План предупреждает об этом, когда сохраняет непустой изменившийся текст в базу другой СУБД. Перед «Генерацией сценария раздела» или «Синхронизацией метаданных» подготовьте реализацию для приёмника и загрузите её текст из его базы средствами Конструктора.

Запись перенесена, а таблицы или процедуры в базе нет

Так и должно быть. Запись реестра хранит описание и копию текста. Сам объект включите в перенос отдельно — например как таблицу или процедуру.

Запись удалили в источнике, а в приёмнике она осталась

Целая запись по отсутствию в источнике не удаляется — уберите её в Конструкторе приёмника. Иначе с зависимостями записи. Пары, которых больше нет в источнике, снимаются командами удаления «Зависимость объекта реестра»; сами записи и объекты базы при этом сохраняются.

В приёмнике нет истории изменений записи

«История изменений», «Удалённые объекты» и состояние захвата не переносятся. Изменения проходят через процедуры Паруса и создают историю уже в приёмнике, без авторов и дат источника.