Прежде, чем устанавливать программноге обеспечение "Мельница данных" необходимо установить и настроить программное обеспечение СУБД.

Для конфигурирования сервера БД необходимо последовать советам раздела "Конфигурирование сервера". В этом разделе описаны шаги, которые необходимо предпринять для установки сервера "с нуля". Если сервер БД у вас уже установлен и настроен, то использовать рекомендации этого раздела нет необходимости. Раздел описывает установку сервера БД минимальной поддерживаемой версии в минимально необходимой для работы "Мельницы данных" конфигурации. Если вы собираетесь использовать сервер БД для более широкого круга задач, то пользуйтесь руководствами по соответствующим СУБД.

Важно!

Документация по СУБД, а также любая другая информация, полученная от производителей СУБД, имеет абсолютный приоритет перед утверждениями настоящего документа.

На каждой рабочей станции должно быть установлено и настроено программное обеспечение клиентской части СУБД. Это, как правило, некий набор библиотек и компонентов, наличие которых необходимо для соединения с сервером БД. Для обеспечения рабочей станции этими компонентами необходимо последовать советам раздела Конфигурирование клиента. В этом разделе описаны шаги, которые необходимо предпринять для установки клиентской части СУБД "с нуля". Если клиентская часть СУБД у вас уже установлена и настроена, то использовать рекомендации этого раздела нет необходимости. Раздел описывает установку клиентской части СУБД минимальной поддерживаемой версии в минимально необходимой для работы "Мельницы данных" конфигурации.

В настоящий момент поддерживаемые СУБД приведены в таблице:

СУБД	Минимальная требуемая версия	Разработчик	Сопровождение в России
Firebird Firebird Open source	1.5.4.4910	http://www.firebirdsql.org Страница загрузки	http://www.ibase.ru
Oracle Oracle database Коммерческое ПО	9.2.0.1	http://www.oracle.com Страница загрузки	http://www.oracle.com/global/ru/index.html

Для установки ПП "Мельница данных" необходимо запустить файл setup.exe, расположенный на поставляемом компакт диске. После запуска программы установки необходимо следовать указаниям мастера установки.

Шаг 1: Выбор языка

Шаг 2: Информация о версии устанавливаемого ПП

Шаг3: Выбор каталога установки файлов ПП

Шаг 4: Выбор файла лицензии

Файл лицензии также расположен на поставляемом компакт-диске или высылается по электронной почте. В случае если не выбран никакой файл лицензий, то программа будет установлена в демонстрационном режиме. В последующем после получения файла лицензий необходимо будет переустановить ПП. Подробнее с лицензионным соглашением можно ознакомится в одноименном разделе настоящей документации.

Шаг 5: Выбор компонентов для установки

На данном шаге вам необходимо выбрать набор компонентов для установки на локальный компьютер. В зависимости от специфики использования рабочего места, на которое устанавливается ПО, необходимо выбрать тип установки. Предлагаемые типы установок:

• Рабочее место пользователя
• Рабочее место администратора
• Рабочее место разработчика
• Только построитель запросов
• По выбору

Для каждого из типов установки по умолчанию устанавливается свой набор компонентов. Вы можете дополнительно отметить тот или иной необходимый вам компонент для установки. Для выбора будут отображены только те компоненты, которые влачены в указанном вами лицензионном файле.

Полный перечень компонентов для установки:

1. Обозреватель данных
2. Построитель запросов
3. Утилита обслуживания баз данных
4. Утилита слияния баз данных
5. Инструменты разработчика / Инструмент поставки решений
6. Отладочный монитор
7. Документация

Для некоторых из вышеперечисленных компонентов также можно выбрать состав устанавливаемого компонента. Описание назначений поставляемых компонент описано в разделе "Поставляемые компоненты ПП" настоящей документации.

После указания всех параметров мастер установки скопирует файлы на локальный компьютер и создаст в меню программ папку с ярлыками к установленным компонентам:

