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

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

1. Выберите объект репозитория в навигаторе объектов.

2. Включите кэширование, установив флажок «Кэшируемый объект» на вкладке «Кэш» в свойствах объекта.

После выполнения действий будет использоваться кэширование выбранного объекта репозитория.

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

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

Для использования кэширования регламентного отчёта:

1. Выберите объект репозитория в навигаторе объектов.

2. Включите кэширование, выполнив команду «Кэш объекта» контекстного меню.

После выполнения действий будет использоваться кэширование выбранного объекта репозитория.

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

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

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

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

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

• установите флажок «Кэширование сборок только на локальном диске» на рабочих станциях, которые используются для разработки проектов;

• установите флажок «Кэширование сборок только на локальном диске» при необходимости работы с прикладным кодом в разных версиях платформы;

• не устанавливайте флажок «Кэширование сборок только на локальном диске» на рабочих станциях пользователей при промышленном использовании проекта;

• перед передачей системы заказчику необходимо очистить репозиторий от скомпилированных сборок. Затем снять флажок «Кэширование сборок только на локальном диске» и запустить используемые пользователями формы, чтобы скомпилировать и сохранить сборки в базу репозитория. Запуск необходимо производить той версией платформы, которая в дальнейшем также будет установлена у заказчика. Это позволит избежать компиляции объектов при разворачивании системы и первом запуске, так как в файловый кэш попадут уже имеющиеся скомпилированные объекты из базы репозитория;

• следует помнить, что при компиляции изменённого модуля/формы из среды разработки, произойдет его сохранение. После этого отсутствуют гарантии открытия сохраненного модуля/формы более ранней версией платформы;

• разрабатываемые модули и формы необходимо компоновать и хранить внутри сборок. Это уменьшает количество создаваемых файлов в кэше, что приводит к уменьшению обращений к файловой системе и ускоряет запуск кэшированных объектов;

• проводите установку обновления и редактирование кэшируемых модулей при отсутствии в репозитории активных пользователей. Это позволит избежать непредвиденных последствий. После установки обновления или редактирования модулей требуется очистить кэш.

По умолчанию флаг «Кэширование сборок только на локальном диске» снят, при этом скомпилированная версия объекта сохраняется, как на локальном диске, так и в репозитории. В этом случае возможны ситуации:

• если работа в одном репозитории ведётся разными версиями платформы, а скомпилированные сборки сохраняются в репозитории, то в рамках одного проекта могут храниться формы и модули, скомпилированные разными версиями платформы. Это может привести к ошибкам вида: «Access violation…» или «Internal runtime error…», возникающим, например, при запуске одной формы из другой, скомпилированной другой версией платформы. Данные ошибки вызваны несовместимостью форматов в разных версиях платформы;

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

• при параллельной работе с одним объектом с разных компьютеров будет происходить сравнивание локальных скомпилированных версий и версий в базе. Это приведёт к постоянному обнаружению различий, что в свою очередь повысит нагрузку на сервер из-за постоянной загрузки версий на локальный диск и обратно в базу.

Для исключения подобных последствий:

• установите флаг «Кэширование сборок только на локальном диске» на стадии разработки проекта;

• удалите скомпилированные сборки из репозитория.