Online Documentation for Data Pump for InterBase/Firebird
Формат файла конфигурации
Файл конфигурации (шаблон) используемый Data Pump for Interbase/Firebird состоит из нескольких разделов, каждый из которых соответствует конкретной группе настроек, указанных на разных шагах Мастера переноса баз данных.
[#General#]
В этом разделе хранятся общие сведения об утилите:
Параметр |
Описание |
Product |
внутреннее название продукта |
Version |
[Source]
В этом разделе хранятся параметры подключения к источнику данных. Эти параметры указываются на Первом шаге Мастера и являются обязательными для заполнения.
Параметр |
Описание |
ConnectionString |
Строка подключения источника данных |
[#Comment#]
Комментарии к файлу шаблона.
Параметр |
Описание |
Line<N> |
текст комментария |
N - идентификатор строки
Пример:
Line0=Data Pump for Interbase/Firebird
Line1=Template file #1
Line2=Pumping tables from MS Access to Interbase/Firebird
[Options]
В этом разделе хранятся параметры преобразования данных и варианты исполнения скрипта. Соответствующие параметры задаются на шагах 4 и 8 Мастер переноса баз данных.
Параметр |
Описание |
CommitAfter |
Количество записей, после которых необходимо вставить оператор COMMIT |
DisplayErrorMessages |
0 = сообщения об ошибках не отображаются в журнале импорта. 1 = сообщения об ошибках отображаются в журнале импорта. |
DetailErrorMessages |
0 = простые сообщения об ошибках в журнале импорта 1 = детализированные сообщения об ошибках в журнале импорта |
ShowTableProgress |
0 = не детализированная информация о ходе импорта в журнале импорта 1 = детализированная информация о ходе импорта в журнале импорта |
ConvertNames |
0 = не конвертируются имена объектов 1 = имена преобразуются в соответствии с правилами именования SQL92 |
NamesFormat |
nfAsIs = имена объектов остаются без изменений nfLowerCase = имена объектов преобразуются к нижнему регистру nfUpperCase = имена объектов преобразуются к верхнему регистру |
ConvertDefaultValues |
0 = значения по умолчанию источника данных не конвертируются 1 = значения по умолчанию источника данных преобразуются в значения по умолчанию назначенной базы данных. |
EnableScriptComments |
0 = комментарии отключены 1 = комментарии включены в тело скрипта |
DropIfExistDbStatement |
параметр не используется Data Pump for Interbase/Firebird |
StopScriptOnError |
0 = выполнение скрипта не остановился при возникновении ошибки 1 = выполнение скрипта остановился при возникновении ошибки |
ShowExecutedStatements |
0 = в разделе Script execution information area на Шаге 6не отображается информация о выполнении скрипта. 1 = в разделе Script execution information area на Шаге 6не отображается информация о успешном выполнении скрипта. |
AlwaysSkipSuccExecuted |
0 = при следующем выполнении скрипта на Шаге 6 сообщения об успешно выполненных операторах появятся. 1 = при следующем выполнении скрипта на Шаге 6 сообщения об успешно выполненных операторах не появятся. |
ClearTablesBeforeImport |
0 = не очищать таблицу назначенной базы данных Interbase/Firebird перед импортом данных на Шаге 8. 1 = очищать таблицу назначенной базы данных Interbase/Firebird перед импортом данных на Шаге 8. |
TrimStringSpaces |
0 = пробелы в конце строк не будут обрезаны. 1 = пробелы в конце строк будут обрезаны. |
QuoteNamesInImportSelQuery |
0 = не заключать в кавычки идентификаторы исходных объектов. 1 = заключать в кавычки идентификаторы исходных объектов. |
QuoteTemplate |
qtCustom = текущие символы кавычек (QuoteCharLeft, QuoteCharRight) qtDefault = кавычки, принятые по умолчанию в источнике данных. qtDoubleQuote = "..." qtSingleQuote = '...' qtApostrophe = `...` qtSquareBracket = [...] qtRoundBracket = (...) qtBrace = {...} qtAngleBracket = <...> |
QuoteCharLeft |
символ левой кавычки (if QuoteTemplate = qtCustom) |
QuoteCharRight |
символ правой кавычки (if QuoteTemplate = qtCustom) |
SchemasMapping |
Работа со схемами |
SchemasMappingExist |
Название схемы в источнике данных Data Pump for Interbase/Firebird |
SchemasMappingNew |
Название новой схемы Data Pump for Interbase/Firebird |
GenerateDropTableStmt |
0 = не добавлять в скрипт операторы DROP для таблиц. 1 = добавлять в скрипт операторы DROP для таблиц. |
DefaultTableCollation |
правило сравнения символьных данных. |
DefaultTableType |
способ хранения, который будет применен ко вставленным таблицам по умолчанию |
SetGenerators |
0 = не присваивать максимальное значение генераторам после завершения операции. 1 = присвоить максимальное значение генераторам после завершения операции. |
[Target]
В этом разделе хранятся параметры подключения для целевой базы данных Interbase/Firebird.
TunnelType |
тип туннелирования: SSH, HTTP, или без туннелирования (TunnelType = ttNotUse) |
SSHHostName |
имя сервера, на котором запущен SSH сервер |
SSHPort |
порт SSH сервера на удаленном хосте |
SSHUserName |
имя пользователя на сервере (пользователь SSH сервера, а не сервера Interbase/Firebird) |
SSHPassword |
идентификационная фраза (passphrase) пользователя SSH сервера |
SSHKeyFile |
путь к Ключевому файлу, используемому для подключения (если SSHUseKeyFile = True) |
SSHUseKeyFile |
True = SSH Private Key используется False = SSH Private Key не используется |
Параметр |
Описание |
Host |
Сервер, на котором расположена назначенная база данных. (если удаленный, то = 1) |
Login |
Имя пользователя на сервере |
Password |
пароль (зашифрован) |
RemoteIndex |
0 = локальное соединение (сервер установлен на этом компьютере) 1 = соединение с сервером по сети |
DataBase |
путь к файлу базы данных (*.gdb для InterBase или *.fdb для Firebird) |
DatabaseActions |
cdtCreate = создать новую базу, куда будут помещены данные. cdtSelectExisting = подключиться к уже существующей базе. cdtRecreate = пересоздать назначенную базу данных. |
PageSize |
размер страницы по умолчанию для новой базы данных (если DatabaseActions = cdtCreate, cdtRecreate) |
IsDialect3 |
диалект SQL для новой базы данных (если DatabaseActions = cdtCreate, cdtRecreate) 0 = Dialect 1 1 = Dialect 3 |
NetProtocol |
Сетевой протокол 0 = TCP/IP 1 = NetBEUI 2 = Novell SPX |
CharSet |
кодировка |
LibName |
путь к клиентской библиотеке Interbase/Firebird |
Port |
порт для подключения к Interbase/Firebird |
[{TBL}<table_name>]
В этом разделе укажите параметры создаваемой назначенной таблицы и параметры импорта данных. Эти параметры задаются на Шаге 5 и Шаге 7.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
Параметр |
Описание |
Name |
Имя таблицы |
Excluded |
1 = таблица исключена из импорта данных на Шаге 7 |
WhereClause |
текст условия WHERE для вставки данных |
[{FLD}<field_name>]
В этом разделе Вы можете изменять свойства полей. Эти параметры редактируются на Шаге 5.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
Параметр |
Описание |
Name |
Имя поля |
Type |
Тип данных |
Size |
Размер поля |
Scale |
Масштаб поля (если это возможно для выбранного типа данных). |
Default |
Значение по умолчанию для поля. |
CharSet |
кодировка данных поля |
Collate |
правило сравнения символьных данных |
NotNULL |
способность поля принимать значение NULL 0 = nullable 1 = NOT NULL |
AutoIncrement |
0 = Не автоинкрементное поле 1 = Автоинкрементное поле |
[{IND}<index_name>]
В этом разделе Вы можете просматривать и редактировать параметры назначенного индекса.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
Параметр |
Описание |
Name |
Имя индекса |
Unique |
0 = не уникальный индекс 1 = уникальный индекс |
Descending |
0 = Сортировка столбцов индекса производится в порядке возрастания. 1 = Сортировка столбцов индекса производится в порядке убывания. |
[{FK}<key_name>]
В этом разделе Вы можете просматривать и редактировать параметры ключей.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
Параметр |
Описание |
Name |
Имя ключа |
DeleteAction |
Действие, выполняемое при удалении (для внешних ключей): 0 = NO ACTION 1 = RESTRICT 2 = CASCADE 3 = SET NULL 4 = SET DEFAULT |
UpdateAction |
Действие, выполняемое при обновлении (для внешних ключей): 0 = NO ACTION 1 = RESTRICT 2 = CASCADE 3 = SET NULL 4 = SET DEFAULT |
[TypeMapping]
В этом разделе Вы можете указать соответствие типов данных, между данными, используемыми OLE DB провайдером и типами, существующими в назначенной базе данных.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
[ExcludedFromStructure]
В этом разделе Вы можете указать список объектов исходной базы данных, которые не будут перенесены в назначенную базу данных. Эти параметры задаются на Шаге 3.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
Параметр |
Описание |
{NSP}<schema_name> |
исключенная схема (если доступно) |
{TBL}<table_name> |
исключенная таблица |
{IND}<index_name> |
исключенный индекс |
{FK}<key_name> |
исключенный ключ |
[SelectedTables]
В этом разделе Вы можете указать список таблиц исходной базы данных, которые будут перенесены в назначенную базу данных. Эти параметры задаются на Шаге 3.
Важно: Этот раздел доступен только при редактировании фиксированных шаблонов.
Параметр |
Описание |
TableCount |
количество переносимых таблиц |
SrcTableNS<N> |
Имя исходной схемы (если доступно) |
SrcTableNM<N> |
Имя исходной таблицы |
TrgTableNM<N> |
Имя назначенной таблицы |
N - идентификатор таблицы.
Пример:
[SelectedTables]
TableCount=2
SrcTableNS0=dbo
SrcTableNM0=EMPLOYEE
TrgTableNM0=EMPLOYEE
SrcTableNS1=dbo
SrcTableNM1=DEPARTMENT
TrgTableNM1=DEPARTMENT
[Table<N>]
В этом разделе Вы можете указать список полей исходной базы данных, которые будут перенесены в назначенную базу данных. Эти параметры задаются на Шаге 3.
Важно: Этот раздел доступен только при редактировании фиксированных шаблонов.
Параметр |
Описание |
SrcField<N> |
Имя исходного поля |
TrgField<N> |
Имя назначенного поля |
FieldCount |
количество выбранных полей |
N - идентификатор поля.
Пример:
[Table1]
SrcField0=DepartmentID
TrgField0=DEPARTMENTID
SrcField1=Name
TrgField1=NAME
SrcField2=GroupName
TrgField2=GROUPNAME
SrcField3=ModifiedDate
TrgField3=MODIFIEDDATE
FieldCount=4
[FixedInfo]
В этом разделе хранятся результаты скрипта, представленные на Шаге 6.
Важно: Этот раздел доступен только при редактировании фиксированных шаблонов.
Параметр |
Описание |
Line<N> |
текст скрипта |
N - идентификатор строки скрипта.