Для создания БД необходимо вопрользоваться утилитой обслуживания базы данных, поставляемой в комплекте ПП. После запуска одноименного приложения откроется окно панели управления утилиты:

После запуска одноименного приложения откроется окно панели управления утилиты:

Для доступа к задачам необходимо заполнить параметры работы с базой данных:

1. Источник данных : Необходимо указать используемую СУБД.
2. База данных : Необходимо указать наименование создаваемого файла БД и его месторасположение. (Пример: c:\databases\base.fdb)
3. Пользователь : Указать имя пользователя (Администратора) для используемой СУБД. Для Interbase/FireBird - SYSDBA, для Oracle - SYS.
4. Пароль : Указать пароль пользователя (Администратора) для используемой СУБД. Для Interbase/FireBird - masterkey, для Oracle - SYS.

После заполнения полей параметров можно приступать к созданию БД. Для создания новой базы данных необходимо воспользоваться задачей "Создать новую БД". После нажатия кнопки "Выполнить" будут выполнены команды отображенные в окне "Командная строка".

В окне "Вывод консольного приложения" будет отображен результат выполнения команд по созданию БД. В случае успешного выполнения всех необходимых команд, БД будет создана по указанному в параметрах месторасположению.

После создания пустой БД необходимо наполнить ее системными объектами (метаданными) для последующей работы с ПП "Мельница данных". Для этого необходимо выполнить задачу "Синхронизировать базу данных". После нажатия кнопки "Выполнить" будет автоматически запущен отладочный монитор отображающий процесс наполнения БД необходимыми метаданными. Данный процесс может занять от одной до нескольких минут в зависимости от используемой СУБД и производительности сервера. (Обычно около минуты) По окончании процесса в окне "Вывод консольного приложения" будет отображен результат выполнения инициализации базы данных.

Все действия по созданию и инициализации БД выполнены. БД готова к эксплуатации.

После того, как база данных создана и инициализирована метаданными платформы, доступ к системе будет иметь один пользователь - администратор созданной БД. Добавление других пользователей, ролей пользователей и включение пользователей в роли выполняется в представлениях Пользователи и Роли в Системной форме. После начальной инициализации БД на вкладке Пользователи можно увидеть одного пользователя с именем, соответствующим логину администратора БД (Например, для FireBird пользователь SYSDBA), на вкладке Роли можно увидеть одну роль с наименованием Администраторы. На подчиненных вкладках этих представлений можно увидеть, что пользователь - администратор включен в роль Администраторы.

Профиль пользователя формируется путем определения для него:

1. Перечня доступных форм
2. Перечня доступных визуальных групп
3. Перечня групп запретов

Формирование профиля происходит одинаково как для роли, так и для отдельного пользователя. Однако рекомендуется формировать профили для ролей, а не для отдельных пользователей. В этом случае при подключении к системе новых пользователей, изменении параметров доступа для существующего пользователя достаточно будет включить пользователя в одну из ролей, или исключить его из роли. Роли рекомендуется формировать содержательным образом на основе распределения обязанностей реальных пользователей, работающих с прикладным решением.

Создание пользователя системы включает в себя два этапа:

1. Создание пользователя БД средствами используемой СУБД. Для этого наряду с возможностями каждой из СУБД Утилитой обслуживания БД предлагается действие Создать пользователя. Предлагаемые Утилитой по умолчанию пути к БД и параметры доступа требуют уточнения в зависимости от условий функционирования реальной БД. Задавать права доступа пользователя к объектам БД на данном этапе не надо.
2. В Системной форме на вкладке Пользователи создать нового пользователя при помощи соответствующего действия контекстного меню.

   Важно!

   В поле Имя нужно вветси строку, строго соответствующую логину пользователя БД в вернем регистре.

   Особых требований к полю Наименование не предъявляется. Однако рекомендуется вводить в это поле фамилию и имя реального пользователя системы, например, Смирнов Иван Николаевич, что позволить в последующем получать информативные данных об активности пользователей системы.

