<appendix id="release">
 <title>Замечания к выпускам</title>

  <sect1 id="release-26-1-1">
  <title>ora2pgpro 26.1.1</title>
  <formalpara>
    <title>Дата выпуска:</title>
    <para>2026-05-29</para>
  </formalpara>

    <para>В этом выпуске добавлены новые возможности и исправлены некоторые ошибки. Важные изменения перечислены ниже.</para>

  <itemizedlist>
    <listitem>
    <!-- ORA-38 -->
    <para>Исправлены ошибки разбора цепочек вызовов методов для корректного работы с ассоциативными массивами. Ранее ошибки могли возникать при обработке остановок на неизвестных типах узлов.</para>
    </listitem>
    <listitem>
    <!-- ORA-49 -->
    <para>Исправлена ошибка с экспортом пакетов, если каталог вывода по умолчанию не был задан. Ранее параметр командной строки <option>-b</option> фактически был обязательным, хотя должен быть необязательным.</para>
    </listitem>
    <listitem>
    <!-- ORA-55 -->
    <para>Исправление ошибок преобразования входных значений даты или времени для сохранения корректной семантики дат при миграции.</para>
    </listitem>
    <listitem>
    <!-- ORA-54 -->
    <para>Исправлены различные ошибки при миграции пакетов для ранее не поддерживаемых конструкций <application>PL/SQL</application>. Теперь такие конструкции не приводят к сбою экспорта пакетов: они разбираются, а затем преобразуются, если такая операция поддерживается, или игнорируются с выводом предупреждения.</para>
    </listitem>
    <listitem>
    <para>Добавлена поддержка Альт 11, Debian 13, Ubuntu 26.04, RHEL 10, SLES 16 и МосОС 15.</para>
    </listitem>
    <listitem>
    <para>Прекращена поддержка Альт 9, Debian 10 и Ubuntu 20.04.</para>
    </listitem>
  </itemizedlist>
 </sect1>

 <sect1 id="release-24-2-1">
  <title>ora2pgpro 24.2.1</title>
  <formalpara>
    <title>Дата выпуска:</title>
    <para>2024-06-20</para>
  </formalpara>

    <para>В этом выпуске добавлены новые возможности и исправлены некоторые ошибки. Важные изменения перечислены ниже.</para>

  <itemizedlist>
    <listitem>
    <!-- ORA-32 -->
    <para>Реализован механизм преобразования вызовов пакетных процедур в вызовы функций и наоборот. Это необходимо для поддержки пакетов <application>orafce</application>, в частности пакета <literal>dbms_output</literal>.</para>
    </listitem>
    <listitem>
    <!-- ORA-5 -->
    <para>Реализован механизм преобразования внутренних переменных, процедур и функций при помощи модификаторов <literal>#export</literal>, <literal>#private</literal> и <literal>#export off</literal> во время <link linkend="ora2pgpro-exporting-packages">экспорта и импорта пакетов</link>.</para>
    </listitem>
    <listitem>
    <!-- ORA-37 -->
    <para>Исправлена проблема, приводившая к ошибке типа <quote>FATAL: Can't open XXX: No such file or directory</quote> (FATAL: Не удалось открыть XXX: нет такого файла или каталога) при использовании типа экспорта <literal>SHOW_REPORT</literal> без параметра <option>--basedir</option>.</para>
    </listitem>
    <listitem>
    <!-- ORA-36 -->
    <para>Исправлена ошибка поиска файла конфигурации <filename>ora2pgpro.conf</filename>. Теперь путь к файлу генерируется правильно.</para>
    </listitem>
    <listitem>
    <!-- ORA-27 -->
    <para>Добавлена поддержка Ubuntu 24/04, Astra Linux 1.8 и прекращена поддержка Astra Linux Orel 2.12 и Astra Linux 1.6.</para>
    </listitem>
 </itemizedlist>
 </sect1>

 <sect1 id="release-24-1-1">
  <title>ora2pgpro 24.1.1</title>
  <formalpara>
    <title>Дата выпуска:</title>
    <para>2024-03-25</para>
  </formalpara>

 <para>В этом выпуске добавлены новые возможности и исправлены некоторые ошибки. Важные изменения перечислены ниже.</para>

 <itemizedlist>
  <listitem>
  <!-- ORA-7 -->
    <para>Полностью переработана реализация <link linkend="ora2pgpro-exporting-packages">экспорта и импорта пакетов</link>. Теперь пакеты Oracle автоматически преобразуются в пакеты Postgres Pro максимально корректно, при этом в местах кода, требующих внимания разработчика, появляются сообщения.</para>
  </listitem>
  <listitem>
  <!-- ORA-7 -->
    <para>Реализована возможность экспортировать объекты типа <type>VARRAY</type> как массивы Postgres Pro.</para>
  </listitem>
  <listitem>
  <!-- ORA-1 -->
    <para>Реализована возможность экспортировать коллекции Oracle типа <link linkend="ora2pgpro-exporting-associative-arrays">ассоциативный массив</link> как коллекции в <ulink url="https://postgrespro.ru/docs/enterprise/16/pg-variables"><application>pg_variables</application></ulink>.</para>
  </listitem>
  <listitem>
  <!-- ORA-1 -->
    <para>Добавлен параметр <option>--offline</option>, позволяющий преобразовывать экспортируемые данные без подключения к БД Oracle.</para>
  </listitem>
 </itemizedlist>

 <note>
  <para>В выпускаемой версии <application>ora2pgpro</application> функции и процедуры, определённые не в пакетах, обрабатываются так же, как в предыдущей версии. Новая функциональность добавлена только в рамках преобразования пакетов, для других типов экспорта преобразование <type>VARRAY</type> или коллекций из ассоциативных массивов осуществляется прежним образом.</para>
 </note>
 </sect1>

 <sect1 id="release-23-2">
  <title>ora2pgpro 23.2.1</title>
  <formalpara>
    <title>Дата выпуска:</title>
    <para>2023-09-22</para>
  </formalpara>

 <para>Это первый публичный релиз утилиты <productname>ora2pgpro</productname>, которая поставляется в виде пакета, совместимого с <productname>Postgres Pro Enterprise</productname>.</para>

 <para>Основные возможности данной утилиты перечислены ниже: <itemizedlist spacing="compact">
      <listitem><simpara>Полный экспорт схемы БД (таблицы, представления, последовательности, индексы) с ограничениями уникальности, первичным ключом, внешними ключами и ограничениями-проверками.</simpara></listitem>
      <listitem><simpara>Экспорт прав пользователей и групп.</simpara></listitem>
      <listitem><simpara>Экспорт секций по спискам и по диапазонам.</simpara></listitem>
      <listitem><simpara>Экспорт нескольких таблиц (с указанием имён).</simpara></listitem>
      <listitem><simpara>Экспорт схемы Oracle как схемы Postgres Pro.</simpara></listitem>
      <listitem><simpara>Экспорт предопределённых функций, триггеров, процедур, пакетов и тел пакетов.</simpara></listitem>
      <listitem><simpara>Экспорт всех данных или выбранных предложением <literal>WHERE</literal>.</simpara></listitem>
      <listitem><simpara>Полная поддержка экспорта объектов BLOB Oracle как <type>bytea</type> Postgres Pro.</simpara></listitem>
      <listitem><simpara>Экспорт представлений Oracle как таблиц Postgres Pro.</simpara></listitem>
      <listitem><simpara>Экспорт определяемых пользователем типов Oracle.</simpara></listitem>
      <listitem><simpara>Базовое автоматическое преобразование кода <application>PL/SQL</application> в код <application>PL/pgSQL</application>.</simpara></listitem>
      <listitem><simpara>Работа на любой платформе.</simpara></listitem>
      <listitem><simpara>Экспорт таблиц Oracle как таблиц, реализованных через обёртку сторонних данных.</simpara></listitem>
      <listitem><simpara>Экспорт материализованных представлений.</simpara></listitem>
      <listitem><simpara>Вывод отчёта о содержимом БД Oracle.</simpara></listitem>
      <listitem><simpara>Помощь в оценке стоимости миграции БД Oracle.</simpara></listitem>
      <listitem><simpara>Помощь в оценке сложности миграции БД Oracle.</simpara></listitem>
      <listitem><simpara>Помощь в оценке стоимости миграции кода <application>PL/SQL</application> из файла.</simpara></listitem>
      <listitem><simpara>Помощь в оценке стоимости миграции SQL-запросов Oracle, хранящихся в файле.</simpara></listitem>
      <listitem><simpara>Экспорт Oracle Locator и пространственных данных в <application>PostGIS</application>.</simpara></listitem>
      <listitem><simpara>Экспорт <literal>DBLINK</literal> в Oracle FDW.</simpara></listitem>
      <listitem><simpara>Экспорт <literal>SYNONYM</literal> как представлений.</simpara></listitem>
      <listitem><simpara>Экспорт <literal>DIRECTORY</literal> как внешних таблиц или каталога для расширения <literal>external_file</literal>.</simpara></listitem>
      <listitem><simpara>Передача SQL-команд с использованием нескольких соединений с Postgres Pro.</simpara></listitem>
      <listitem><simpara>Сравнение БД Oracle и Postgres Pro для целей тестирования.</simpara></listitem>
    </itemizedlist></para>
 </sect1>
</appendix>
