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

Справочник / объект

Синоним Oracle

Тип объекта в Holkas: JSY

Oracle

В командной строке: --object JSY:APP.UDO_REQUEST · как задать состав в CLI

Другое имя для объекта Oracle: адрес цели, удалённая связь, все поля JSY, команды, зависимости и хранение в файлах Holkas.

← Все объекты
На этой странице

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.

Что входит в перенос

Ссылается на отдельный объект: например, таблицу JTB, представление JVW, процедуру JPR, функцию JFN или пакет JPG. Цель не является дочерней частью синонима.
Вложенных частей, тела SQL, собственных выдач прав и списка Dependencies у JSY нет. Выбор одного синонима не добавляет его цель или использующие его объекты.

Папки каталога Паруса к этому типу не относятся: ни имя папки, ни путь с родителями не передаются. Schema — пространство имён Oracle, а SynonymOracle/ ниже — каталог файлов Holkas.

Справочник полей

6 полей · 1 группа

Пять сохраняемых реквизитов и служебное состояние Valid. Имена Git YAML указаны первыми; JSON обоих ZIP использует camelCase.

Как читать обозначения

Часть ключа — 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. Команда меняет адрес указателя; сам объект под старым или новым именем не создаёт, не изменяет и не удаляет. Укажите непустое имя без схемы и @связи.
ValidВ файлы не пишется · JSYлогическоеСравниваетсяСостояние синонима в приёмнике
Назначение
Служебный признак: true — статус VALID, false — INVALID. Его читает приёмник из каталога Oracle; извлечение источника и обычное чтение файла дают true.
При переносе:
Даже при совпавшем адресе цели false в приёмнике даёт Update JSY: определение записывается повторно. Поле не выгружается в YAML/JSON и не служит командой установить статус. VALID не доказывает доступность цели.
null, пустая строка и написание имён

При сравнении строк null и пустая строка равны, окончания CRLF/LF также не различаются. Регистр и пробелы значений сравниваются; это не способ переименования или автоматического исправления адреса. Исключение — DbLink: его регистр и окружающие пробелы не учитываются, как и в самом Oracle.

У TranslationSchema отсутствие значения убирает схему из SQL; у DbLink — удалённую связь. Они не означают сохранение прежнего адреса. Для локальной цели сохраняйте явную схему. При отсутствии схемы и DB link Oracle использует собственную схему выполняющего пользователя, а не автоматически Schema синонима.

Schema, Name и TranslationName задавайте непустыми. Читаемость неполного файла не подтверждает допустимость его применения. В этом объекте нет числовых полей, нуля как признака или списков с семантикой []. Имена берите из полного экспорта; обычные адреса Oracle при поиске в каталоге приводятся к верхнему регистру.

Что отсутствует в файле

Valid не сохраняется: это состояние приёмника. Нет отдельных полей Owner, Grants, Dependencies, тела SQL, пароля DB link или настроек его подключения. Schema задаёт владельца имени; TranslationSchema — владельца цели.

Параметры editioning Oracle также не входят в модель. JSY не переносит полное окружение схемы. Не используйте его как средство воспроизведения всех свойств базы.

Команда плана

У синонима один код команды и два действия. Значки имеют подписи по наведению, фокусу и нажатию.

JSY
CreateUpdate

Создать или перенаправить синоним

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 правильно отсортировать команды перед применением. Ребро связывает две команды и указывает, какая должна выполниться раньше. Например, использующую синоним процедуру нужно записать после самого синонима.

1 · СначалаСоздать синонимCreate JSY
→
2 · ЗатемЗаписать использующую процедуруCreate JPR
Условие — адрес JSY сохранён в Dependencies процедуры. Для компиляции может потребоваться и сама цель, поэтому процедура ждёт её отдельно. Создание JSY не требует, чтобы цель уже существовала.

В каталоге 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

YAML
SynonymOracle/APP.UDO_REQUEST.yaml

Одно описание синонима: Schema, Name, TranslationSchema, TranslationName и, если задан, DbLink. Valid исключён.

Holkas записывает и читает файл в формате YAML. В корне репозитория — .holkas с его сведениями.

S3

JSON в ZIP
SynonymOracle/APP.UDO_REQUEST.json

JSON с полями schema, name, translationSchema, translationName и dbLink, если он задан. Цели в этом файле нет.

Состав при чтении берётся из manifest.json, затем читается файл синонима. Сам ZIP находится в S3.

Файл пакета

JSON в ZIP
SynonymOracle/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 и существующий зеркальный сценарий отличаются от нынешних локальных проб. Все имена в примерах учебные. Новый перенос в БД и проверка клиентов Паруса при подготовке страницы не выполнялись.