Создание ролей производится на вкладке Роли Системной формы при помощи действия Создать, вызываемого из контекстного меню. Имя и наименование роли могут быть любыми строками. Однако именовать роли по названиям соответствющих функциональных участков системы, например,

• Начальник отдела кадров
• Инспектора по работе с личными данными персонала
• Инспектора по социальным вопросам

В роль могут включаться как пользователи, так и другие роли. Для добавления в роль нового члена роли нужно выбрать роль на вкладке Роли, отрыть подчиненную вкладку Члены роли и вызвать на ней действие Создать. Поля формы параметров заполняются следующим образом:

• Пользователь - в этом поле необходимо выбрать либо одного из пользователей, либо одну из ролей. В зависимости от того, выбран ли пользователь или роль, будет меняться доступность следующих ниже полей.
• Основная роль - в этом поле можно установить значение Да или Нет. Если пользователь включен в нескольно ролей, то среди них можно выделить одну основную. Разработчик прикладного решения на платформе сможет использовать это значение для управления доступом к объектам системы. Поле доступно для выбора значения только в том случае, если в поле Пользователь выбран именно пользователь, а не роль.
• Добавить связанные роли - в этом поле можно установить значение Да или Нет. Поле доступно для выбора значения только в том случае, если в поле Пользователь выбрана роль. При установке значения Да в роль будут включены также все роли, входящие в выбранную. при установке значения Нет будет включена только одна роль без подчиненных ролей.

После включения пользователя в роль он получает права доступа ко всем визуальным группам и формам, а также к группам запретов, заданным для роли.

Визуальные группы создаются разработчиком прикладного решения. Работа с визуальными группами ведется в Системной форме на вкладке Визуальные группы. Каждая визуальная группа содержит набор форм и также может быть снабжена иконкой. Визуальные группы отображаются на Консоли управления, которая показывается при запуске системы.

Для каждой роли (или для отдельного пользователя) формируется перечень визуальных групп, которые будут ему доступны на Консоли управления. Если визуальных групп в прикладном решение не создано, или если пользователю не доступно ни одной визуальной группы, консоль управления не будет отображена. В этом случае при открытии системы пользователь увидит первую из доступных ему форм, которая открывается автоматически.

Для добавления новой визуальной группы, доступной роли или пользователю, необходимо выбрать роль или пользователя на соответствующей вкладке (Роли или Пользователи), отрыть подчиненное представление Доступные визуальные группы и выполнить в нем действие Создать. В форме параметров нужно выбрать одну из существующих визуальных групп. Если необходимо дать доступ к нескольким визуальным группам, действие создания нужно повторить.

Формы создаются разработчиком прикладного решения. Работа с визуальными группами ведется в Системной форме на вкладке Формы. Каждая форма представляет собой набор представлений, связанных друг с другом определенным образом. Иконки всех форм, доступных пользователю, отображаются на Панели инструментов в верхней части экрана. Нажимая на одну из иконок форм, пользователь может переключаться между ними. Если форма входит в одну из доступных пользователю визуальных групп, она отобразится на консоли управления. В этом случае переключаться между формами пользователь сможет как на Панели инструментов, так и на Консоли управления.

Для каждой роли (или для отдельного пользователя) формируется перечень форм, которые будут ему доступны на Консоли управления. При открытии системы пользователь видит первую из доступных ему форм, открываемую автоматически.

Для добавления новой формы, доступной роли или пользователю, необходимо выбрать роль или пользователя на соответствующей вкладке (Роли или Пользователи), отрыть подчиненное представление Доступные формы и выполнить в нем действие Создать. В форме параметров нужно выбрать одну из существующих форм. Если необходимо дать доступ к нескольким формам, действие создания нужно повторить.

Группы запретов могут формироваться как разработчиком прикладного решения, так и администратором системы. Работа с группами запретов ведется на соответствующей вкладке Системной формы. В каждую группу запретов включаются запреты трех видов:

