Глава 1. ora2pgpro

Задать список экспортируемых объектов, разделённых запятыми. Параметр может также использоваться с типом SHOW_COLUMN.

Задать выходной каталог для файлов, полученных в результате экспорта.

Указать файл конфигурации, отличный от используемого по умолчанию /etc/ora2pgpro/ora2pgpro_scanner.conf.

Указать файл для хранения/чтения SCN таблиц во время экспорта. По умолчанию: TABLES_SCN.log в текущем каталоге. Для создания этого файла используйте параметр --cdc_ready.

Выводить подробные сообщения.

Разрешить использование пользовательских типов в командной строке.

Исключить из экспорта список указанных объектов, разделённых запятыми. Может использоваться с типом SHOW_COLUMN.

Выводить краткую справку.

Извлекать права для данного типа объектов. Возможные значения даны в описании конфигурации GRANT_OBJECT.

Указать файл, содержащий код PL/SQL для портирования, когда подключение к БД Oracle отсутствует.

Задать число параллельных процессов при передаче данных в Postgres Pro.

Задать число параллельных соединений для извлечения данных из Oracle.

Указать файл журнала. По умолчанию: stdout.

Задать количество кортежей, извлекаемых из Oracle и сохраняемых в памяти до записи, по умолчанию 10000.

Указать схему Oracle для извлечения данных.

Задать search_path для Postgres Pro.

Указать путь к выходному файлу, в который записываются команды SQL. По умолчанию: output.sql в текущем каталоге.

Включить преобразование кода PL/SQL в код PL/pgSQL.

Задать число таблиц для параллельного извлечения данных.

Отключить вывод индикатора выполнения.

Использовать параметр \ir вместо \i в создаваемых скриптах psql.

Задать источник данных DBI для Oracle.

Задать системный номер изменения Oracle (System Change Number, SCN) для экспорта данных. Он используется в предложениях WHERE для получения данных с типами экспорта COPY или INSERT.

Задать тип экспорта. Параметр переопределяет значение, заданное в файле конфигурации (TYPE).

Указать отдельный временный каталог для одновременного запуска двух или более экземпляров ora2pgpro.

Указать пользователя для подключения к БД Oracle. Вместо этого параметра можно использовать переменную окружения ORA2PG_USER.

Показать версию ora2pgpro и прервать выполнение.

Указать пароль для пользователя БД Oracle. Вместо этого параметра можно использовать переменную окружения ORA2PG_PASSWD.

Задать предложение WHERE, добавляемое к запросу Oracle для получения данных. Параметр можно указывать несколько раз.

Принудительно назначать владельца таблиц и последовательностей, как в Oracle. Если в значении указать имя пользователя, он будет назначен владельцем. По умолчанию владельцем будет пользователь, используемый для подключения к БД Postgres Pro.

Задать кодировку клиента Oracle в NLS_LANG.

Задать кодировку клиента Postgres Pro.

Указать список представлений, разделённых запятыми, для экспорта в виде таблиц.

Активировать оценку стоимости миграции для SHOW_REPORT.

Задать число минут для оценки стоимости. По умолчанию 5 минут, что соответствует скорости миграции, выполняемой специалистом Postgres Pro. Для первой миграции установите значение 10.

Выгружать отчёт в формате HTML. Параметр используется только с SHOW_REPORT. По умолчанию отчёт выгружается в формате простого текста.

Аналогично предыдущему, но отчёт выгружается в формате CSV.

Выводить отчёт по оценке миграции с отдельной строкой в формате CSV для каждой БД.

Инициализировать стандартное дерево проекта ora2pgpro. Каталог верхнего уровня создаётся в базовом каталоге проекта.

Указать базовый каталог для деревьев проекта ora2pgpro. По умолчанию это текущий каталог.

Выводить заголовок CSV, что особенно полезно при первом запуске ora2pgpro. Параметр используется вместе с параметром --dump_as_sheet.

Задать предел человеко-дней, по достижении которого уровень оценки миграции меняется с B на C. По умолчанию 5 человеко-дней.

Указать список имён пользователей для фильтрации запросов в таблице AUDIT_USER. Используется только с типами экспорта SHOW_REPORT и QUERY.

Указать источник данных для прямого импорта в Postgres Pro.

Указать пользователя Postgres Pro.

Указать пароль пользователя Postgres Pro.

Принудительно подсчитывать действительное количество строк при выполнении TEST, TEST_COUNT и SHOW_TABLE.

Не выводить заголовок ora2pgpro в выходной файл.

Узнать скорость, с которой могут передаваться данные из Oracle. Данные не обрабатываются и не записываются.

Узнать скорость, с которой ora2pgpro может отправлять преобразованные данные. Данные не записываются.

Экспортировать BLOB в виде больших объектов. Параметр может использоваться только при выполнении SHOW_COLUMN, TABLE и INSERT.

Использовать текущие SCN для экспорта данных из таблиц и записать их в файл под названием TABLES_SCN.log по умолчанию. Другое имя файла можно указать, используя параметр -C|--cdc_file.

Использовать команду psql \lo_import для импорта BLOB в виде больших объектов. Параметр можно использовать для импорта с типом COPY и последующим импортом большого объекта вручную. Необходим для импорта BLOB размером более 1 ГБ.

Указать список материализованных представлений, разделённых запятыми, для экспорта в виде обычных таблиц.

Удалить объект перед созданием, если он уже существует.

Задаёт переменную окружения ORACLE_HOME для библиотек Oracle, используемых модулем Perl DBD::Oracle.

Задаёт имя источника данных в формате DBI DSN. Например:

dbi:Oracle:host=oradb_host.myhost.com;sid=DB_SID;port=1521

или

dbi:Oracle:DB_SID

Пример для 18c:

dbi:Oracle:host=192.168.1.29;service_name=pdb1;port=1521

Для использования второй нотации необходимо объявить SID в файле $ORACLE_HOME/network/admin/tnsnames.ora или в пути, указанном в переменной окружения TNS_ADMIN.

Задают имя пользователя и пароль для подключения к БД Oracle. Обратите внимание, что лучше входить в систему с правами суперпользователя Oracle во избежание проблем доступа во время сканирования базы данных и пропуска данных.

Если не задать пароль в ORACLE_PWD и установить Perl-модуль Term::ReadKey, ora2pgpro запросит пароль интерактивно. Если имя пользователя не задано в ORACLE_USER, его тоже нужно будет задать интерактивно.

Чтобы подключиться к локальному экземпляру Oracle с правами SYSDBA, необходимо задать для ORACLE_USER значение / и пустой пароль.

Задайте для этого параметра значение 1, если вы подключаетесь к БД Oracle как простой пользователь без права извлекать данные из таблиц DBA_. Будут использоваться таблицы ALL_.

Предупреждение: при использовании типа экспорта GRANT необходимо задать для этого параметра значение 0, в противном случае он работать не будет.

