Oracle · Объект базы данных
Синоним даёт другое имя таблице, представлению, подпрограмме или другому объекту. При переносе доработки КОР Парус 8 он может связывать прикладную схему с объектом схемы PARUS.
JSY + Schema.NameСиноним в Oracle
Синоним — дополнительное имя объекта. В учебном примере APP.UDO_REQUEST указывает на PARUS.UDO_T_REQUEST. Обращение через первое имя использует второй объект. Строки таблицы и её определение в синониме не хранятся.
Holkas сохраняет непосредственный адрес цели. Если это ещё один синоним, цепочка не заменяется конечной таблицей. Ссылка может вести и в удалённую базу через DbLink.
JSY поддержан для Oracle. Физический синоним не переводится в объект PostgreSQL, запись реестра класса CLO или описание метода КОР. Публичный синоним адресуется как PUBLIC.ИМЯ и переносится как обычный JSY, если указывает на объект прикладной схемы. Свойства Oracle и общая форма определения — в CREATE SYNONYM.
Что входит в перенос
Папки каталога Паруса к этому типу не относятся: ни имя папки, ни путь с родителями не передаются. Schema — пространство имён Oracle, а SynonymOracle/ ниже — каталог файлов Holkas.
Справочник полей
6 полей · 1 группаПять сохраняемых реквизитов и служебное состояние Valid. Имена Git YAML указаны первыми; JSON обоих ZIP использует camelCase.
Как читать обозначения
Наведите указатель на значок, перейдите к нему клавишей Tab или нажмите его.
Часть ключа — Schema и Name вместе задают адрес синонима. Сравнивается — разница может дать Update JSY. Уточнение действия и ограничения приведены у каждого поля. Create означает создание, Update — изменение.
Синоним · JSY6 полей
SchemaJSON: schema · JSYстрокаЧасть ключаСхема синонима- Назначение
- Схема, которой принадлежит само имя, например APP в APP.UDO_REQUEST. Это не схема целевого объекта.
- При переносе:
- Вместе с Name определяет адрес JSY. Другая схема означает другой объект: если его нет, появляется Create JSY; прежний синоним сохраняется. Схему и пользователя Holkas не создаёт. Schema PUBLIC означает публичный синоним.
NameJSON: name · JSYстрокаЧасть ключаИмя синонима- Назначение
- Собственное имя, например UDO_REQUEST. В поле задаётся имя без префикса схемы.
- При переносе:
- Другой Name — другой адрес. Это не переименование существующего синонима: прежнее имя автоматически не удаляется и использующий его SQL не переписывается.
TranslationSchemaJSON: translationSchema · JSYстрока / nullСравниваетсяСхема цели- Назначение
- Схема объекта, на который указывает синоним: PARUS в PARUS.UDO_T_REQUEST. Это сохранённый адрес, а не обязательно конец цепочки синонимов.
- При переносе:
- Смена схемы при прежнем Schema.Name даёт Update JSY и перенаправляет имя. Null или пустая строка убирают квалификацию схемой в FOR; это не «сохранить старую схему». При DbLink объект ищется в схеме подключения удалённой связи. Для локальной цели сохраняйте явную схему из экспорта.
TranslationNameJSON: translationName · JSYстрокаСравниваетсяИмя цели- Назначение
- Имя таблицы, представления, последовательности, подпрограммы, пакета или другого объекта Oracle, включая другой синоним. Тип цели отдельным полем не хранится.
- При переносе:
- Смена имени даёт Update JSY. Команда меняет адрес указателя; сам объект под старым или новым именем не создаёт, не изменяет и не удаляет. Укажите непустое имя без схемы и @связи.
DbLinkJSON: dbLink · JSYстрока / nullСравниваетсяСвязь с удалённой базой- Назначение
- Имя database link без @, например ARCHIVE.WORLD. Null или пустая строка означают локальную цель. Это имя связи, а не её строка подключения или пароль.
- При переносе:
- Добавление, замена или снятие связи даёт Update JSY; снятие переводит адрес на локальную базу. Сама связь не создаётся. Имя хранится и сравнивается так, как его держит Oracle: без окружающих пробелов и в верхнем регистре. Поэтому archive.world в файле совпадает с ARCHIVE.WORLD в приёмнике и Update не даёт, а при записи Git и ZIP получают ARCHIVE.WORLD. SQL допускает только латинские буквы, цифры, _, ., $, #; прочие символы отклоняются.
ValidВ файлы не пишется · JSYлогическоеСравниваетсяСостояние синонима в приёмнике- Назначение
- Служебный признак: true — статус VALID, false — INVALID. Его читает приёмник из каталога Oracle; извлечение источника и обычное чтение файла дают true.
- При переносе:
- Даже при совпавшем адресе цели false в приёмнике даёт Update JSY: определение записывается повторно. Поле не выгружается в YAML/JSON и не служит командой установить статус. VALID не доказывает доступность цели.
Команда плана
У синонима один код команды и два действия. Значки имеют подписи по наведению, фокусу и нажатию.
JSYСоздать или перенаправить синоним
Create появляется, если этого Schema.Name нет в приёмнике. Update — если изменился адрес цели, DB link или состояние Valid в приёмнике. Обе ветви БД выполняют одно определение CREATE OR REPLACE SYNONYM с реквизитами из источника.
Команда не делает DROP цели, не переносит её строки и не переписывает вызывающий SQL. Отдельных JSY.Grant, Delete и SetOrder нет. Синоним, отсутствующий в выбранном наборе, сохраняется.
Ключ: Схема синонима.Имя синонима
В Git команда меняет сохраняемое описание через тот же план; DDL Oracle там не выполняется. S3 и «Файл пакета» записывают новый ZIP. SQL-файл содержит определение синонима для последующего выполнения.
Пример: оставить имя, сменить цель
В приёмнике APP.UDO_REQUEST → PARUS.UDO_T_REQUEST. Источник задаёт тот же синоним, но TranslationName: UDO_T_REQUEST_NEW. План содержит Update JSY · APP.UDO_REQUEST.
После успешной записи синоним указывает на новое имя. Таблица UDO_T_REQUEST остаётся на месте; таблица UDO_T_REQUEST_NEW этой командой не создаётся. Чтобы перенести новую таблицу, включите её JTB отдельно. Если же поменять Name самого синонима, получится другой адрес и Create при его отсутствии; старое имя сохранится.
Ограничения и что с ними делать
Синоним создан, но обращение через него не работает
Oracle разрешает создать синоним на отсутствующую цель. Например, успешный Create APP.UDO_REQUEST не доказывает существование PARUS.UDO_T_REQUEST. Статус VALID также не проверяет права вызывающего пользователя.
Подготовьте целевой объект и доступ к нему под использующей учётной записью. Собственных грантов у JSY нет: выдача SELECT через имя синонима относится к объекту под ним. Права включаются с определением самой цели либо готовятся отдельно. Подробности — GRANT в Oracle.
Цель находится в другой базе
DbLink добавляет к адресу @ARCHIVE.WORLD. Holkas переносит только имя связи: соединение, его пользователя, пароль и сеть нужно подготовить в приёмнике отдельно. Настройка одноимённой связи может вести в другую базу — совпадение описаний этого не обнаруживает.
При TranslationSchema=null и непустом DbLink схема определяется удалённым подключением. Для понятного адреса сохраняйте явную схему, когда она известна. Настройки и видимость связи описаны в CREATE DATABASE LINK. Чужие удалённые синонимы также могут быть не видны.
Нужен публичный синоним
Выберите его как JSY PUBLIC.ИМЯ — так же, как частный. Каталог показывает публичные синонимы на объекты прикладных схем; синонимы самой Oracle (на SYS, XDB, CTXSYS и другие системные схемы) скрыты: они уже есть в любой базе. Если процедура, представление или пакет обращается к прикладному публичному синониму, план назовёт его недостающей зависимостью.
В приёмнике выполняется CREATE OR REPLACE PUBLIC SYNONYM — подключению нужно право CREATE PUBLIC SYNONYM. Публичное имя одно на всю базу: Update заменяет цель синонима для всех схем, которые к нему обращаются. Так же синоним пишется в Git, ZIP и SQL-файл.
Update появился без изменения адреса цели
Причиной может быть INVALID синонима в приёмнике. Holkas повторно записывает его определение; неверный исходный адрес или недоступную удалённую связь это само по себе не исправляет. Поставить Valid=true в файле — не способ починить базу: поле туда не выгружается.
При перенаправлении могут стать невалидными использующие синоним объекты. Общий финальный этап Oracle пересобирает схему и проверяет состояния выбранных объектов; это не перенос отсутствующей цели и не переписывание зависимого SQL. Разберите адрес и конкретное сообщение Oracle.
Права на создание и граница отката
Схема синонима должна существовать, а подключение — иметь право создать синоним в ней. Наличие доступа к цели и право создать имя — разные условия. При недостаточных полномочиях сама команда JSY откажет.
Oracle DDL фиксируется средствами СУБД. Если последующая команда переноса упадёт, уже успешное перенаправление синонима не откатится вместе с ней. Режим одной транзакции для PostgreSQL не превращает JSY в откатываемую команду Oracle.
Рёбра команд синонима
Что такое ребро и где оно видно в Holkas →
Рёбра помогают Holkas правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, использующую синоним процедуру нужно записать после самого синонима.
Create JSYCreate JPRВ каталоге 10 правил: прямые потребители, раскрытие их локальных опор и общие скрипты. Число рёбер конкретного плана зависит от его команд. Сам JSY не объявляет ребро к TranslationSchema.TranslationName, не анализирует SQL и не включает цель при дозагрузке зависимостей.
Определения Oracle, использующие синоним5 правил
Create / Update JSY→Create / Update JFNКогда: Функция Oracle содержит адрес этого JSY в сохранённом Dependencies; обе команды есть в плане.
Создать или перенаправить используемый синоним раньше записи зависимого определения.
Create / Update JSY→Create / Update JPRКогда: Процедура Oracle содержит адрес этого JSY в сохранённом Dependencies; обе команды есть в плане.
Создать или перенаправить используемый синоним раньше записи зависимого определения.
Create / Update JSY→Create / Update JVWКогда: Представление Oracle содержит адрес этого JSY в сохранённом Dependencies; обе команды есть в плане.
Создать или перенаправить используемый синоним раньше записи зависимого определения.
Create / Update JSY→Create / Update JPGКогда: Пакет Oracle содержит адрес этого JSY в сохранённом Dependencies; обе команды есть в плане.
Создать или перенаправить используемый синоним раньше записи зависимого определения.
Create / Update JSY→Create / Update JTB.TrgКогда: Триггер таблицы Oracle содержит адрес этого JSY в сохранённом Dependencies; обе команды есть в плане.
Создать или перенаправить используемый синоним раньше записи зависимого определения. У триггера зависимость принадлежит JTB.Trg, а не корню таблицы.
Цель и уже совпавшие опоры3 правил
Create / Update цели→Create / Update потребителяКогда: Каталог источника назвал JSY, а обход его локальной цепочки нашёл поддерживаемую цель: JTB, JVW, JFN, JPR, JPG, JSQ или другой JSY. Адрес цели также сохранён в Dependencies потребителя.
Одного синонима недостаточно для компиляции использующего его объекта. Цель ставится перед потребителем; ребра «цель → сам JSY» нет. Удалённая связь и системные схемы этим обходом не раскрываются.
Create / Update JTB.Col→Create / Update потребителяКогда: В Dependencies потребителя есть локальная таблица-цель JTB и в плане есть реальные команды её колонок. Подходит и уже существующая таблица без собственной команды.
Подготовить добавляемые и изменяемые колонки до записи зависимого определения. Ожидание корня таблицы само по себе не ждёт все колонки.
Create / Update JSY→Команда через совпавшую опоруКогда: Команда имеет обычную прямую ссылку на Oracle-объект, чьей корневой команды нет; его описание с Dependencies на JSY есть в наборе. Общий проход переносит эту зависимость дальше.
Например, новая функция ждёт синоним через уже совпавшую процедуру. Это чтение сохранённых Dependencies опоры, не анализ текста синонима. Обход повторяется через совпавшие опоры, исключая циклы и самоссылку.
Скрипты автора2 правил
SCR Before→Create / Update JSYКогда: Приёмник выполняет скрипты; скрипт Before привязан к JSY по типу и адресу либо ко всему переносу.
Подготовить условия до записи синонима. Ошибка скрипта или снятие его выбора затрагивают ожидающую команду.
Create / Update JSY→SCR AfterКогда: Приёмник выполняет скрипты; скрипт After привязан к JSY либо ко всему переносу, и у охватываемых объектов есть команды.
Выполнить скрипт после команд его объектов. При совпавшем JSY отдельный привязанный только к нему скрипт из плана убирается.
Границы зависимостей и исходной очередности
Список Dependencies хранится у потребителя. Для Oracle Holkas получает его из каталога и, встретив синоним, дополнительно проходит локальную цепочку поддерживаемых целей. Системные, удалённые и неподдерживаемые объекты не превращаются в локальные опоры. Публичный синоним становится опорой, только если указывает на объект прикладной схемы. Динамический SQL каталог может не отразить.
Если сохранённой зависимости нет, одно упоминание имени синонима в SQL не создаёт эти рёбра. Уже совпавший объект не получает Update только из-за изменения своей опоры; фактический INVALID учитывается отдельно. Наличие ребра к Create/Update не означает, что в плане обязательно есть обе команды.
Обычные зависимости влияют на выбор и отказ зависимых команд; снятие создания нужного JSY затрагивает потребителя. Подробнее — недостающие зависимости. Между самим JSY и его целью порядок может определяться исходным списком: это не скрытое ребро.
Как синоним хранится в файлах
Начните с каталога SynonymOracle/. У синонима собственный файл; указатель сохраняется без вложенной копии цели.
Git
YAMLSynonymOracle/APP.UDO_REQUEST.yamlОдно описание синонима: Schema, Name, TranslationSchema, TranslationName и, если задан, DbLink. Valid исключён.
Holkas записывает и читает файл в формате YAML. В корне репозитория — .holkas с его сведениями.S3
JSON в ZIPSynonymOracle/APP.UDO_REQUEST.jsonJSON с полями schema, name, translationSchema, translationName и dbLink, если он задан. Цели в этом файле нет.
Состав при чтении берётся из manifest.json, затем читается файл синонима. Сам ZIP находится в S3.Файл пакета
JSON в ZIPSynonymOracle/APP.UDO_REQUEST.jsonВ скачиваемом ZIP — те же поля этого синонима и один адрес JSY в оглавлении. Valid не записывается.
При чтении используются manifest.json и отдельный JSON объекта.Для JSY содержимое собственного JSON совпадает в обоих видах ZIP (S3 и «Файл пакета») и читается обоими транспортами. Это проверено именно для синонима; из этого не следует одинаковая раскладка других типов.
В оглавлении manifest.json объект записан как {"typeCode":"JSY","name":"APP.UDO_REQUEST"}. В нём также указаны формат, СУБД oracle и сведения о выгрузке. Небезопасные символы кодируются в пути: например, / превращается в %2F. Адрес в оглавлении, имя файла и реквизиты внутри должны соответствовать друг другу.
Полное описание одного локального синонима: YAML и JSON
Учебные файлы прочитаны самим Holkas. Это описание синонима, а не готовое окружение: схема APP и целевая таблица должны быть подготовлены отдельно.
Git — SynonymOracle/APP.UDO_REQUEST.yaml
Schema: APP
Name: UDO_REQUEST
TranslationSchema: PARUS
TranslationName: UDO_T_REQUEST
S3 и «Файл пакета» — SynonymOracle/APP.UDO_REQUEST.json
{
"schema": "APP",
"name": "UDO_REQUEST",
"translationSchema": "PARUS",
"translationName": "UDO_T_REQUEST"
}
Null при записи опускается: здесь нет DbLink. При обратном чтении это локальная цель; пустая строка сохраняется, но сравнение приравнивает её к null. Valid отсутствует и восстанавливается как true.
Как тот же синоним записывается с удалённой связью
Если задать TranslationSchema=ARCHIVE и DbLink=ARCHIVE.WORLD, адрес цели станет ARCHIVE.UDO_T_REQUEST@ARCHIVE.WORLD. В JSON поле называется dbLink, в YAML — DbLink. В SQL-файл Holkas записывает:
CREATE OR REPLACE SYNONYM "APP"."UDO_REQUEST" FOR "ARCHIVE"."UDO_T_REQUEST"@ARCHIVE.WORLD;
Это результат генерации SQL, без выполнения в Oracle. Связь с базой в этот SQL-файл не включается.
Целевая таблица, представление или подпрограмма имеют свои файлы, если включены в выгрузку. Папка SynonymOracle/ не является каталогом КОР и в Oracle не создаётся.
Практические шаги: сохранить в Git, выгрузить и загрузить файл пакета, получить SQL-файл. Формат оглавления — в справке о пакете.
Основа справки: указанные документы Oracle 19; модель, каталог, сравнение, команды, исполнители, писатели и читатели Holkas 0.1.30. Сверено 9 ноября 2026. Сохранённый опыт Oracle от 13 сентября 2026 и существующий зеркальный сценарий отличаются от нынешних локальных проб. Все имена в примерах учебные. Новый перенос в БД и проверка клиентов Паруса при подготовке страницы не выполнялись.