• Запрет на класс
• Запрет на свойство
• Запрет на подпрограмму

Запреты на класс и свойство могут даваться как только на запись, так и на чтение и запись объектов. Наличие запретов для определенной роли или пользователя приводит к тому, что пользователь не видит или не имеет прав на модификацю объетов определенных классов или отдельных их свойств. Запреты на подпрограммы выражаются в том, что для пользователя не отображаются действия, вызывающие ряд подпрограмм.

Утилита обслуживания БД - консольное приложение. При запуске приложения оно сообщает о поддерживаемых режимах и ключах командной строки. Ключи указываются через пробел. Ключ должен начинаться символом "/". Для ключей, содержащих значения параметров, между ключем и значением должен быть пробел. Имена файлов и папок, содержащие пробелы, в командной строке должны быть заключены в кавычки.

При работе с утилитой общее правило состоит в том, что первым параметром передается строка соединения с БД, вторым параметром необязательная команда. Остальные параметры и ключи указываются в зависимости от выбранной команды.

Если работа утилиты завершилась успешно, то она возвращает код завершения 0. Если в процессе работы утилиты произошли ошибки, то код завершения будет равен 1. Если работа утилиты завершилась успешно, но были выданы предупреждения, то она возвращает код завершения 2.

Поддерживаемые команды:

Далее будут рассмотрены подробности работы каждого из режимов.

Для осуществления перекачки данных необходимо:

1. Иметь права владельца схемы в БД - приемнике.
2. Иметь права владельца схемы в БД - источнике.
3. Если не задан ключ /M, то БД - приемник должен быть пустой схемой, не содержащей никаких объектов.

Перекачка данных осуществляется в любом направлении. Ниже представлены варианты сочетания источников и приемников данных. В случае, если попытка использовать тот или иной оптимизационный механизм оказалась неудачной, производится стандартная перекачка.

Используемые параметры и ключи командной строки:

Для перекачки данных используюется команда pump. В строке соединения указывается БД-приемник, кроме случая перекачки данных из БД в папку, файл или zip-архив. Для всех случаев кроме случая перекачки данных из БД в папку, файл или zip-архив командная строка содержит кляузу pump from. Для случая перекачки данных из БД в папку, файл или zip-архив командная строка содержит кляузу pump to.

Пример

Перекача данных из БД Oracle в БД Firebird: dbsetup.exe fb#sysdba/masterkey@host:database pump from ora#dataowner/password@host/sid.dataowner Перекача данных из zip-архива в БД Firebird: dbsetup.exe fb#sysdba/masterkey@host:database pump from c:\dbbackup.zip Перекача данных из БД Firebird в zip-архив: dbsetup.exe fb#sysdba/masterkey@host:database pump to c:\dbbackup.zip

Ключ	Назначение
/J <Целое число>	Определяет число потоков, осуществляющих перекачку данных. По умолчанию соответствует количеству ядер процессора.
/H <Целое число>	Определяет базовое количество записей в блоке перекачки. По умолчанию - 1 млн. записей. Для таблиц, содержащих большие объекты (blob и/или clob) размер блока перекачки определяется как базовый размер блока, деленный на 100. Если источником является папка, файл или zip-архив - ключ игнорируется.
/M	Пропустить этап создания таблиц и последовательностей в БД (таблицы и последовательности должны быть созданы заранее).
/G	Пропустить этап заливки данных, произвести только создание таблиц и последовательностей в БД.
/K <Список таблиц>	Не перекачивать данные указанных таблиц. Список таблиц разделяется символом ";" (точка с запятой).
/NODBLINK	Принудительно отключает механизмы связи между БД на сервере.
/NOCSV	Принудительно отключает механизмы загрузки данных из внешнего файла.
/NOXML	Принудительно отключает механизмы cборки xml-документа на сервере.

