Раздел [MySQL]
В этой статье описывается раздел [MySQL] файла sqlways.ini и содержащиеся в нем опции.
| Название опции | Описание |
|---|---|
| BIN | Указывает каталог, в котором находятся утилиты MySQL. |
| HOST | Указывает имя удаленного хоста, на котором расположена целевая база данных MySQL. |
| DATABASE | Указывает имя базы данных, которое используется в сгенерированных скриптах для MySQL. |
| PORT | Эта опция задает номер порта, который будет использоваться для подключения к базе данных MySQL. |
| TARGET_VERSION | Указывает целевую версию базы данных MySQL. Если этот параметр пуст, будет использоваться последняя версия базы данных MySQL. Примечание: В зависимости от номера версии результаты конвертации могут отличаться. |
| USER | Указывает имя пользователя, которое используется в сгенерированных скриптах для MySQL. |
| PWD | Указывает пароль пользователя, который используется в сгенерированных скриптах для MySQL. |
| TABLE_TYPE | Эта опция определяет тип таблицы, который используется при создании таблиц в базе данных MySQL. MySQL поддерживает два типа таблиц: транзакционно-безопасные таблицы (InnoDB и BDB) и нетранзакционно-безопасные таблицы (HEAP, ISAM, MERGE и MyISAM). Например, при выборе table_type=InnoDB инструмент генерирует предложение TYPE=InnoDB в операторах CREATE TABLE для MySQL. |
| IMPORT_FROM_CLIENT | Если указано «Yes», ключевое слово LOCAL генерируется для команды MySQL LOAD DATA INFILE, которая используется для импорта данных в MySQL. Если указано LOCAL, файлы данных могут быть расположены на клиентском хосте. Если указано «No», ключевое слово LOCAL не генерируется, и файлы данных должны быть расположены на сервере перед импортом. Возможные значения - «Yes», «No». По умолчанию используется значение «Yes». |
| DATA_LOAD_OPTION | Если указано значение «Replace», существующие строки будут обновлены в существующей таблице на основе информации о первичном или уникальном ключе или добавлены в таблицу, если первичный ключ не совпадает. Если указано значение «Ignore», то существующие строки в таблице не будут обновляться, если значения первичного или уникального ключа эквивалентны значениям, существующим в таблице. Строки из текстового файла, не соответствующие первичному или уникальному ключу в таблице, будут вставлены. |
| ENABLE_PARTITIONING | Эта опция управляет преобразованием таблиц с разделами для направлений миграции Oracle в MySQL и MSSQL в MySQL. Если установлено значение «Yes», разметка для преобразования таблиц будет перенесена в целевую базу данных MySQL. В противном случае разметка будет опущена. Возможные значения: «Yes», «No». По умолчанию используется значение «No». |
| EXISTS2JOIN | Если установить значение «Yes», то все вхождения клаузы EXISTS в операторах SELECT будут заменены таблицами, помещенными в общую клаузу FROM, и условиями, помещенными в общую клаузу WHERE. Возможные значения - «Yes», «No». Значение по умолчанию - «No». |
| IN2JOIN | Если этот параметр установлен в значение «Yes», все вхождения формулы IN в условии WHERE будут перенесены в условия JOIN с формулой ON. Возможные значения - «Yes», «No». Значение по умолчанию - «No». |
| FOREIGN_KEY_CHECKS | Эта опция была добавлена для игнорирования ограничений по внешним ключам при операции LOAD DATA и для игнорирования проверки данных при добавлении ограничений FOREIGN KEY в таблицу. Возможные значения - «Yes», «No». Значение по умолчанию - «No». |
| CONVERT_PARTITIONS | Эта опция позволяет конвертировать разделы RANGE и LIST для направления конвертации Oracle в MySQL. Возможные значения - «Yes», «No» или пусто. Значение по умолчанию - «No» или пусто. |
| CHARACTER_SET | Этот параметр определяет кодировку, которая будет использоваться для хранения извлеченных данных в файлах в папке экспорта. Также в зависимости от назначенного значения эта опция может изменить преобразование типа данных VARCHAR в тип данных TEXT. Например, при миграции из базы данных Oracle в MySQL с кодировкой utf8 максимальная длина varchar отличается. В Oracle максимальное значение VARCHAR2 равно 32767, а в MySQL с utf8 - 21 844. Таким образом, если для этой опции установлено значение «UTF8», все типы данных VARCHAR2 с длиной более 21 844 будут преобразованы в MySQL в TEXT. |
| SSL_CA | Эта опция определяет путь к файлу в формате PEM, содержащему список доверенных центров сертификации SSL. Значение по умолчанию - Пусто. |
| SSL_MODE | Эта опция определяет состояние безопасности соединения с сервером. Возможные значения - PREFERRED, DISABLED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY и Пусто. Значение по умолчанию - Пусто. |
| KEY_LENGTH_FOR_BLOB_IDX | Если индекс MySQL создается на BLOB/TEXT столбцах, необходимо указать значение длины ключа для таких столбцов. Эта опция определяет значение длины ключа для BLOB/TEXT столбцов, которое используется в индексах. Возможные значения - числа от 0 и выше. Значение по умолчанию - 255. |
| ENABLE_LOCAL_LOAD | Эта опция управляет загрузкой локальных данных в базу данных MySQL. Если опция установлена в Yes, утилита mysql.exe будет запущена с опцией local-infile, которая позволяет использовать команду LOAD DATA LOCAL в файле .ldi для загрузки данных в целевой сервер с локальной машины. Возможные значения - «Yes», «No» или Пусто. Значение по умолчанию - «Yes». |
| CREATE_DEFINER | Эта опция контролирует, следует ли добавлять предложение definer в процедуры, функции и триггеры при миграции в базу данных MySQL. В этой опции необходимо указать пользователя, который будет использоваться в предложении CREATE DEFINER в сгенерированном коде MySQL. Если для этой опции установлено значение «No» или пусто, то предложение CREATE DEFINER не будет добавлено к объектам MySQL. Значение по умолчанию - «No» или Пусто. |
| PRESERVE_COMMENTS | Эта опция определяет, следует ли сохранять комментарии внутри SQL-кода в процессе импорта. Если опция установлена в значение «Yes», инструмент будет генерировать команду утилите mysql.exe с опцией «-comments», чтобы утилита mysql.exe сохранила комментарии внутри SQL-кода во время импорта. Если эта опция установлена в значение «No», то утилита будет использовать опцию «-skip comments» в утилите mysql.exe. Таким образом, утилита не будет сохранять комментарии внутри SQL-кода во время импорта. Возможные значения - «Yes» или «No». |
| CREATE_CONDITION_HANDLER | Эта опция была создана для эмуляции поведения Transact-SQL внутри хранимых процедур и функций MySQL при возникновении ошибки в одном из операторов внутри тела процедуры или функции. По умолчанию эта опция установлена в значение «Yes». В этом случае инструмент добавляет в каждый блок «BEGIN...END» CONDITION HANDLER, который обрабатывает ошибку, не завершая выполнение процедуры или функции. В этом случае ошибки скрываются. Если этот параметр установлен в значение «No», CONDITION HANDLER не добавляется, и первая ошибка, возникшая во время выполнения процедуры или функции, завершает ее выполнение. Сообщение об ошибке будет возвращено после завершения процедуры. Возможные значения - «Yes» или «No». Значение по умолчанию - «Yes». |
| USE_FN_CHARACTERISTIC | Этот параметр определяет, будет ли генерироваться блок характеристик для функций MySQL. Возможные значения - «Yes», «No» или Пусто. Значение по умолчанию - «No» или Пусто. |
| BIT_DATATYPE | Эта опция определяет, как преобразовывать типы данных BIT в базу данных MySQL. Значение по умолчанию - CHAR(1). |
| KEEP_INCLUDED_COLUMNS | Эта опция определяет, сохранять ли столбцы INCLUDED в определениях индексов или нет. Возможные значения - «Yes» или «No». Значение по умолчанию - «Yes» или Пусто. |
| VARCHAR_PAR_LEN | Эта опция определяет длину параметров VARCHAR при конвертации из Oracle в MySQL. Если эта опция пуста, то в качестве длины параметров varchar в MySQL будет использоваться 4000. Если эта опция установлена в некоторое значение, то это значение будет использоваться в качестве длины параметра VARCHAR в MySQL. |
| CLIENT_CHARACTER_SET | Эта опция добавляет опцию –default-character-set=charset_name в .bat-файл в командной строке для mysql.exe. Значение по умолчанию - Пусто. |
| RETURN_STATUS_TO | Эта опция определяет преобразование процедуры, возвращающей набор результатов из оператора RETURN. Если в MySQL эта опция установлена в значение «INOUT», то набор результатов из оператора RETURN будет преобразован в параметр INOUT процедуры. Если эта опция установлена в «LOCAL», то оператор RETURN должен быть проигнорирован и не должен создаваться дополнительный параметр в цели. Возможные значения - «INOUT» или «LOCAL». Значение по умолчанию - «INOUT». Пример использования |
| DEFAULT_AUTH_PLUGIN | Эта опция добавляет параметр -default-auth=plugin_name в командную строку утилиты mysql.exe при импорте объектов в базу данных SingleStoreDB. Опция -default-auth=plugin_name может быть указана в командной строке как подсказка о том, какой клиентский плагин программа может ожидать использовать, хотя сервер переопределяет ее, если серверный плагин, связанный с учетной записью пользователя, требует другого клиентского плагина. Возможные значения - mysql_native_password, caching_sha2_password, mysql_old_password, sha256_password и Пусто. Значение по умолчанию - Пусто. |
Пример:
[MySQL]
HOST=hostname
DATABASE=test
USER=root
SSL_CA=D:\test\ca-file.pem
SSL_MODE=VERIFY_IDENTITYЕсли у вас есть вопросы о поддерживаемых опциях или функциях, которые могут вам понадобиться в вашем проекте миграции, свяжитесь с нашей технической командой: support@convertum.ru.