Эту директиву можно использовать, чтобы изменить уровень изоляции по умолчанию для экспортируемых транзакций. По умолчанию задаётся сериализуемый уровень изоляции для сохранения целостности данных. Допустимые значения директивы

Эту директиву можно использовать для отправки начальных команд в Oracle сразу после подключения, например, чтобы разблокировать политику для чтения объектов или установить параметры сеанса. Директиву можно задавать несколько раз.

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

Директива используется для указания имени схемы, используемой во время экспорта. Например, с указанием SCHEMA APPS будут выгружены объекты, связанные со схемой APPS.

Если включить EXPORT_SCHEMA и не задать имя схемы, ora2pgpro экспортирует все объекты из всех схем экземпляра Oracle, добавляя к именам объектов имя схемы в виде префикса.

По умолчанию схема Oracle не экспортируется в БД Postgres Pro, а все объекты создаются в пространстве имён Postgres Pro по умолчанию. Если необходимо и экспортировать схему, и создать все объекты в этом пространстве имён, задайте для EXPORT_SCHEMA значение 1. При этом в пути к схеме (search_path) в начале SQL-файла для экспорта будет записана схема, указанная в директиве SCHEMA (по умолчанию pg_catalog). Если вы хотите изменить путь, используйте директиву PG_SCHEMA.

Директива включает/отключает команду CREATE SCHEMA в начале выходного файла. По умолчанию включена, используется с типом экспорта TABLE.

По умолчанию ora2pgpro экспортирует только рабочий код PL/SQL. Можно перекомпилировать нерабочий код в Oracle, чтобы добиться корректности и в дальнейшем экспортировать его.

Чтобы схема компилировалась в Oracle перед экспортом кода, включите эту директиву. В этом случае, если

При этом в Oracle отправится запрос на перекомпиляцию кода PL/SQL, который мог стать нерабочим, например, после экспорта/импорта. В результате для функций, процедур, пакетов и пользовательских типов проставляется статус VALID или INVALID. Кроме того, это распространяется на отключённые триггеры.

Если предыдущей директивы недостаточно для проверки корректности кода PL/SQL, включите эту директиву, чтобы разрешить экспорт всего кода PL/SQL, даже если он помечен как нерабочий. В результате для функций, процедур, пакетов и пользовательских типов проставляется статус VALID или INVALID.

Позволяет указать / принудительно использовать схему Postgres Pro. По умолчанию, если для EXPORT_SCHEMA задано значение 1, для параметра search_path в Postgres Pro будет задано имя схемы, указанной в SCHEMA.

Значением может быть список имён схем, разделённых запятыми, но не с типом экспорта TABLE, потому что в этом случае создаётся оператор CREATE SCHEMA, не поддерживающий несколько имён схем. Например, если для PG_SCHEMA указать user_schema, public, путь поиска задаётся следующим образом:

SET search_path = user_schema, public;

В этом случае используется схема (здесь user_schema), отличная от схемы Oracle, которая указана в директиве SCHEMA.

Кроме того, для пользователя Postgres Pro, под именем которого вы подключаетесь к целевой базе данных, можно задать значение search_path по умолчанию следующим образом:

ALTER ROLE username SET search_path TO user_schema, public;

Тогда задавать PG_SCHEMA не понадобится.

Если не задать схему явным образом, ora2pgpro экспортирует все объекты, не принадлежащие системной схеме или роли:

SYSTEM,CTXSYS,DBSNMP,EXFSYS,LBACSYS,MDSYS,MGMT_VIEW,
OLAPSYS,ORDDATA,OWBSYS,ORDPLUGINS,ORDSYS,OUTLN,
SI_INFORMTN_SCHEMA,SYS,SYSMAN,WK_TEST,WKSYS,WKPROXY,
WMSYS,XDB,APEX_PUBLIC_USER,DIP,FLOWS_020100,FLOWS_030000,
FLOWS_040100,FLOWS_010600,FLOWS_FILES,MDDATA,ORACLE_OCM,
SPATIAL_CSW_ADMIN_USR,SPATIAL_WFS_ADMIN_USR,XS$NULL,PERFSTAT,
SQLTXPLAIN,DMSYS,TSMSYS,WKSYS,APEX_040000,APEX_040200,
DVSYS,OJVMSYS,GSMADMIN_INTERNAL,APPQOSSYS,DVSYS,DVF,
AUDSYS,APEX_030200,MGMT_VIEW,ODM,ODM_MTR,TRACESRV,MTMSYS,
OWBSYS_AUDIT,WEBSYS,WK_PROXY,OSE$HTTP$ADMIN,
AURORA$JIS$UTILITY$,AURORA$ORB$UNAUTHENTICATED,
DBMS_PRIVILEGE_CAPTURE,CSMIG,MGDSYS,SDE,DBSFWUSER

В зависимости от инсталляции Oracle, могут быть определены несколько системных ролей. Чтобы добавить этих пользователей в список исключений схемы, укажите их через запятую в директиве SYSUSERS. Например:

SYSUSERS        INTERNAL,SYSDBA,BI,HR,IX,OE,PM,SH

В результате пользователи INTERNAL и SYSDBA будут добавлены в список исключений.

По умолчанию владельцем объектов БД будет пользователь, используемый для подключения к БД Postgres Pro в psql. Если используется другой пользователь (например, postgres), можно указать ora2pgpro назначать владельцем объектов пользователя, используемого в БД Oracle, задав для этой директивы значение 1. Если в значении указать имя пользователя, он и будет назначен владельцем.

Для экспорта функций ora2pgpro использует права из Oracle (чаще всего SECURITY DEFINER). Включите эту директиву, если необходимо переопределить права для всех функций на SECURITY INVOKER.

Когда директива включена, ora2pgpro экспортирует все таблицы, ограничения и индексы, используя имя пространства имён, указанное в БД Oracle. Не работает с пространствами имён TEMP, USERS и SYSTEM.

Когда директива включена, при создании таблиц или представлений как таблиц ora2pgpro добавляет указание WITH OIDS. По умолчанию отключена, как и в Postgres Pro.

Список схем, из которых извлекаются метаданные о функциях/процедурах, используемые в экспорте схем. Если при замене вызова функции с параметрами OUT эта функция объявлена в другом пакете, вызов не может быть перезаписан, поскольку ora2pgpro знает только про функции, объявленные в текущей схеме. Если задать в этой директиве список схем, разделённых запятыми, ora2pgpro будет выполнять поиск всех функций, процедур и объявлений пакетов по всем пакетам перед тем, как начать экспорт текущей схемы.

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

По умолчанию ora2pgpro анализирует индексы, чтобы определить тип пространственного ограничения и размерность, определённую в Oracle. Эти ограничения передаются при создании индекса, например, так:

