Кеширование объектов репозитория

Для ускорения доступа к объектам и их работы используйте кеширование объектов репозитория.

При работе BI-сервера «Форсайт. Аналитическая платформа» извлечение и хранение данных, необходимых для работы веб-приложения, осуществляется в памяти самого BI-сервера.

Систему можно расширить путем введения дополнительных (более производительных) серверов, на которые будет возложена функция извлечения и кеширования данных из репозитория. BI-сервер будет обращаться к этим серверам и получать поток с необходимыми данными без дополнительного обращения к СУБД. Для введения дополнительных BI-серверов заполните раздел Service в файле settings.xml или в настройках системного реестра.

Кеширование доступно для некоторых типов объектов репозитория:

Также кеширование доступно для документов с некоторыми особенностями:

Для объектов репозитория осуществляется кеширование их скомпилированных версий. Использование кеша позволяет ускорить запуск форм и выполнение прикладного кода при работе прикладных проектов.

Во время компиляции модулей/форм/сборок на локальном диске создаётся файловый кеш, в котором хранится скомпилированная версия объекта. При работе в ОС Linux кеш располагается на BI-сервере в подкаталоге /opt/foresight/fp10.x-biserver/var/cache/AsmCache<порядковый номер>/Mod/<идентификатор репозитория>/<номер сборки>. При работе в ОС Windows, по умолчанию, кеш располагается в профиле пользователя, в подкаталоге %USERPROFILE%\AppData\Local\Foresight\Foresight Analytics Platform\AsmCache<порядковый номер>\Mod\<идентификатор репозитория>\<номер сборки>. При необходимости путь хранения файлового кеша можно изменить. Для этого в ветке реестра [HKEY_CURRENT_USER\Software\Foresight\Foresight Analytics Platform\10.0\10.11] создайте строковый параметр CachefilePath и задайте в нём необходимый путь.

Рекомендации:

следует помнить, что при компиляции изменённого модуля/формы/веб-формы из среды разработки, произойдет его сохранение. После этого отсутствуют гарантии открытия сохранённого объекта более ранней версией платформы;
разрабатываемые модули и формы необходимо компоновать и хранить внутри сборок. Это уменьшает количество создаваемых файлов в кеше, что приводит к уменьшению обращений к файловой системе и ускоряет запуск кешированных объектов;
изменения в Fore-коде, сделанные в момент работы пользователей, будут применены только после выгрузки и новой загрузки скомпилированных сборок. В случае с обработчиком событий, например, для применения нового кода потребуется закрыть все объекты, которые используют этот обработчик;
сборки/модули, в коде которых используются статические поля классов, выгружаются только при выходе из репозитория, поэтому необходимо перезайти в репозиторий, чтобы применились изменения в таком коде;
проводите очистку кеша сборок в репозитории при отсутствии активных пользователей. Это позволит избежать непредвиденных последствий;
при установке обновлений с включенной настройкой «Устанавливать дату изменения объектов из обновления» необходимо принудительно очистить кеш сборок на всех BI-серверах. Не рекомендуется использовать данную настройку при обновлении объектов среды разработки. Это связано с тем, что в кеше сборок хранится дата и время компиляции. Для перекомпиляции дата и время в кеше должно быть более ранним, чем дата и время изменения объекта в базе данных. А так как в базе данных сохранится время из обновления, то это условие может быть невыполнимо.

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

Очистка кеша

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

Linux Windows

Для очистки кеша объектов среды разработки удалите скриптом файлы в подкаталоге /opt/foresight/fp10.x-biserver/var/cache/AsmCache<порядковый номер>/Mod/<идентификатор репозитория> для требуемого репозитория. Очистка осуществляется администратором BI-сервера.

Для очистки кеша объектов среды разработки:

Скопируйте архив CacheClearing.zip, который содержит файлы check_fcntl, isblock.sh. Утилита check_fcntl проверяет заблокирован кеш или нет. Скрипт isblock.sh удаляет незаблокированные кеши.
Раздайте права на выполнение данным файлам:

chmod +x check_fcntl isblock.sh

Задайте расписание выполнения скрипта isblock.sh для планировщика, например cron.

В результате будет происходить очистка незаблокированных кешей автоматически по расписанию .

Для однократной очистки запустите скрипт isblock.sh.

Для очистки кеша объектов среды разработки выполните команду «Репозиторий > Очистить кеш сборок» в главном меню менеджера безопасности.

Для работы с кешем различных объектов репозитория из языка Fore используйте свойства и методы интерфейсов IMetabase, IMetabaseObject. Для очистки кеша объектов используйте метод IMetabaseCache.FlushAll.