| Документація Database Tour | |
Файл відповідностей таблиць |
Файли відповідностей таблиць містять відповідності таблиць джерело-ціль для багатотабличних операцій експорту. Використовуйте файли відповідності таблиць при необхідності вжити одні і ті ж самі відповідності таблиць більше одного разу. Вони також можуть використовуватися під час експорту даних через командний рядок або файл операцій.
Підтримуються два типи форматів файлів відповідності таблиць: XML (рекомендований) та текст.
Даний формат є гнучким і розширюваним, тому рекомендується до використання скрізь, де можливо. Кожна відповідність повинна містити атрибути джерела із вказаним TableName (назва таблиці) та атрибути цілі зі змінним набором атрибутів.
Такі файли можуть бути створені або в діалозі Експорту на кроці Відповідність таблиць, або вручну з використанням текстового редактора. При створенні файлів вручну майте на увазі, що вони повинні відповідати стандартам XML та містити (при потребі) маркер порядку байтів (BOM) на початку.
Атрибути джерела
DatasetType
Вказує тип вихідного набору даних. Можливі значення: Table, SQLFile, SQLText. Якщо цей атрибут опущено, програма намагається визначити тип набору даних, використовуючи інші атрибути джерела.
DatasetTitle
Вказує заголовок набору даних. Він іноді використовується в інтерфейсі в якості заголовку відповідного вікна даних.
TableName
Вказує вихідну таблицю.
SQLFile
Вказує шлях до файлу з текстом вихідного запиту SQL.
SQLText
Вказує текст вихідного запиту SQL.
Атрибути цілі
TableName
Для цільового формату База даних вказує назву таблиці, до якої будуть експортуватися дані. Для цільового формату SQL вказує назву таблиці, що буде використовуватися в згенерованих командах SQL.
Цільові формати: База даних, SQL
FileName
Назва файлу, до якого будуть експортуватися дані.
Цільові формати: Всі, крім База даних
TableDescription
Опис цільової таблиці. В поточній версії застосовується лише для баз даних Oracle, SQL Server, PostgreSQL, MySQL. Для цільового формату База даних застосовується лише у випадку, коли цільова таблиця створюється під час екпорту. Для цільового формату SQL застосовується лише разом з оцпією Додати DDL.
Цільові формати: Database, SQL
SQLStatementType
Тип команди SQL (INSERT, UPDATE, DELETE і т.д.), що застосовується до поточної таблиці. Цей атрибут перекриває відповідну опцію, спільну для всіх таблиць.
Цільові формати: SQL
ExportMode
Режим експорту, що застосовується до поточної таблиці або файлу. Цей атрибут перекриває відповідну опцію, спільну для всіх таблиць (файлів).
Цільові формати: Всі
RecordLogFileName
Назва файлу, до якого буде записуватися журнал експортованих записів. Зараз цей атрибут може заповнюватися лише вручну а файлі відповідностей таблиць. Використовуйте його, якщо вам потрібен окремий журнал для кожної таблиці, а не спільний журнал для всіх таблиць.
Цільові формати: Всі
BadRecordLogFileName
Назва файлу, до якого буде записуватися журнал помилкових записів. Зараз цей атрибут може заповнюватися лише вручну а файлі відповідностей таблиць. Використовуйте його, якщо вам потрібен окремий журнал для кожної таблиці, а не спільний журнал для всіх таблиць.
Цільові формати: Всі
HtmlDocTitle
Текст, що буде розміщено в тегу Title документа HTML.
Цільові формати: HTML
HtmlTableId
Текст, що буде розміщено в атрибуті id тегу Table документа HTML. Повинен бути дійсний HTML атрибут id, унікальний в цільовому файлі. Якщо опущено або пустий, тег не буде мати атрибуту id.
Цільові формати: HTML
TableTitle
Текст, що буде розміщено над табличними даними в цільовому документі.
Цільові формати: HTML, RTF, PDF, Excel (XLSX), Excel (на основі XML), Excel (XLS), Excel (OLE), Word (OLE)
HtmlStepNo
Поточний крок експорту.
Цільові формати: HTML
SheetName
Назва цільового аркуша Excel, на який слід записувати вихідні дані. Повинна бути коректна назва аркуша Excel, унікальна в цільовому файлі. Якщо опущено або пуста, програма називає аркуші як Sheet1, Sheet2 і т.д. Зауваження: Інколи, якщо число рядків на аркуш перевищує значення, вказане в опціях, буде створено додаткові аркуші. За основу назв цих додаткових аркушів береться SheetName та додається суфікс _p2, _p3 і т.д.
Цільові формати: Excel (XLSX)
RangeName
Назва цільового діапазону клітинок Excel з експортованими даними (включно з заголовками колонок). Іменовані діапазони бачаться як таблиці при відкритті цільового файлу в програмах, що працюють з базами даних (включно з Database Tour). Повинна бути коректна назва діапазона Excel, унікальна в цільовому файлі. Якщо опущено або пуста, відповідний діапазон буде без назви. Зауваження: Інколи, якщо число рядків на аркуш перевищує значення, вказане в опціях, буде створено додаткові аркуші та додаткові діапазони. За основу назв цих додаткових діапазонів береться RangeName та додається суфікс _part2, _part3 і т.д.
Цільові формати: Excel (XLSX)
Відповідності полів
Опціональні відповідності полів джерело-ціль. Якщо опущено або пусті, відповідності полів будуються автоматично, виходячи зі структури полів таблиці-джерела та таблиці цілі (якщо остання існує).
Приклад файлу відповідності таблиць:
<?xml version="1.0" encoding="UTF-8"?>
<!-- Source-to-Target table mappings for Orders database -->
<TableMappings>
<Items>
<TableMapping>
<Source>
<TableName>customer.dbf</TableName>
</Source>
<Target>
<FileName>customer.html</FileName>
<TableTitle>Customers</TableTitle>
<HtmlDocTitle>customers</HtmlDocTitle>
<HtmlTableId>customer</HtmlTableId>
<HtmlStepNo>1</HtmlStepNo>
</Target>
<FieldMappings>
<Items>
<FieldMapping>
<Source>
<FieldName>CustId</FieldName>
</Source>
<Target>
<FieldName>Customer Id</FieldName>
</Target>
</FieldMapping>
<FieldMapping>
<Source>
<FieldName>CustName</FieldName>
</Source>
<Target>
<FieldName>Customer Name</FieldName>
</Target>
</FieldMapping>
</Items>
</FieldMappings>
</TableMapping>
<TableMapping>
<Source>
<TableName>order.dbf</TableName>
</Source>
<Target>
<FileName>order.html</FileName>
<TableTitle>Orders</TableTitle>
<HtmlDocTitle>orders</HtmlDocTitle>
<HtmlTableId>order</HtmlTableId>
<HtmlStepNo>2</HtmlStepNo>
</Target>
</TableMapping>
<TableMapping>
<Source>
<TableName>payment.dbf</TableName>
</Source>
<Target>
<FileName>payment.html</FileName>
<TableTitle>Payments</TableTitle>
<HtmlDocTitle>payments</HtmlDocTitle>
<HtmlTableId>payment</HtmlTableId>
<HtmlStepNo>3</HtmlStepNo>
</Target>
</TableMapping>
</Items>
</TableMappings>
Такі файли складаються з пар НазваТаблиціДжерела = НазваТаблиціАбоФайлуЦілі, одна відповідність на рядок. Рекомендується, щоб назви таблиць не містили знаку рівності. Рядки, що починаються на крапку з комою, вважаються коментарем і ігноруються програмою. Допускаються пусті рядки.
Такі файли можуть мати будь-яке розширення, їх можна створювати у будь-якому текстовому редакторі. При створенні файлів майте на увазі, що вони повинні відповідати стандартам XML та містити (при потребі) маркер порядку байтів (BOM) на початку.
Приклад файлу відповідностей таблиць у текстовому форматі:
;Source-to-Target table mappings for Orders database
Customer=Customer.htm
Order=Order.htm
Payment=Payment.htm