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 - идентификатор строки скрипта.