При перекачке данных учитыватся табличное пространство ("группа файлов") каждой таблицы в случае, если это понятие релевантно для источника и приемника. При использовании папки, файла или zip-архива имя табличного пространства каждой таблицы сохраняется в файле RTTI, и будет использовано, если окажется релевантным. Если в приемнике имеется возможность разместить таблицу в табличное пространство с тем же именем, которое указано в источнике, то это будет сделано.

При перекачке данных таже осуществляется перенос последовательностей. При этом переносится текущее значение каждой из последовательностей. Значение кеша последовательности переносится только в том случае, если это понятие релевантно для источника и для приемника. При использовании папки, файла или zip-архива значение кеша сохраняется в файле Sequences, и будет использовано, если окажется релевантным.

После завершения перекачки данных в схеме-приемнике остаются следующие объекты:

• Таблицы данных.
• Первичные ключи таблиц данных.
• Последовательности.
• Заголовки системных объектов платформы.

Этот набор минимально достаточен, чтобы с помощью синхронизации (загрузив метаданные из таблиц, с ключем /T) восстановить метаданные БД в соответствующей схеме, и работать с ней средствами платформы.

Особенности перекачки данных в папку, файл или zip-архив:

При использовании папки она рассматривается как хранилище файлов перекачки. При использовании файла он рассматривается как хранилище файлов перекачки в формате Microsoft Compound File. При использовании zip-архива он рассматривается как хранилище файлов перекачки. Хранилище файлов перекачки содержит следующие файлы:

• FormatSettings - xml-файл с информацией о региональных настройках процесса, сформировавшего хранилище.
• Sequences - xml-файл с информацией о текущих значениях последовательностей.
• RTTI - xml-файл с информацией о таблицах и полях. Также содержит информацию о табличных пространствах.
• <Имя Таблицы> с возможным числовым постфиксом в скобках - xml-файл с данными таблицы в стандартном xml-представлении.
• #<Длина файла в 16-ричном представлении, 16 символов><CRC файла в 16-ричном представлении, 8 символов> - двоичный файл с содержимым blob/clob. Такие файлы формируются для объектов, чей размер превышает 1MB.

Остальные файлы в хранилище будут проигнорированы (если хранилище используется как источник) или удалены (если хранилище используется как приемник).

Если в качестве приемника используется zip-архив, то механизм перекачки данных будет использовать информацию об уже содержащихся в архиве файлах, и не будет повторно "пересжимать" уже имеющиеся файлы. Таким образом, можно удобно релизовать "инкрементальное резервное копирование", указывая в качестве приемника перекачки данных один и тот же zip-архив.

Стандартная процедура перекачки блока данных заключается в открытии однонаправленного курсора на основании запроса типа select... from "..." к таблице-источнику, подготовке запроса insert into "..."("ID",.....) values (:Param1, :Param2....) к приемнику, и многократному выполнению этого единожды подготовленного запроса по мере продвижения вперед по курсору-источнику. Все значения полей при этом проходят через клиентскую сторону, и заливка данных осуществляется по одной записи за одно выполнение запроса. Характерная скорость такой заливки - порядка 5000 записей в секунду.

Oracle

Оператор INSERT в процессах перекачки данных всегда формируется с подсказкой /*+ APPEND */.

Важно!

Описанные далее механизмы оптимизации не могут использоваться одновременно. Если какой-либо из них может быть использован в вашей ситуации - постарайтесь обеспечить условия, необходимые для их работы. Вы получите значительное ускорение перекачки.

Firebird

Будут формироваться и выполняться блоки вида 01execute block as 02 declare "ID" BIGINT; 03 declare "P0" SMALLINT; 04 ..... 05begin 06 for execute statement 'select "ID", .... from "...."' 07 on external data source '....' as user '...' password '....' 08 into :"ID",:"P0",..... do 09 insert into "...."("ID",....) 10 values (:"ID",:"P0",.....); 11end

Oracle