CREATE INDEX ... INDEXTYPE IS MDSYS.SPATIAL_INDEX
PARAMETERS('sdo_indx_dims=2, layer_gtype=point');

Если параметры ограничений в Oracle не указаны, по умолчанию эти столбцы экспортируются с универсальным типом GEOMETRY, чтобы получать любой тип пространственных данных.

Директива AUTODETECT_SPATIAL_TYPE заставляет ora2pgpro автоматически определять фактический тип пространственных данных и размерность, используемые в столбце с пространственными данными, в противном случае используется тип геометрии без ограничений. Когда эта функциональность включена (по умолчанию), ora2pgpro сканирует выборку из 50000 строк, чтобы проанализировать используемый тип GTYPE. Размер выборки можно увеличить или уменьшить, указав в AUTODETECT_SPATIAL_TYPE необходимое количество строк для сканирования.

Например, если директива AUTODETECT_SPATIAL_TYPE отключена, столбец shape с типом Oracle SDO_GEOMETRY будет преобразован следующим образом:

shape geometry(GEOMETRY) or shape geometry(GEOMETRYZ, 4326)

Если директива включена и столбец содержит отдельный тип геометрии, использующий одно измерение с двумерными или трёхмерными многоугольниками:

shape geometry(POLYGON, 4326) or shape geometry(POLYGONZ, 4326)

Эта директива позволяет управлять автоматическим преобразованием SRID Oracle в значения, соответствующие стандарту EPSG. Когда директива включена, ora2pgpro использует функцию Oracle sdo_cs.map_oracle_srid_to_epsg() для преобразования всех SRID. По умолчанию включена.

Если Oracle возвращает NULL для SDO_SRID, NULL заменяется значением по умолчанию 8307, преобразованным в значение по EPSG: 4326 (см. DEFAULT_SRID).

Если задать значение больше 1, все SRID получат это значение, то есть DEFAULT_SRID не используется, если Oracle возвращает NULL.

Обратите внимание, что значение EPSG можно задать на стороне Oracle, если sdo_cs.map_oracle_srid_to_epsg() возращает NULL:

  system@db> UPDATE sdo_coord_ref_sys SET legacy_code=41014 WHERE srid = 27572;
  

Используйте эту директиву, чтобы переопределить значение EPSG для SRID по умолчанию (4326). CONVERT_SRID переопределяет это значение, см. выше.

Эта директива может принимать следующие значения: WKT (по умолчанию), WKB или INTERNAL. Если задано значение WKT, ora2pgpro использует SDO_UTIL.TO_WKTGEOMETRY(), чтобы извлечь геометрические данные. Когда задано значение WKB, ora2pgpro выводит их в двоичном формате с использованием SDO_UTIL.TO_WKBGEOMETRY(). Если извлекать данные вышеописанными способами в виде вызовов на стороне Oracle, при большом количестве строк может произойти нехватка памяти из-за значительного времени выполнения. Кроме того, с WKB 3D геометрии и некоторые другие геометрии, такие как CURVEPOLYGON, не извлекаются. В таких случаях можно использовать тип извлечения INTERNAL. При этом для преобразования данных SDO_GEOMETRY в WKT используется библиотека Pure Perl, а само преобразование осуществляется на стороне ora2pgpro. Эта функциональность требует доработки, поэтому перед использованием необходимо проверять корректность экспортированных геометрий. Для пространственных объектов по умолчанию используется тип извлечения INTERNAL.

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

Задаёт функцию Oracle для извлечения SRID из метаданных ST_Geometry. По умолчанию: ST_SRID. Для ArcSDE, например, следует указать sde.st_srid.

Задаёт функцию Oracle для извлечения размерности из метаданных ST_Geometry. По умолчанию: ST_DIMENSION. Для ArcSDE, например, следует указать sde.st_dimension.

Задаёт функцию Oracle для извлечения типа геометрии из столбца ST_Geometry. По умолчанию: ST_GEOMETRYTYPE. Для ArcSDE, например, следует указать sde.st_geometrytype.

Задаёт функцию Oracle для преобразования значения ST_Geometry в формат WKB. По умолчанию: ST_ASBINARY. Для ArcSDE, например, следует указать sde.st_asbinary .

Задаёт функцию Oracle для преобразования значения ST_Geometry в формат WKT. По умолчанию: ST_ASTEXT. Для ArcSDE, например, следует указать sde.st_astext .

При экспорте типа INSERT/COPY ora2pgpro ведёт обработку блоками по DATA_LIMIT кортежей для увеличения скорости. Перед записью на диск кортежи хранятся в памяти, так что если необходимо увеличить скорость, то при наличии достаточных системных ресурсов можно увеличить этот предел, например, до 100000 или 1000000. Значение 0 означает, что используется размер блока по умолчанию: 10000.

Когда ora2pgpro обнаруживает таблицу с BLOB, значение DATA_LIMIT автоматически уменьшается путём деления на 10 до тех пор, пока оно не станет меньше 1000. Можно отдельно указать директиву BLOB_LIMIT для экспорта BLOB, но обратите внимание, что экспорт BLOB задействует много ресурсов, поэтому большое значение может вызвать нехватку памяти.

Эта директива позволяет изменить выходной файл для ora2pgpro. Значение по умолчанию — output.sql. Если задать имя файла с расширением .gz или .bz2, вывод будет сжат автоматически. При этом для файлов .gz требуется установленный модуль Perl Compress::Zlib, а для .bz2 — утилита командной строки bzip2.

В этой директиве можно задать каталог для записи файла. Указанный каталог должен существовать.

В этой директиве можно указать полный путь к утилите bzip2, если она не обнаружена в переменной окружения PATH.

Позволяет сохранять ограничения для объектов в отдельном файле во время экспорта схемы. Файл будет назван CONSTRAINTS_OUTPUT, где OUTPUT — это значение соответствующей директивы. Для сжатия можно использовать расширение .gz или .bz2. По умолчанию все данные сохраняются в файле, указанном в OUTPUT. Эта директива используется только с типом экспорта TABLE.

Ограничения можно быстро импортировать в Postgres Pro с типом экспорта LOAD, чтобы создавать их параллельно, используя несколько соединений (-j или JOBS).

Позволяет сохранять индексы в отдельном файле во время экспорта схемы. Файл будет назван INDEXES_OUTPUT, где OUTPUT — это значение соответствующей директивы. Для сжатия можно использовать расширение .gz или .bz2. По умолчанию все данные сохраняются в файле, указанном в OUTPUT. Эта директива используется только с типами экспорта TABLE и TABLESPACE. С типом экспорта TABLESPACE команды ALTER INDEX ... TABLESPACE ... записываются в отдельный файл TBSP_INDEXES_OUTPUT, который можно загрузить в конце миграции после создания индексов для их перемещения.

Индексы можно быстро импортировать в Postgres Pro с типом экспорта LOAD, чтобы создавать их параллельно, используя несколько соединений (-j или JOBS).

