Документация содержит описание продукта HyperHive версии 2.0.12 (стр. 4 )

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

если есть процедура "some_proc", то должен быть определен базовый табличный тип с именем "some_proc_return_type".

Определение базовой хранимой процедуры в SQL Server

Связанный табличный тип для процедуры – это базовый табличный тип, имя которого отличается от имени связанной процедуры суффиксом "_return_type". Этот тип обозначает тип выходной таблицы процедуры.

Базовая хранимая процедура в MS SQL – это совокупность хранимой процедуры и связанного табличного типа. Требования к процедуре повторяют требования к базовой хранимой процедуре, кроме пункта про возвращаемую структуру.

3.2.5 Табличный JSON-сервис

В таблице ниже приведены все скалярные типы JSON Schema, а также их преобразование во внутренние типы платформы.

Базовый скалярный тип JSON Schema	Внутренний тип платформы
number	double
string	text
boolean	bigint

3.3 Базовая CRUD-процедура

Введение

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

Обзор концепции

Интерфейс функции доступа к таблице

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

Тип параметра	Имя параметра	Описание
Входной	upsert_rows	Таблица, структура которой совпадет со структурой базовой таблицы. Строки из этого параметра будут вставлены в базовую таблицу. При совпадении первичного ключа базовая таблица будет обновлена.
delete_ids	Таблица из одного столбца. Его тип и название соответствуют типу и названию первичного ключа базовой таблицы. Удаление должно происходить после обработки параметра upsert.
Выходной	Без имени	Базовая таблица.

Функция возвращает ошибку в следующих ситуациях:

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

Табличный ресурс на сервере

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

Табличный ресурс на клиенте

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

Пример

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

При инициализации мобильное приложение делает запрос к ресурсу c пустыми параметрами, т. е. с пустыми таблицами в качестве значений параметров. Сервер делает запрос к источнику данных, получает в ответе каталог товаров, кэширует каталог, отдает каталог мобильному приложению. Приложение получает каталог и сохраняет его. Пользователь приложения нажимает кнопку "Удалить товар". Приложение отправляет запрос с заданным параметром для удаления товара. Сервер отправляет запрос на удаление товара источнику данных. В ответ сервер получает полный обновленный каталог товаров. Сервер обновляет кэш о отправляет приложению дельту. Приложение получает и обрабатывает дельту. Обработка нажатия кнопки в приложении завершена.

Недостатки

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

4. Настройка и администрирование

На страницах текущего раздела представлена основная информация по управлению сервером HyperHive.

4.1 Активация и добавление лицензий платформы HyperHive

Активация и добавление лицензий платформы HyperHive необходимы в следующих случаях:

первоначальное развертывание платформы; увеличение количества доступных объектов лицензирования в платформе (см. 7. Лицензионная политика).

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

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

На представленном выше рисунке и далее по тексту приводятся демонстрационные значения параметров в качестве примера.

Файл-лицензий высылается на email, указанный в договоре, или после отправки письма на адрес *****@***com.

В письме нужно указать следующую информацию:

номер договора, в соответствии с которым вы хотите получить файл-лицензии; Id инсталляции; причина запроса (первичное добавление файла лицензии / перенос или восстановление системы).

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

В строке Зарегистрировано устройств гиперссылка подробнее используется для перехода в раздел Устройства (см. Устройства).

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

На вкладке Оповещения осуществляется настройка параметров оповещений:

Метод оповещения – элементы настройки метода оповещения:
Писать оповещения в логи (флажок); Отправлять оповещения по email и писать в логи;
Остаток устройств, % – оповещать, если число активных устройств превысило указанный процент от числа устройств, разрешенных по лицензиям; Остаток пользователей, % – оповещать, если число активных пользователей превысило указанный процент от числа пользователей, разрешенных по лицензиям; Остаток времени действия, дни – начинать оповещать, если до истечения лицензии осталось менее указанного количества дней; Периодичность повтора, дни – повторять оповещения об истечении срока действия лицензий.

На вкладке Оповещения используются следующие кнопки:

кнопка Сохранить настройки для сохранения указанных настроек оповещений; кнопка Выполнить проверку сейчас для проверки работы отправки оповещений по еmail и записи в логи, а также для выполнения сверки в данный момент по выставленным настройкам.

4.2 Начало работы

В данном разделе приведены типовые задачи настройки, которые необходимо выполнить в самом начале эксплуатации платформы HyperHive.

Наименование инсталляции

Для простоты идентификации инсталляции в веб-панели администратора можно дать ей словесное описание (например: тестовый сервер, PRODUCTION и т. п.). Для этого необходимо выбрать пункт Администрирование, указать текстовое описание инсталляции и нажать на кнопку Сохранить. Указанный текст отобразится в верхней горизонтальной панели Административного интерфейса.

На представленном выше рисунке и далее по тексту приводятся демонстрационные значения параметров в качестве примера.

Настройка аутентификации с использованием LDAP (Active Directory)

Аутентификация пользователей и администраторов может осуществляться платформой (используется по умолчанию) или внешней LDAP-системой.

Настройка взаимодействия со внешней LDAP-системой производится в разделе Администрирование/Настройки LDAP.

Параметры настройки LDAP разбиты на три блока.

В блоке настроек Аутентификация LDAP на вкладке Подключение указываются значения параметров, необходимых для подключения к LDAP:

Хост – IP-адрес или DNS-имя, по которому доступен сервер LDAP; Порт – TCP-порт, по которому доступен сервис LDAP; Логин технического пользователя – учетная запись в LDAP-системе, имеющая права на чтение из каталога LDAP; Пароль технического пользователя.

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

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

Кнопка Проверить соединение предназначена для проверки выполнения аутентификации с заданными настройками.

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

На вкладке Расписание задается режим синхронизации информации о пользователях между LDAP и платформой. Обмен носит односторонний характер, в котором LDAP является источником.