Раздел [Common]
В этой статье описывается раздел [COMMON] файла sqlways.ini и содержащиеся в нем параметры.
| Название опции | Описание |
|---|---|
| DSN | Имя источника данных. |
| USER | Имя пользователя. |
| PWD | Пароль. |
| TARGET | Целевая база данных. |
| TARGET_PRODUCT | Целевой продукт базы данных. |
| TARGET_VERSION | Версия целевой базы данных. |
| IMPORT_ORDER | Последовательность миграции. Значение по умолчанию: «Clean». |
| IMPORT_SYSTEM | Импортная система. Значение по умолчанию: Windows. |
| DIR | Экспортный каталог. |
| LOBDIR | Каталог для LOB-файлов. По умолчанию Конвертум Мастер сохраняет LOB-файлы в каталоге экспорта. |
| IMPORT_DIR | Импортный каталог. |
| IMPORT_LOBDIR | Импортный каталог для LOB-файлов. |
| OUTFORMAT | Выходной текстовый формат. |
| PREFETCHROWS | Счетчик предварительной выборки. Значение по умолчанию: 1000. |
| NONSTOP | Продолжить при возникновении ошибки. Значение по умолчанию: «Yes». |
| REGISTRATION_NAME | Указывает регистрационное имя. Этот параметр можно использовать для исправления пользовательских инструментов или когда доступ к реестру для чтения информации о лицензии ограничен. |
| REGISTRATION_NUMBER | Указывает регистрационный номер. Используйте этот параметр, если доступ к реестру для чтения информации о лицензии ограничен. |
| TEST | Эта опция определяет, нужно ли генерировать сценарии тестирования для целевой базы данных. Подробнее о том, как использовать эту опцию, можно прочитать в этой статье: Как тестировать преобразованный SQL-код Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| MAX_NUMBER_OF_TEST_CALLS | Управляет количеством операторов вызова опции TEST. Значение по умолчанию — 10. |
| GENRPT | Параметр, определяющий, создавать ли отчет HTML или нет. Значение по умолчанию — «Yes». Возможные значения: «Yes», «No». |
| CONVERT_VIEW2TABLE | Параметр, определяющий, преобразовывать ли все выбранные представления в таблицы или нет. Данные для таблиц будут извлечены из исходной базы данных с помощью select, указанного в представлении. Значение по умолчанию: «No». Возможные значения: «Yes», «No». |
| FN_WITH_EXC2SP | Если внутри функции есть блок EXEPTION с WHEN OTHERS, он будет преобразован в процедуру с блоком TRY CATCH. Значение по умолчанию: «No» или Пусто. Возможные значения: «Yes», «No». |
| OPTION_VARYING_PARSING | Параметр, управляющий способом разбора разделенных идентификаторов из Informix. По умолчанию в Informix двойные кавычки представляют строковый литерал. Это поведение можно изменить с помощью опции DELIMIDENT. Если опция DELIMIDENT установлена в ON, можно использовать двойные кавычки для представления разделенных идентификаторов в базе данных Informix. Таким образом, если объект BL, такой как хранимая процедура или UDF, создан с этой опцией и использует внутри себя разделенные идентификаторы, даже если опция выключена, BL все равно будет работать правильно. Инструмент пытается сначала разобрать двойные кавычки как строковый литерал, используя опцию OPTION_VARYING_PARSING. Если возникает ошибка парсера, исходный код разбирается так, как если бы для DELIMIDENT было установлено значение ON - как разграниченный идентификатор. Возможные значения: «Yes», «No». |
| CONVERT_VIEW2TABLE | При установке этого параметра в значение «Yes» все представления, выбранные для преобразования, преобразуются в таблицы. Данные для таких таблиц извлекаются с помощью операторов select этих представлений. Значение по умолчанию: «No». Возможные значения: «Yes», «No». |
| USE_ODBC_FUNCTIONS | Если для этого параметра установлено значение «Yes», для извлечения данных из исходной базы данных будут использоваться только функции ODBC. Значение по умолчанию: «No». Возможные значения: «Yes», «No». |
| PRECACHE_OBJECTS | Эта опция повышает производительность инструмента при работе с большими базами данных. Если необходимо преобразовать количество таблиц, превышающее число, заданное в опции PRECACHE_TABLES_COUNT, включается оптимизация. Значение по умолчанию: «True». Возможные значения: «True», «False». |
| PRECACHE_TABLES_COUNT | Этот параметр определяет минимальное количество таблиц, которые будут предварительно кэшироваться, если для параметра PRECACHE_OBJECTS установлено значение «True». Значение по умолчанию: 100. |
| SUB_QUERY2VIEW | Параметр, определяющий, преобразовывать подзапросы из WITH Clause в представления или нет. Представления в этом случае создаются перед всем запросом, а псевдонимы подзапросов остаются такими же, как в источнике. Преобразование работает, если опция установлена в значение «Yes». Значение по умолчанию: «No». |
| USE_ANSI_CAST | Когда эта опция установлена в значение «Yes», для преобразования значений из одного типа данных в другой используется только скалярная функция CAST языка ANSI SQL. Значение по умолчанию: «No». Возможные значения: «Yes», «No». Поддерживаемые направления: Sybase ASA - PostgreSQL. |
| LOGICAL_FILES_PATH | Для миграции Logical Files из DB2 AS400 необходимо указать путь к файлам, в которых будет храниться определение LF. Конвертум Мастер сможет прочитать и проанализировать такое описание и преобразовать его в представление в целевой базе данных. Эту опцию следует устанавливать только в том случае, если вы мигрируете из DB2 AS400 и вам необходимо преобразовать логические файлы. |
| SOURCE_DB | Параметр, определяющий исходную базу данных для преобразования Embedded SQL. |
| TARGET_DB | Параметр, определяющий целевую базу данных для преобразования Embedded SQL. |
| API_SOURCE_DB | Опция, определяющая API базы данных для исходной базы данных для преобразования Embedded SQL. |
| API_TARGET_DB | Опция, определяющая API базы данных для целевой базы данных для преобразования Embedded SQL. |
| API_SOURCE_DB_VERSION | Параметр, определяющий версию API базы данных для исходной базы данных для преобразования Embedded SQL. |
| API_TARGET_DB_VERSION | Параметр, определяющий версию API базы данных для целевой базы данных для преобразования Embedded SQL. |
| PLACE_COMMENTED_SOURCE_END | Эта опция управляет тем, где в сгенерированном SQL-файле будет расположен комментированный исходный код объекта. Если для этой опции установлено значение «Yes», комментированный исходный код будет помещен в конец файла. Если эта опция установлена в значение «No», то закомментированный исходный код будет помещен в начало SQL-файла. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No». |
| LICENSE_INFO | Эта опция генерирует информацию о дате и времени конвертации, версии и владельце лицензии внутри сконвертированного SQL-кода. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| GENERATE_VERSION_TIMESTAMP | Эта опция генерирует информацию о дате/времени конвертации и версии инструмента в SQL-коде. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| FB_DIALECT | Эта опция определяет номер диалекта, который будет использоваться для подключения к базе данных FIREBIRD. |
| CACHE_OBJECTS_COUNT | Эта опция определяет количество объектов, которое необходимо указать для преобразования, чтобы запустить систему кэширования объектов. Если количество указанных объектов больше, чем число, указанное в опции, то будет запущена система кэширования. Если количество объектов меньше, то будет использовано обычное преобразование. |
| PARSE_DIRECTIVES | Эта опция определяет, должен ли инструментарий разбирать директивы в коде C++. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «Yes». |
| REMOVE_SRC_FORMATTING | Эта опция устраняет форматирование исходного кода, удаляя лишние разделители для направления из COBOL в JAVA. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| DETAIL_REPORT | Если установить значение «Yes», то будет сформирован подробный отчет с информацией о преобразованных объектах, который будет помещен в каталог экспорта в папку «Reports». Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| USE_SP_PRIMARYKEY | По умолчанию наш инструмент не должен извлекать первичные ключи, которые были определены с помощью системной процедуры «sp_primarykey» в базе данных Sybase ASE. Но если мы установим этот параметр в значение «Yes», инструмент также будет преобразовывать первичные ключи, определенные с помощью системной процедуры «sp_primarykey». Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| OMIT_ORACLE_HINTS | Поскольку подсказки Oracle специфичны только для базы данных Oracle, по умолчанию эти части кода комментируются. Если для опции OMIT_ORACLE_HINTS установлено значение «Yes», все подсказки Oracle будут опущены во время конвертации. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| SHORTCUT_JOINS | Эта опция определяет, следует ли удалять ключевое слово OUTER из джойнов. Если для этой опции установлено значение «Yes», то OUTER будет удалено. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| EMBEDDED_SQL_CONVERSION_OFF | Эта опция отключает преобразование встроенных утверждений, содержащих ключевые слова, указанные в этой опции. Пользователь может указать несколько ключевых слов, используя запятую «,» в качестве разделителя. Значение по умолчанию - Пусто. |
| PATTERNS_LOGS | Если установлено значение «Yes», то после запуска преобразования будет собрана подробная информация о времени выполнения каждого шаблона преобразования и сохранена в xml-файл в каталоге PatternsLogs.
После конвертации папка PatternsLogs будет создана в каталоге экспорта. Возможные значения: «Yes», «No» или Пусто. Значение по умолчанию: «No» или Пусто. |
| IMPORT_CLIENT_OPTIONS | Эта опция добавляет в командную строку дополнительные параметры импорта, указанные в этой опции для целевого MySQL. Возможные значения: https://dev.mysql.com/doc/refman/8.0/en/mysql-command-options.html или Пусто. Значение по умолчанию: Пусто. Пример использования |
| SOURCE_ENCODING | Опция указывает, в какой кодировке будут находиться исходные файлы. Если вы неправильно укажете значение этой опции, то Конвертум будет некорректно вычитать файл. Возможные значения: ANSI, UTF8, UTF16BE. Значение по умолчанию: ANSI. |
| TARGET_ENCODING | Опция указывает, в какой кодировке Конвертум будет записывать выходные файлы. Возможные значения: ANSI, UTF8. Значение по умолчанию: ANSI. |
| DESIGN_PATTERN | Для Informix 4GL to C# этот параметр работает следующим образом: Этот параметр определяет, следует ли преобразовывать исходные файлы в контроллеры с Swaggers-атрибутами только в одном направлении Тип источника: Приложение. Технология источника: Informix 4GL → Тип цели: Приложение. Приложение Тип: Web. Программная платформа: .NET Язык программирования: C# Тип пользовательского интерфейса: ASPNET. или нет. Он находится в разделе [Common]. Если опция имеет значение «Swagger», то исходные файлы должны быть преобразованы в контроллеры с Swaggers-атрибутами. Если опция имеет значение «Пусто», то исходные файлы должны быть преобразованы в обычные контроллеры. Возможные значения: «Swagger» или Пусто. Значение по умолчанию: «Swagger». Пример использования Для Delphi, Pascal, Oracle Forms, CPP, PB Scripts опция работает следующим образом: Параметр определяет, следует ли преобразовывать исходные файлы в файлы *.cs, используя паттерн MVVM и фреймворк Convertum. Тип источника: Приложение. Технология исходных текстов: Delphi или Pascal или Oracle Forms или CPP или PBScripts → Целевой тип: Приложение. Тип приложения: Desktop. Программная платформа: .NET Язык программирования: C# Тип пользовательского интерфейса: WPF. или нет. Он находится в разделе [Common]. Если опция имеет значение «MVVM», то исходные файлы должны быть преобразованы в файлы с шаблоном MVVM. Если опция имеет значение «Пусто», то исходные файлы должны быть преобразованы в обычные файлы. Возможные значения: «MVVM» или Пусто. Значение по умолчанию: «MVVM». Пример использования |
| TABLES_DDL | Вы можете указать путь к сохраненному DDL таблиц, чтобы он использовался при конвертации для определения списка и типов колонок.
Для этого задайте путь к этому файлу в настройках, например: TABLES_DDL=d:\Migration\tables.sql Возможные значения: Путь и Пусто. Значение по умолчанию: Пусто. Пример использования |
| OBJECT_INFO | Опция, включающая сбор статистики. Она работает, если source=target. Опция разбирает файл и собирает информацию о нем, записывая ее в файл statistics_tmp.xml, затем объединяет информацию между файлами и записывает ее в файл Statistics.xml. Возможные значения: «Yes» или «No». Значение по умолчанию: «No». |
| OBJECT_INFO_DIR | Значение по умолчанию: DSN, путь, где находится файл статистики и другие файлы с дополнительной информацией о конвертации, такие как TableInfo.ddl, Statistics.xml и т.д. Во время преобразования по этому пути вызывается файл статистики. |
| ORACLE_USE_PREPROCESSOR | Обратите внимание: опция работает только для исходной базы данных Oracle!
Начиная с Oracle database 10g, для объектов разрешена условная компиляция. Компилятор компилирует выбранные части программы на основе условий, которые вы задаете с помощью директивы $IF. Этот параметр определяет, следует ли предварительно компилировать объекты перед преобразованием. Возможные значения: «Yes», «No». Значение по умолчанию: «No». Пример использования |
| BEFORE_IMPORT_SCRIPT | Опция, указывающая путь к SQL-скрипту, который будет выполнен перед началом импорта всех объектов. Скрипт запускается автоматически, если указан путь. Возможные значения: путь к SQL-скрипту. Значение по умолчанию: Пусто (bat-файл не создается). |
| AFTER_IMPORT_SCRIPT | Опция, указывающая путь к SQL-скрипту, который будет выполнен после завершения импорта всех объектов. Скрипт запускается автоматически, если указан путь. Возможные значения: путь к SQL-скрипту. Значение по умолчанию: Пусто (bat-файл не создается). |
Пример:
[common]
registration_name = ABC Inc.
registration_number = XXXX-YYYY-ZZZZЕсли у вас возникли вопросы о поддерживаемых опциях и функциях, обратитесь к нашим техническим специалистам: support@convertum.ru.