Позволяет сохранять объявления внешних ключей в отдельном файле во время экспорта схемы. По умолчанию внешние ключи экспортируются в основной выходной файл или CONSTRAINT_output.sql. Если директива задана, внешние ключи экспортируются в файл FKEYS_output.sql.

Позволяет сохранять результаты экспорта в отдельных файлах для каждой таблицы или представления. Файлы будут названы tablename_OUTPUT, где OUTPUT — это значение соответствующей директивы. Для сжатия можно использовать расширение .gz или .bz2 в директиве OUTPUT. С заданным значением 0 (по умолчанию) все данные сохраняются в одном файле, значение 1 включает эту функциональность. Используется только с типами экспорта INSERT или COPY.

Позволяет сохранять функции, процедуры и триггеры в отдельных файлах для каждого объекта. Файлы будут названы objectname_OUTPUT, где OUTPUT — это значение соответствующей директивы. Для сжатия можно использовать расширение .gz или .bz2 в директиве OUTPUT. С заданным значением 0 (по умолчанию) все данные сохраняются в одном файле, значение 1 включает эту функциональность. Используется только с соответствующим типом экспорта, а для пакетов предусмотрено другое поведение.

Если директива включена с типом экспорта PACKAGE, ora2pgpro создаёт отдельный каталог для каждого пакета с именем, называя его по имени пакета в нижнем регистре, и создаёт отдельные файлы для каждой функции/процедуры в этом каталоге. Если директива отключена, создаётся отдельный файл для каждого пакета с именем packagename_OUTPUT, где OUTPUT — это значение соответствующей директивы.

Если задано значение 1, перед загрузкой данных добавляется команда TRUNCATE TABLE. Используется только с типами экспорта INSERT или COPY.

Когда директива включена, команда добавляется, только если нет глобального предложения DELETE или для текущей таблицы (см. ниже).

Включает поддержку фильтрации по предложению DELETE FROM ... WHERE перед импортом данных с удалением строк вместо опустошения таблиц. Значение задаётся в таком формате: TABLE_NAME[DELETE_WHERE_CLAUSE], или если есть только одно предложение WHERE для всех таблиц, задаётся одно предложение DELETE в качестве значения. Можно задавать оба варианта одновременно. Примеры:

