Online Documentation for Data Pump for PostgreSQL
Формат файла конфигурации
Файл конфигурации (шаблон) используемый 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 - идентификатор строки скрипта.