Механизм может быть использован, если пользователь-владелец схемы имеет право CREATE DATABASE LINK, и оператор create database link будет выполнен без ошибок. При этом будет создан link с именем "SYS$PUMP". После завершения процедуры перекачки данных link будет удален. Таким образом, можно в целях безопасности выдавать право CREATE DATABASE LINK владельцу схемы данных только на время перекачки данных. При этом генерируются и выполняются операторы вида 1INSERT /*+ APPEND */ INTO "..."("ID", ....) 2SELECT "ID", .... 3 FROM "..."@"SYS$PUMP" 4...

Postgres

Механизм может быть использован, если в БД установлено стандартное расширение "dblink", и оператор select public.dblink_connect('user=... password=.......') будет выполнен без ошибок. При этом генерируются и выполняются операторы вида 01do $$ 02declare 03 cnt int; 04begin 05 perform public.dblink_connect('user=... password=... ....'); 06 perform public.dblink_open('SYS$....', 'select T."ID", ..... from "...." T'); 07 loop 08 insert into "...." ("ID", .....) 09 select T."ID" from public.dblink_fetch('SYS$.....', 1000000) 10 as T("ID" bigint, .....); 11 get diagnostics cnt = row_count; 12 exit when cnt = 0; 13 end loop; 14end; $$

Механизм может быть принудительно заблокирован ключем /NODBLINK.

Firebird

Чтобы использовать загрузку из внешнего файла, необходимо, чтобы одновременно выполнялись следующие условия: Сервер БД выполняется на том же хосте, на котором происходит запуск dbsetup.exe (в строке соединения хост не указан, указан как localhost, указан как 127.0.0.1, указан так, чтобы совпадать с результатом вызова функции gethostname). Временная папка процесса dbsetup.exe (переменная окружения %TMP%) доступна сервису Firebird как источник внешних данных (в конфигурации FireBird - параметр ExternalFileAccess). Таблица не содержит полей типа BLOB. Таблица не содержит обнуляемых полей, все поля таблицы обязательные. Загружаемый блок содержит как минимум 1000 записей. В этом случае во временной папке будет создан временный файл, содержащий загружаемые данные в требуемом Firebird формате, и выполнены операторы: 1create table "DML..." external '.....' 2 ("ID" BIGINT, 3 ....); 4insert into "..."("ID", ...) 5 select "ID", .... 6 from "DML...."; 7drop table "DML...."; После чего временный файл будет удален.

Oracle

Чтобы использовать загрузку из внешнего файла, необходимо, чтобы одновременно выполнялись следующие условия: Сервер БД выполняется на том же хосте, на котором происходит запуск dbsetup.exe (в строке соединения хост не указан, указан как localhost, указан как 127.0.0.1, указан так, чтобы совпадать с результатом вызова функции gethostname). Владельцу данных доступна на чтение и запись хотя бы одна папка (directory). Этого можно достичь, например, такими операторами: Пример 1CREATE DIRECTORY dir_name AS 'D:\TEMP'; 2GRANT READ,WRITE ON DIRECTORY dir_name TO user_name; При этом папка (на диске) должна быть доступна на запись процессу dbsetup.exe. Оператор 01create table "DML...." 02( 03 .... 04) ORGANIZATION EXTERNAL ( 05 DEFAULT DIRECTORY .... 06 ACCESS PARAMETERS ( 07 RECORDS DELIMITED BY NEWLINE 08 FIELDS TERMINATED BY '....' 09 ) 10 LOCATION ('DML.....') 11) выполняется без ошибок. Созданная при этом таблица доступна для чтения. Таблица не содержит полей типа BLOB. Загружаемый блок содержит как минимум 1000 записей. В этом случае в папке, которая доступна, будет создан временный файл, содержащий загружаемые данные в требуемом Oracle формате, и выполнены операторы: 1create table "DML....." 2( 3 .... 4) ORGANIZATION EXTERNAL ( 5....); 6insert into "..."("ID", ...) 7 select "ID", .... 8 from "DML...."; 9drop table "DML...."; После чего временный файл будет удален.

Postgres