DELETE  1=1    # Применяется ко всем таблицам и удаляет все кортежи
DELETE  TABLE_TEST[ID1='001']   # Применяется только к таблице TABLE_TEST
DELETE  TABLE_TEST[ID1='001' OR ID1='002] DATE_CREATE > '2001-01-01' TABLE_INFO[NAME='test']

Последний вариант применяет два разных предложения DELETE ... WHERE к таблицам TABLE_TEST и TABLE_INFO и общее предложение DELETE по DATE_CREATE ко всем остальным таблицам. Если директива TRUNCATE_TABLE включена, она применяется ко всем таблицам, к которым не применяется DELETE. Такие предложения DELETE могут быть полезны при обычных изменениях.

Задайте для директивы значение 0, чтобы исключить вызов \set ON_ERROR_STOP ON из всех SQL-скриптов, создаваемых ora2pgpro. По умолчанию эта команда всегда присутствует, чтобы скрипт немедленно завершал работу при ошибках.

Включите эту директиву, чтобы использовать COPY FREEZE вместо обычно COPY для экспорта данных с уже замороженными строками. Это позволяет увеличить производительность при начальном добавлении данных. Строки будут замораживаться, только если загружаемая таблица была создана или опустошена в текущей подтранзакции. Работает только для экспорта в файл, когда не заданы ни параметр -J, ни директива ORACLE_COPIES или они равны 1. Может использоваться для импорта в Postgres Pro напрямую при тех же условиях, но -j и JOBS должны быть не заданы или равны 1.

По умолчанию ora2pgpro использует CREATE OR REPLACE в функциях и представлениях. Если нет необходимости переопределять существующие функции или представления, отключите эту директиву, и команды не будут содержать OR REPLACE.

Чтобы добавлять команду DROP ОБЪЕКТ IF EXISTS перед созданием объекта, включите эту директиву. Может быть полезно в итерационной работе. По умолчанию директива отключена.

Postgres Pro не поддерживает глобальные временные таблицы, но для эмуляции этой функциональности можно использовать расширение pgtt. Включите эту директиву, чтобы экспортировать глобальные временные таблицы.

Если включить эту директиву, ora2pgpro не будет добавлять заголовок в выходные файлы, будет записываться только преобразованный код.

По умолчанию ora2pgpro использует команду psql \i, чтобы выполнять создаваемые SQL-файлы. Если задать эту директиву, будет использоваться команда \ir, чтобы интерпретировать имена файлов относительно каталога, в котором расположен скрипт. За подробной информацией обратитесь к справке по psql.

Число строк, которые необходимо получить с обеих сторон для проверки корректности данных. По умолчанию сравниваются первые 10000 строк. При значении 0 сравниваются все строки.

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

Останавливает проверку данных таблицы после определённого количества несовпадающих строк. По умолчанию проверка останавливается после 10 строк с ошибками несовпадения.

Используйте эту директиву, чтобы указать тип трансформации, применяемый к столбцам при экспорте данных, в виде списка значений, разделённых точкой с запятой:

TABLE[COLUMN_NAME, код в целевом списке SELECT]

Например, чтобы заменить строку «Oracle» на «PostgreSQL» в столбце типа varchar2, используйте следующее значение:

TRANSFORM_VALUE   ERROR_LOG_SAMPLE[DBMS_TYPE:regexp_replace("DBMS_TYPE",'Oracle','PostgreSQL')]

Чтобы заменить все значения типа char(0) в строке пробельными символами:

TRANSFORM_VALUE   CLOB_TABLE[CHARDATA:translate("CHARDATA", chr(0), ' ')]

Выражение будет применяться в операторе SQL, используемом для извлечения данных из исходной базы данных.

Используйте эту директиву, чтобы задать пространство имён в качестве источника данных Postgres Pro, используя модуль Perl DBD::Pg следующим образом:

dbi:Pg:dbname=pgdb;host=localhost;port=5432

Он подключается к базе данных pgdb на localhost по TCP-порту 5432.

Обратите внимание, что эта директива используется только для экспорта данных, результаты других типов экспорта необходимо импортировать вручную с использованием psql или любого другого клиента Postgres Pro.

Чтобы использовать зашифрованное соединение SSL, необходимо добавить в строку подключения sslmode=require следующим образом:

dbi:Pg:dbname=pgdb;host=localhost;port=5432;sslmode=require

Эти директивы используются, чтобы задать имя пользователя и пароль. Если не задать пароль в PG_PWD и установить Perl-модуль Term::ReadKey, ora2pgpro запросит пароль интерактивно. Если имя пользователя не задано в PG_USER, его тоже нужно будет задать интерактивно.

Указывает, что записи WAL должны быть записаны на диск до того, как команда фиксации транзакции сообщит клиенту об успешном завершении. Функциональность равнозначна установке параметра synchronous_commit в файле postgresql.conf. Используется только для загрузки данных в Postgres Pro напрямую, по умолчанию синхронная фиксация отключена для увеличения скорости записи данных.

Эту директиву можно использовать для отправки начальных команд в Postgres Pro сразу после подключения, например, чтобы установить параметры сеанса. Директиву можно задавать несколько раз.

Если задано значение 1, переносимые числовые типы заменяются внутренними типами Postgres Pro. Тип данных Oracle NUMBER(p,s) преобразовывается в типы данных Postgres Pro real и float приблизительно. Если есть поля с денежными суммами, во избежание проблем с округлением десятичных чисел необходимо сохранить тот же тип Postgres Pro numeric(p,s). Задавайте эту директиву, только если точность обязательна, поскольку преобразование в numeric(p,s) выполняется медленнее, чем в real или double precision .

Если задано значение 1, переносимые числовые типы заменяются внутренними типами Postgres Pro. Тип данных Oracle NUMBER(p) преобразовывается в типы данных Postgres Pro smallint, integer или bigint в зависимости от точности. NUMBER без указания точности преобразуется в DEFAULT_NUMERIC (см. ниже).

NUMBER без указания точности преобразуется по умолчанию в bigint, только если PG_INTEGER_TYPE имеет значение true. Можно поменять значение переменной на любой тип Postgres Pro, такой как integer или float.

Если при преобразовании типов вы столкнулись с проблемами, используйте эту директиву, чтобы переопределить соответствие типов Oracle и Postgres Pro для преобразования ora2pgpro. Через запятую указываются пары типов тип Oracle:тип Postgres Pro. По умолчанию используется такой список:

DATA_TYPE       VARCHAR2:varchar,NVARCHAR2:varchar,NVARCHAR:varchar,NCHAR:char,DATE:timestamp(0),LONG:text,LONG RAW:bytea,CLOB:text,NCLOB:text,BLOB:bytea,BFILE:bytea,RAW(16):uuid,RAW(32):uuid,RAW:bytea,UROWID:oid,ROWID:oid,FLOAT:double precision,DEC:decimal,DECIMAL:decimal,DOUBLE PRECISION:double precision,INT:integer,INTEGER:integer,REAL:real,SMALLINT:smallint,BINARY_FLOAT:double precision,BINARY_DOUBLE:double precision,TIMESTAMP:timestamp,XMLTYPE:xml,BINARY_INTEGER:integer,PLS_INTEGER:integer,TIMESTAMP WITH TIME ZONE:timestamp with time zone,TIMESTAMP WITH LOCAL TIME ZONE:timestamp with time zone

Имя директивы и определяемый список должны записываться в одной строке.

Обратите внимание, что если обнаруживаются столбцы типа RAW(16) и RAW(32) или в столбце типа RAW стоит значение по умолчанию SYS_GUID(), ora2pgpro автоматически преобразует тип столбца в uuid, что правильно в большинстве случаев. Такие данные автоматически переносятся как данные типа Postgres Pro uuid, предоставляемого модулем uuid-ossp.

Для замены типа с указанием точности и масштаба необходимо экранировать запятую с помощью символа обратной косой черты. Например, для преобразования всех значений типа NUMBER(*,0) в bigint вместо numeric(38), запишите так:

DATA_TYPE       NUMBER(*\,0):bigint

Записывайте только тот тип, который необходимо переопределить, не следует копировать все значения преобразования по умолчанию.

Преобразование BFILE имеет ряд особенностей. Если указать целевой тип TEXT, значения будут содержать только полный путь к внешнему файлу. Если указать BYTEA (по умолчанию), ora2pgpro экспортирует содержимое BFILE как bytea. Если указать целевой тип EFILE, ora2pgpro экспортирует данные как записи EFILE: (DIRECTORY, FILENAME). Используйте тип экспорта DIRECTORY, чтобы извлечь каталоги и права для этих каталогов.

SQL-функции для получения пути к BFILE нет, ora2pgpro создаёт её с использованием пакета DBMS_LOB.

CREATE OR REPLACE FUNCTION ora2pg_get_bfilename( p_bfile IN BFILE )
RETURN VARCHAR2
AS
    l_dir   VARCHAR2(4000);
    l_fname VARCHAR2(4000);
    l_path  VARCHAR2(4000);
BEGIN
    dbms_lob.FILEGETNAME( p_bfile, l_dir, l_fname );
    SELECT directory_path INTO l_path FROM all_directories
        WHERE directory_name = l_dir;
    l_dir := rtrim(l_path,'/');
    RETURN l_dir || '/' || l_fname;
END;

Эта функция создаётся, только если ora2pgpro находит таблицу со столбцом типа BFILE и указан целевой тип TEXT. По окончании экспорта функция удаляется. Директива используется с типами экспорта COPY и INSERT.

SQL-функции для получения записи типа EFILE из BFILE нет, ora2pgpro создаёт её с использованием пакета DBMS_LOB.

CREATE OR REPLACE FUNCTION ora2pg_get_efile( p_bfile IN BFILE )
RETURN VARCHAR2
AS
    l_dir   VARCHAR2(4000);
    l_fname VARCHAR2(4000);
BEGIN
    dbms_lob.FILEGETNAME( p_bfile, l_dir, l_fname );
    RETURN '(' || l_dir || ',' || l_fnamei || ')';
END;

Эта функция создаётся, только если ora2pgpro находит таблицу со столбцом типа BFILE и указан целевой тип EFILE. По окончании экспорта функция удаляется. Директива используется с типами экспорта COPY и INSERT.

Чтобы указать целевой тип, используйте директиву DATA_TYPE.

DATA_TYPE       BFILE:EFILE

Тип EFILE — это пользовательский тип, который можно создать с помощью расширения external_file для портирования типа BFILE в Postgres Pro.

SQL-функции для получения содержимого BFILE нет, ora2pgpro создаёт её с использованием пакета DBMS_LOB.

CREATE OR REPLACE FUNCTION ora2pg_get_bfile( p_bfile IN BFILE ) RETURN
BLOB
  AS
        filecontent BLOB := NULL;
        src_file BFILE := NULL;
        l_step PLS_INTEGER := 12000;
        l_dir   VARCHAR2(4000);
        l_fname VARCHAR2(4000);
        offset NUMBER := 1;
  BEGIN
    IF p_bfile IS NULL THEN
      RETURN NULL;
    END IF;

DBMS_LOB.FILEGETNAME( p_bfile, l_dir, l_fname );
src_file := BFILENAME( l_dir, l_fname );
IF src_file IS NULL THEN
    RETURN NULL;
END IF;

    DBMS_LOB.FILEOPEN(src_file, DBMS_LOB.FILE_READONLY);
    DBMS_LOB.CREATETEMPORARY(filecontent, true);
    DBMS_LOB.LOADBLOBFROMFILE (filecontent, src_file, DBMS_LOB.LOBMAXSIZE, offset, offset);
    DBMS_LOB.FILECLOSE(src_file);
    RETURN filecontent;
END;

Эта функция создаётся, только если ora2pgpro находит таблицу со столбцом типа BFILE и указан целевой тип bytea (по умолчанию). По окончании экспорта функция удаляется. Директива используется с типами экспорта COPY и INSERT.

Типы ROWID и UROWID преобразуются в OID по умолчанию, но при импорте данных будут выдаваться ошибки. Аналогичного типа данных нет, поэтому используйте директиву DATA_TYPE, чтобы указать соответствующий тип Postgres Pro. Можно рассмотреть возможность замены на bigserial (последовательность с автоувеличением), text или uuid.

Иногда может потребоваться принудительно использовать определённый целевой тип: например, столбец, экспортируемый ora2pgpro с типом timestamp, можно принудительно экспортировать как date. Значение следует указывать в формате TABLE:COLUMN:TYPE через запятую. Если внутри определения типа нужна запятая или пробел, следует экранировать их с помощью символа обратной косой черты.

MODIFY_TYPE     TABLE1:COL3:varchar,TABLE1:COL4:decimal(9\,6)

Тип table1.col3 заменяется на varchar, а table1.col4 — на decimal с указанием точности и масштаба.

Если задан пользовательский тип столбца, ora2pgpro автоматически определяет составной тип и экспортирует данные с помощью функции ROW(). Некоторые пользовательские типы Oracle представляют собой массивы из значений встроенных типов, в этом случае можно преобразовать значения такого типа в простой массив из значений встроенных типов Postgres Pro. Для этого укажите необходимый целевой тип, и ora2pgpro преобразует данные в массив. Например, если есть такое определение в Oracle:

CREATE OR REPLACE TYPE mem_type IS VARRAY(10) of VARCHAR2(15);
CREATE TABLE club (Name VARCHAR2(10),
        Address VARCHAR2(20),
        City VARCHAR2(20),
        Phone VARCHAR2(8),
        Members mem_type
);

Здесь пользовательский тип mem_type — это простой массив строк, который можно преобразовать следующим образом:

CREATE TABLE club (
        name varchar(10),
        address varchar(20),
        city varchar(20),
        phone varchar(8),
        members text[]
) ;

Директиву следует указывать следующим образом:

MODIFY_TYPE     CLUB:MEMBERS:text[]

ora2pgpro преобразует все данные из этого столбца в нужный формат. Поддерживаются массивы значений только символьных и числовых типов.

По умолчанию вызовы функции TO_NUMBER в Oracle преобразовываются в функции приведения к типу numeric. Например, TO_NUMBER('10.1234') преобразуется в вызов to_number('10.1234')::numeric в Postgres Pro. Измените значение этой директивы, если требуется выполнять приведение к типу integer или bigint. Формат приведения к типу тоже можно указать в значении директивы: например, со значением TO_NUMBER_CONVERSION 99999999999999999999.9999999999 код выше будет преобразован в TO_NUMBER('10.1234', '99999999999999999999.9999999999'). Любое значение директивы, отличное от numeric, integer или bigint, принимается как маска формата. Если значение отсутствует, преобразование не выполняется.

По умолчанию varchar2 без ограничения размера преобразуется в text. Если необходимо сохранить varchar, отключите эту директиву.

Как правило, столбец идентификации должен иметь тип bigint, чтобы соответствовать последовательности с автоувеличением, поэтому ora2pgpro всегда принудительно использует bigint. Если по каким-либо причинам необходимо сохранить тип данных, заданный для столбца идентификации, отключите эту директиву.

Включите эту директиву, если необходимо удалять информацию о часовом поясе для функций TO_CHAR(). По умолчанию отключена.

Если с типом экспорта TABLE не нужно экспортировать все ограничения схемы, укажите в директиве SKIP список ненужных ограничений, разделённых пробелами или запятыми. Возможные значения:

SKIP    indexes,checks

В примере выше из экспорта исключаются индексы и ограничения-проверки.

Включите эту директиву, если необходимо добавить определение первичного ключа в оператор CREATE TABLE. Если директива отключена (по умолчанию), определение первичного ключа добавляется в оператор ALTER TABLE.

По умолчанию имена первичных и уникальных ключей в исходной БД Oracle игнорируются, они генерируются автоматически в целевой БД Postgres Pro по соответствующим правилам именования. Если необходимо сохранить имена первичных и уникальных ключей из Oracle, задайте для этой директивы значение 1.

Эта директива позволяет добавить параметр ON UPDATE CASCADE для внешнего ключа, когда есть ON DELETE CASCADE или всегда. Oracle не поддерживает эту функциональность, для добавления ON UPDATE CASCADE необходимо использовать триггер. Поскольку в Postgres Pro эта функциональность есть, можно выбрать метод добавления действия внешнего ключа. Для директивы доступны следующие значения:

При экспорте таблиц ora2pgpro, как правило, экспортирует ограничения как есть: если они неоткладываемые, то экспортируются как неоткладываемые. Однако неоткладываемые ограничения могут вызвать проблемы при попытке импорта данных в Postgres Pro. Задайте для директивы FKEY_DEFERRABLE значение 1, чтобы все ограничения внешнего ключа экспортировались как откладываемые.

Когда для директивы DEFER_FKEY задано значение 1, добавляется команда для откладывания всех ограничений внешнего ключа во время экспорта, а импорт выполняется в одной транзакции. Это будет работать, только если внешние ключи экспортируются как откладываемые и данные не импортируются в Postgres Pro напрямую (не задана директива PG_DSN). Ограничения проверяются в конце транзакции.

Кроме того, директиву можно включить, чтобы принудительно создавать все внешние ключи как откладываемые и изначально отложенные во время экспорта схемы (тип экспорта TABLE).

Если откладывание внешних ключей не представляется возможным из-за большого объёма данных в одной транзакции, внешние ключи не были экспортированы как откладываемые или импорт в Postgres Pro осуществляется напрямую, можно использовать директиву DROP_FKEY, чтобы удалить все внешние ключи до импорта данных и создать их заново в конце импорта.

Эта директива позволяет значительно увеличить скорость импорта данных путём удаления всех индексов, не являющихся автоматическими (индексы по первичным ключам), и создания их заново в конце импорта. Рекомендуется не импортировать индексы и ограничения до импорта всех данных.

Директива используется для отключения триггеров для всех таблиц при типе экспорта COPY или INSERT. Возможные значения: USER (отключение только пользовательских триггеров) и ALL (включая системные триггеры для ссылочной целостности). Значение по умолчанию 0 — для отключения триггера до импорта данных SQL-операторы не добавляются.

Если необходимо отключить триггеры во время миграции данных, при подключении под именем суперпользователя Postgres Pro задайте значение ALL, в противном случае —USER. Значение 1 равняется USER.

Со значением 1 директива отключает изменение последовательностей для всех таблиц, если указан тип экспорта COPY или INSERT. Полезно во избежание изменения последовательности во время миграции данных. Значение по умолчанию — 0, то есть последовательности меняются.

По умолчанию все данные типов, отличных от даты или времени, должны экранироваться. Если с этим возникают проблемы, задайте для данной директивы значение 1, чтобы отключить экранирование символов во время экспорта данных. Эта директива используется только с типом экспорта COPY. Включить/отключить экранирование символов для операторов INSERT можно с помощью директивы STANDARD_CONFORMING_STRINGS.

Эта директива определяет, будет ли обратная косая черта в обычных строковых константах ('...') восприниматься буквально, как того требует стандарт SQL. По умолчанию директива включена, то есть при её ненулевом значении ora2pgpro использует синтаксис спецпоследовательностей (E'...'). Директива работает точно так же, как аналогичный параметр в Postgres Pro, и используется во время экспорта только для операторов INSERT. Включить/отключить экранирование символов для операторов COPY можно с помощью директивы NOESCAPE.

Если для преобразования CHAR(n) из Oracle в varchar(n) или text в Postgres Pro задана директива DATA_TYPE, может потребоваться усечение данных. Если задать данную директиву, по умолчанию ora2pgpro автоматически находит и удаляет пробельные символы в начале и конце строки (значение BOTH). Если необходимо удалять пробелы только в начале строк, задайте значение LEADING. Если необходимо удалять пробелы только в конце строк, задайте значение TRAILING.

По умолчанию директива закомментирована, усекаются пробелы. Используйте директиву, чтобы поменять удаляемый символ: например, на -, чтобы усекать - в начале поля типа char(n).

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

Разрешает экранировать имена столбцов с использованием зарезервированных слов Oracle. В значении указывается список зарезервированных слов, разделённых запятыми. По умолчанию: audit,comment,references.

Включите эту директиву, если есть имена таблиц или столбцов, являющиеся зарезервированными словами Postgres Pro. ora2pgpro заключит имена таких объектов в кавычки.

Задайте для этой директивы значение 1, чтобы заменить пароль по умолчанию случайным паролем для всех пользователей во время экспорта GRANT.

В Postgres Pro материализованные представления создаются с помощью SQL-синтаксиса CREATE MATERIALIZED VIEW. Используйте эту директиву (по умолчанию включена), чтобы в ora2pgpro использовалась встроенная поддержка Postgres Pro. Отключите директиву, чтобы использовать старый вариант синтаксиса с таблицей и набором функций.

Задаёт номер мажорной версии целевой БД Postgres Pro. Например: 11 или 16. Значение по умолчанию — последняя мажорная версия на момент релиза.

Включает использование расширения btree_gin для создания индексов со сканированием битовой карты. Расширение должно быть создано. По умолчанию создаются индексы GIN, когда директива отключена — индексы B-деревья.

Используйте эту директиву, чтобы задать предполагаемый размер самого большого объекта в Oracle по свойству LongReadLen. Значение по умолчанию — 1 МБ, чего может быть недостаточно для извлечения файлов BLOB или CLOB. Если размер LOB превышает LONGREADLEN, DBD::Oracle возвращает ошибку «ORA-24345: A Truncation» (Усечение). По умолчанию: 1023*1024 байт.

	Важно
	Если увеличить значение этой директивы, по всей вероятности нужно уменьшить значение DATA_LIMIT. Даже если размер файла BLOB составляет 1МБ, при попытке прочитать 10000 таких файлов (значение DATA_LIMIT по умолчанию) понадобится 10 ГБ памяти. Попробуйте извлекать данные из таких таблиц по очереди и задать для DATA_LIMIT значение 500 или ниже, в противном случае может произойти нехватка памяти.

Если необходимо обойти ошибку «ORA-24345: A Truncation», задайте для этой директивы значение 1, чтобы данные усекались до значения LONGREADLEN. По умолчанию директива отключена, то есть будет выводиться предупреждение, если для LONGREADLEN задано недостаточно большое значение.

Отключите эту директиву, если необходимо загрузить содержимое файлов BLOB и CLOB полностью без использования указателей на LOB. Для этого необходимо выставить подходящее значение LONGREADLEN. Обратите внимание, что при этом скорость экспорта BLOB не увеличится, поскольку большая часть времени уходит на экранирование значений bytea и экспорт происходит построчно, а не блоками по DATA_LIMIT строк. По умолчанию директива включена, используются указатели на LOB.

Oracle рекомендует чтение и запись LOB порциями величиной, кратной размеру блоков LOB. Размер блока по умолчанию составляет 8КБ (8192). Последние тесты показывали улучшение производительности при более высоких значениях, таких как 512KБ или 4МБ.

Результаты быстрого теста на 30120 строках с файлами BLOB разного размера (200x5МБ, 19800x212КБ, 10000x942КБ, 100x17МБ, 20x156МБ) при DATA_LIMIT=100, LONGREADLEN=170МБ и общим размером таблицы 20 ГБ:

no lob locator  : 22m46,218s (1365 sec., avg: 22 recs/sec)
chunk size 8k   : 15m50,886s (951 sec., avg: 31 recs/sec)
chunk size 512k : 1m28,161s (88 sec., avg: 342 recs/sec)
chunk size 4Mb  : 1m23,717s (83 sec., avg: 362 recs/sec)

Таким образом, со значением LOB_CHUNK_SIZE в 4 МБ можно получить ускорение более чем в 10 раз. В этой директиве можно подбирать подходящее значение в зависимости от размера большинства объектов BLOB. Например, если размер большинства объектов LOB меньше 8KБ, достаточно задать для директивы значение 8192 для экономии памяти. Значение LOB_CHUNK_SIZE по умолчанию — 512000.

Указывает использовать функцию getStringVal() вместо getClobVal() для экспорта данных XML. По умолчанию 1, функциональность включена для обратной совместимости. Задайте значение 0, чтобы извлекать данные как CLOB. Обратите внимание, что значение XML, извлекаемое с помощью with getStringVal() не должно превышать заданный в VARCHAR2 предел (4000), в противном случае выдаётся ошибка.

Задайте для директивы значение O, если необходимо отключить экспорт миллисекунд из столбцов типа timestamp Oracle. По умолчанию миллисекунды экспортируются с использованием следующего формата:

'YYYY-MM-DD HH24:MI:SS.FF'

При отключенной директиве будет использоваться такой формат:

to_char(..., 'YYYY-MM-DD HH24:MI:SS')

По умолчанию миллисекунды экспортируются.

Задайте для директивы значение 1, чтобы не экспортировать комментарии к таблицам и столбцам. По умолчанию директива включена.

По умолчанию ora2pgpro задаёт для NLS_LANG значение AMERICAN_AMERICA.AL32UTF8, а для NLS_NCHAR — AL32UTF8. Не рекомендуется изменять эти значения, но в некоторых случаях это может быть полезно. При изменении значений этой директивы кодировка клиента на стороне Oracle изменится с изменением значений переменных окружения $ENV{NLS_LANG} и $ENV{NLS_NCHAR}.

По умолчанию ora2pgpro заставляет Perl использовать кодировку ввода-вывода UTF8 путём вызова прагмы Perl:

use open ':utf8';

Кодировку можно переопределить, задав директиву BINMODE: например, задайте значение :locale, чтобы использовать локаль системы, или iso-8859-7.

use open ':locale';
use open ':encoding(iso-8859-7)';

Если в NLS_LANG задана локаль, отличная от кодировки UTF8, можно дополнительно указать эту директиву. Для большинства случаев оставьте директиву закомментированной.

Во избежание проблем кодировка клиента Postgres Pro автоматически указывается как UTF8. Если не используется значение NLS_LANG по умолчанию, может понадобиться изменить кодировку клиента Postgres Pro.

Список поддерживаемых Postgres Pro наборов символов описан в разделе Поддержка кодировок.

Включите эту директиву, чтобы использовать кодировку UTF8 для экспортируемого кода PL/SQL. Директива может быть полезна в особых случаях.

Включает/отключает преобразование PL/SQL в PL/pgSQL. По умолчанию включено.

ora2pgpro может заменять все условия с тестом на NULL вызовом функции coalesce(), чтобы имитировать поведение Oracle, где пустые строки считаются равными NULL.

(field1 IS NULL) is replaced by (coalesce(field1::text, '') = '')
(field2 IS NOT NULL) is replaced by (field2 IS NOT NULL AND field2::text <> '')

Такая замена может потребоваться, чтобы приложение работало аналогично, но рекомендуется преобразовывать пустые строки в NULL, поскольку Postgres Pro воспринимает их по-разному.

Включает экспорт функций empty_clob() и empty_blob() как NULL вместо пустой строки для первой и \x для второй. Если использование NULL в столбце допускается, это поможет увеличить скорость экспорта при наличии большого количества пустых больших объектов. По умолчанию точно сохраняются данные из Oracle.

Если необходимо экспортировать пакеты как простые функции, а не схемы, можно заменить все вызовы package_name.function_name. Если отключить директиву PACKAGE_AS_SCHEMA, ora2pgpro заменит все вызовы package_name.function_name() на package_name_function_name(). По умолчанию пакеты экспортируются как схемы.

Замена будет производиться во всех операциях DDL или коде, разбираемом при преобразовании кода PL/SQL в PL/pgSQL. При этом должна быть включена директива PLSQL_PGSQL, или в командной строке передан параметр -p.

Включите эту директиву, если не работает модификация стандартного синтаксиса Oracle для OUTER JOIN (+). В этом случае ora2pgpro не будет модифицировать такой код, по умолчанию сейчас производится модификация простой формы правого внешнего соединения.

По умолчанию ora2pgpro преобразует вызов функции Oracle SYS_GUID() в вызов функции uuid_generate_v4 расширения uuid-ossp. Чтобы использовать вместо неё функцию gen_random_uuid расширения pgcrypto, можно задать в качестве значения этой директивы имя функции. По умолчанию используется uuid_generate_v4.

Обратите внимание, что если обнаруживаются столбцы типа RAW(16) и RAW(32) или в столбце типа RAW стоит значение по умолчанию SYS_GUID(), ora2pgpro автоматически преобразует тип столбца в uuid, что правильно в большинстве случаев. В этом случае данные автоматически переносятся как данные типа Postgres Pro uuid, предоставляемого модулем uuid-ossp.

По умолчанию функции Oracle помечаются как STABLE, поскольку они не изменяют данные, кроме как в PL/SQL с назначением переменных или в качестве условного выражения. Отключите эту директиву, чтобы утилита ora2pgpro создавала такие функции как VOLATILE.

По умолчанию ora2pgpro оставляет вызовы COMMIT/ROLLBACK без изменений, чтобы пользователь проверил логику функции. Включите эту директиву, когда исходный код Oracle исправлен или необходимо закомментировать эти вызовы.

В процедурах PL/SQL вызовам SAVEPOINT часто сопутствуют команды ROLLBACK TO savepoint_name. Когда директива COMMENT_COMMIT_ROLLBACK включена и вызовы SAVEPOINT также нужно закомментировать, включите эту директиву.

Во время преобразования кода PL/SQL в PL/pgSQL утилитаora2pgpro заменяет все строковые константы на текст в одинарных кавычках. Если в динамических вызовах используются местозаполнители в строках, в данной директиве можно задать список регулярных выражений, которые заменяются на время разбора. Например:

STRING_CONSTANT_REGEXP         <placeholder value=".*">

Регулярные выражения в списке разделяются точкой с запятой.

В данной директиве задайте в качестве значения регулярное выражение с поиском подходящих строк для извлечения текстовой части, чтобы включить поддержку механизма альтернативных кавычек ('Q' или 'q'). Например, для переменной, заданной как

c_sample VARCHAR2(100 CHAR) := q'{This doesn't work.}';

