Формат файла конфигурации
Файл конфигурации (шаблон) используемый Data Pump for PostgreSQL состоит из нескольких разделов, каждый из которых соответствует конкретной группе настроек, указанных на разных шагах Мастера переноса баз данных.
[#General#]
В этом разделе хранятся общие сведения об утилите:
|
Параметр |
Описание |
|
Product |
внутреннее название продукта |
|
Version |
[Source]
В этом разделе хранятся параметры подключения к источнику данных. Эти параметры указываются на Первом шаге Мастера и являются обязательными для заполнения.
|
Параметр |
Описание |
|
ConnectionString |
Строка подключения источника данных |
[#Comment#]
Комментарии к файлу шаблона.
|
Параметр |
Описание |
|
Line<N> |
текст комментария |
N - идентификатор строки
Пример:
Line0=Data Pump for PostgreSQL
Line1=Template file #1
Line2=Pumping tables from MS Access to PostgreSQL
[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 PostgreSQL |
|
StopScriptOnError |
0 = выполнение скрипта не остановился при возникновении ошибки 1 = выполнение скрипта остановился при возникновении ошибки |
|
ShowExecutedStatements |
0 = в разделе Script execution information area на Шаге 6не отображается информация о выполнении скрипта. 1 = в разделе Script execution information area на Шаге 6не отображается информация о успешном выполнении скрипта. |
|
AlwaysSkipSuccExecuted |
0 = при следующем выполнении скрипта на Шаге 6 сообщения об успешно выполненных операторах появятся. 1 = при следующем выполнении скрипта на Шаге 6 сообщения об успешно выполненных операторах не появятся. |
|
ClearTablesBeforeImport |
0 = не очищать таблицу назначенной базы данных PostgreSQL перед импортом данных на Шаге 8. 1 = очищать таблицу назначенной базы данных PostgreSQL перед импортом данных на Шаге 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 PostgreSQL |
|
SchemasMappingNew |
Название новой схемы Data Pump for PostgreSQL |
|
GenerateDropTableStmt |
0 = не добавлять в скрипт операторы DROP для таблиц. 1 = добавлять в скрипт операторы DROP для таблиц. |
|
DefaultTableCollation |
правило сравнения символьных данных. |
|
DefaultTableType |
способ хранения, который будет применен ко вставленным таблицам по умолчанию |
|
UseCopyStatement |
0 = Использовать для вставки данных оператор INSERT 1 = Использовать для вставки данных оператор COPY |
[Target]
В этом разделе хранятся параметры подключения для целевой базы данных PostgreSQL.
|
Параметр |
Описание |
|
Host |
хост, где находится источник данных (если Удаленный, то значение параметра = 1) |
|
Login |
логин |
|
Password |
пароль для идентификации входа (с шифрованием) |
|
RemoteIndex |
0 = локальное соединение (сервер установлен на этом компьютере) 1 = соединение с сервером по сети |
|
DataBase |
имя назначенной базы данных |
|
DatabaseActions |
cdtCreate = создать новую базу, куда будут помещены данные. cdtSelectExisting = подключиться к уже существующей базе. cdtRecreate = пересоздать назначенную базу данных. |
|
Charset |
кодировка |
|
Port |
порт для подключения к PostgreSQL |
|
UseSSL |
0 = SSL протокол не используется 1 = SSL протокол используется |
|
UseCompProtocol |
0 = не использовать протокол сжатия данных. 1 = использовать протокол сжатия данных. |
|
QuotesIdentifiers |
0 = идентификаторы не будут заключены в открывающие кавычки. 1 = все идентификаторы будут заключены в открывающие кавычки. |
|
InteractiveMode |
0 = для задания ограничения времени подключения используется переменная wait_timeout из файла my.cnf. 1 = для задания ограничения времени подключения используется переменная interactive_timeout из файла my.cnf. |
|
TunnelType |
тип туннелирования: SSH, HTTP, или без туннелирования (TunnelType = ttNotUse) |
|
SSHHostName |
имя сервера, на котором запущен SSH сервер |
|
SSHPort |
порт SSH сервера на удаленном хосте |
|
SSHUserName |
имя пользователя на сервере (пользователь SSH сервера, а не сервера PostgreSQL) |
|
SSHPassword |
идентификационная фраза (passphrase) пользователя SSH сервера |
|
SSHKeyFile |
путь к Ключевому файлу, используемому для подключения (если SSHUseKeyFile = True) |
|
SSHUseKeyFile |
True = SSH Private Key используется False = SSH Private Key не используется |
|
HTTPUrl |
это адрес, где находится скрипт emsproxy.php (для HTTP туннелирования) |
[{TBL}<table_name>]
В этом разделе укажите параметры создаваемой назначенной таблицы и параметры импорта данных. Эти параметры задаются на Шаге 5 и Шаге 7.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
|
Параметр |
Описание |
|
Name |
Имя таблицы |
|
NameSpace |
схема PostgreSQL |
|
Excluded |
1 = таблица исключена из импорта данных на Шаге 7 |
|
WhereClause |
текст условия WHERE для вставки данных |
[{FLD}<field_name>]
В этом разделе Вы можете изменять свойства полей. Эти параметры редактируются на Шаге 5.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
|
Параметр |
Описание |
|
Name |
Имя поля |
|
Type |
Тип данных поля |
|
NotNULL |
способность поля принимать значение NULL 0 = nullable 1 = NOT NULL |
|
AutoIncrement |
0 = Не автоинкрементное поле 1 = Автоинкрементное поле |
[{IND}<index_name>]
В этом разделе Вы можете просматривать и редактировать параметры назначенного индекса.
Важно: Этот раздел доступен только при редактировании динамических шаблонов.
|
Параметр |
Описание |
|
Name |
Имя индекса |
|
Unique |
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> |
Имя исходной таблицы |
|
TrgTableNS0<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 - идентификатор строки скрипта.