Чтобы использовать загрузку из внешнего файла, необходимо, чтобы одновременно выполнялись следующие условия: Сервер БД выполняется на том же хосте, на котором происходит запуск dbsetup.exe (в строке соединения хост не указан, указан как localhost, указан как 127.0.0.1, указан так, чтобы совпадать с результатом вызова функции gethostname). Временная папка процесса dbsetup.exe (переменная окружения %TMP%) доступна сервису PostgreSQL как источник внешних данных. В этом случае в папке, которая доступна, будет создан временный файл, содержащий загружаемые данные в требуемом Postgres формате. В случае, когда размер файла превысит 1GB, а также по исчерпании источника, будет выполнен оператор copy "..."(...) from %TEMP%\DML....CSV with (format csv, encoding UTF8) После чего временный файл будет удален.

Механизм может быть принудительно заблокирован ключем /NOCSV.

Механизм создает большую нагрузку на сервер БД, но в то же время позволяет существенно ускорить перекачку данных.

Firebird

Чтобы использовать формирование xml-документов на сервере, необходимо, чтобы одновременно выполнялись следующие условия: Таблица не содержит полей типа BLOB. Таблица не содержит строковых полей, которые могут содержать не-xml-compaint символы (определяется по свойствам соответствующего строкового домена. В этом случае будут формироваться и выполняться запросы вида 1with T as (select T.* from "...." T order by T."ID") 2select cast(cast( 3 '<data handle="' || count(1) || '" eof="1">' || list('<row>' || 4 '<ID type="int64">' || T."ID" || '</ID>' || 5 case when T."..." is null then '<.../>' else '<... type="int">' || T."..." || '</...>' end || 6 ...... 7 || '</row>' , '') || '</data>' as blob sub_type 1 character set utf8) as blob sub_type 0), count(1) 8 from T При выполнении такого запроса клиент получит blob, содержащий требуемый xml-документ в требуемой кодировке.

Oracle

Чтобы использовать формирование xml-документов на сервере, необходимо, чтобы одновременно выполнялись следующие условия: Используется Oracle версии не ниже 11. Таблица не содержит полей типа BLOB. В этом случае будут формироваться и выполняться запросы вида 1with T as (select T.* from "..." T ) 2select "SYS$HELPER"."ClobToBlob"('<data handle="' || count(1) || '" eof="1">' || 3 xmlagg(xmlelement("row", xmlelement("ID", xmlattributes('int64' as "type"), T."ID"), 4 case when "..." is null then xmltype('<..../>') else 5 xmlelement("....", xmlattributes('ascii' as "type"), "SYS$HELPER"."XMLEscape"(asciistr(T."...."), 0)) end, 6 .... 7 order by T."ID").getclobval() || '</data>'), count(1) from T При выполнении такого запроса клиент получит blob, содержащий требуемый xml-документ в требуемой кодировке.

Postgres

Чтобы использовать формирование xml-документов на сервере, необходимо, чтобы одновременно выполнялись следующее условие: Таблица не содержит полей типа BLOB. В этом случае будут формироваться и выполняться запросы вида 1select convert_to( '<data handle="' || count(1) || '" eof="1">' || string_agg( 2 '<row>' || 3 '<ID type="int64">' || T."ID" || '</ID>' || 4 case when T."...." is null then '<..../>' else '<.... type="int64">' || T."...." || '</....>' end || 5 ..... 6 '</row>', '' order by T."ID") || '</data>', 'UTF8'), count(1) from "..." T При выполнении такого запроса клиент получит blob, содержащий требуемый xml-документ в требуемой кодировке.

Механизм может быть принудительно заблокирован ключем /NOXML.

Для автоматизации установки или обновления платформы инсталлятор платфромы setup.exe поддерживает ключи командной строки.

Важно!

Указание ключей командной строки не превращет инсталлятор платфромы setup.exe в консольное приложение. Поэтому если вы включаете запуск инсталлятора в файл пакетной обработки, вам, возможно, потребуется дождаться завершения процесса установки. Для этого рекомендуется использовать команду start (с ключем /w или /wait. Рекомендуется ознакомиться со справкой по команде start перед ее использованием) : Пример start /w "SOME_TITLE" "...\SOME_FOLDER\setup.exe" /N /S /P /F .....

Ключи указываются через пробел. Ключ должен начинаться символом "/". Для ключей, содержащих значения параметров, между ключем, символом "=" и значением параметра пробелов быть не должно.

Ключи командной строки:

setup.exe /NCRC /S /D=C:\Program Files\Data Mill
            

Замечания:

1. Если ключ /x64 не задан, но в папке установки уже содержится папка WIN64, то все равно будет устанавливаться (в данном случае - обновляться) 64-битная редакция.
2. Если ключ /L=... не задан, но рядом с инсталлятором пллатформы setup.exe находится хотя бы один файл с расширением .license, то в качестве файла лицензии будет использоваться один из этих файлов (первый найденный).

Строка адресации БД платформы "Мельница данных" состоит из следующих элементов:
Сервер#Пользователь:Роль/Пароль@БазаДанных

Сервер - один из следующих вариантов:

• MS - БД MSSQL
• FB - БД Firebird
• ORA - БД Oracle Database
• PG - БД PostgreSQL
• MY - БД MySQL
• APP - Удаленное подключение к БД через сервер приложений

Пользователь - имя пользователя, используемого для соедиения.

Роль - роль, ассоциированная с соединением.

Firebird

Роль, заданная в строке адресации БД, используется для установки соединения с БД (передается через параметр isc_dpb_sql_role_name)

Для всех СУБД, кроме Firebird, указание роли имеет смысл только для утилиты обслуживания БД.

Пароль - пароль пользователя, используемый для соедиения. Пароль также может быть не задан в строке соединения (после символа "/" сразу следует символ "@"). В этом случае пароль будет запрошен у пользователя (если будет такая возможность), или будет использоваться Negotiate-аутентификация.

БазаДанных - адресует собственно базу или схему данных.
При использовании удаленного подключения к БД через сервер приложений используется нотация
protocol://Host:Port/handler
Протокол (protocol) может быть http или https. По умолчанию используется протокол http. Порт (Port) по умолчанию 80 для протокол http и 443 для протокола https может быть опущен.

MS SQL

Host:Port\\InstanceName.Database Порт (Port) по умолчанию 1433 может быть опущен вместе с двоеточнием. Хост (Host) может быть опущен, если используется локально. Имя экземпляра (InstanceName) может быть опущено, если используется имя "MSSQLSERVER". Следующие строки эквивалентны: 1localhost:1433\\MSSQLSERVER.MillDatabase 2localhost\\MSSQLSERVER.MillDatabase 3localhost.MillDatabase 4MillDatabase

Firebird

Host/Port:DBPath Порт (Port) по умолчанию 3050 может быть опущен. Если опущен хост (Host), то используется локальный протокол доступа к БД. Файл базы данных (DBPath) может быть задан как полное имя файла в файловой системе сервера, так и быть псевдонимом, настроенным на сервере.

Oracle

Host:Port/SID.schema Порт (Port) по умолчанию 1521 может быть опущен. Если опущен хост (Host), то используется имя из файа TNSNAMES.ORA в используемой клиентской части СУБД. Указание SID и имени схемы (schema) обязательно.

Postgres

Host:Port/DataBase.schema Порт (Port) по умолчанию 5432 может быть опущен. Если опущен хост (Host), то используется локальное соединение. Указание имени базы данных (DataBase) и имени схемы (schema) обязательно.

MySQL

Host:Port/schema Порт (Port) по умолчанию 3306 может быть опущен. Если опущен хост (Host), то используется локальное соединение. Указание имени схемы (schema) обязательно.

Прямое подключение к БД от имени владельца схемы данных является административным.

Oracle

Владельцем схемы данных является пользователь, имя которого совпадает с именем схемы.

Важно!

Никакое подключения к БД через сервер приложений не является административным.