следует использовать регулярное выражение:

ALTERNATIVE_QUOTING_REGEXP     q'{(.*)}'

ora2pgpro использует разделитель $$, результат будет следующим:

c_sample varchar(100) := $$This doesn't work.$$;

Значение данной директивы представляет собой список регулярных выражений, разделённых точкой с запятой. Обязательно указать часть поиска подходящих строк (в скобках) для каждого выражения, если необходимо восстановить строковую константу.

Включите эту директиву, если необходимо использовать функции, определённые в библиотеке orafce, и не преобразовывать вызовы этих функций с помощью ora2pgpro.

По умолчанию ora2pgpro заменяет функции add_month(), add_year(), date_trunc() и to_char(), но можно использовать версии этих функций из orafce, которые не требуют преобразования кода.

Содержит список экспортируемых пакетов, разделённых запятыми. Используется только с типом экспорта PACKAGE и только последнее вхождение в файле конфигурации.

Содержит список исключаемых из экспорта пакетов, разделённых запятыми. Используется только с типом экспорта PACKAGE и только последнее вхождение в файле конфигурации.

Если задано значение 1, автономные транзакции экспортируются напрямую как автономные транзакции Postgres Pro.

Со значением 1 выводятся подробные сообщения.

Общие директивы ora2pgpro можно записать в отдельном файле и импортировать этот файл в другие файлы конфигурации, используя директиву IMPORT следующим образом:

IMPORT  commonfile.conf

При этом все директивы из файла commonfile.conf будут импортированы в текущий файл конфигурации.