Хранилища данных

Основное хранилище данных создается одновременно с приложением Jmix и доступно из Окна инструментов Jmix.

data tree

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

data properties

Следующие свойства доступны как для основного, так и для дополнительных хранилищ данных:

  • Database type – тип сервера базы данных. Вы можете выбрать одну из доступных баз данных из списка.

  • Database URL – хост, порт и имя базы данных.

    • Connection params – другие параметры подключения. Формат параметров подключения зависит от выбранной СУБД. Строка должна содержать разделитель между именем базы данных и параметрами. Вы можете использовать кнопку карандаша в правой части поля Connection params для большего удобства ввода параметров подключения. Тогда Studio автоматически сформирует строку подключения, добавляя символы-разделители, специфичные для СУБД.

      data params

    • Show raw URL – показывает параметры подключения в виде URL.

    • Integrated Security – включает соответствующую опцию проверки подлинности при подключении к базе данных Microsoft SQL Server 2012+.

  • Database user и Password – учетные данные для подключения к базе данных.

Вы можете использовать плейсхолдеры типа ${VAR:default_value}, где VAR – это переменная окружения для установки свойств базы данных.

data vars

Studio подменяет плейсхолдеры и использует полученные значения для всех операций с базой данных: тестовое подключение, воссоздание, обновление, Liquibase diff и т.д.

Дополнительное хранилище данных

Чтобы создать дополнительное хранилище данных, используйте действие из контекстного меню. Либо можно выбрать действие в разделе Advanced:

data advanced

См. описание свойств базы данных, общих как для основного, так и для дополнительных хранилищ данных, приведенное выше.

data schema

Укажите для дополнительного хранилища данных имя в Data store name и выберите опцию в разделе DB Schema Management:

  • Disabled – Studio не отслеживает изменения схемы базы данных для этого хранилища данных. Это режим по умолчанию.

  • Update Only – предоставляет действие обновления и создает файлы Liquibase changelog.

  • Create and Update – предоставляет действия обновления и воссоздания, а также создает скрипты Liquibase.

Действия с хранилищем данных

Щелкнув правой кнопкой мыши элемент хранилища данных в дереве проекта Jmix, вы можете открыть его контекстное меню:

data actions

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

  • New → Additional Data Store – открывает диалоговое окно для создания нового хранилища данных.

  • New → Liquibase Changelog – генерирует новый файл changelog с корректным именем.

  • Manage Data Store – открывает диалоговое окно для редактирования настроек хранилища данных.

  • Delete Data Store – удаляет хранилище данных вместе со всеми связанными файлами конфигурации и Liquibase changelogs.

  • Recreate – воссоздает базу данных, принадлежащую выбранному хранилищу данных. Применимо для основного хранилища данных и дополнительных хранилищ данных с режимом управления схемой Create and Update.

  • Update – обновляет схему базы данных для выбранного хранилища данных. Применимо для основного хранилища данных и дополнительных хранилищ данных с режимами управления схемой Update Only и Create and Update.

  • Generate Liquibase Changelog – генерирует файлы changelog для выбранного хранилища данных путем сравнения модели данных со схемой базы данных. Применимо для основного хранилища данных и дополнительных хранилищ данных с режимами управления схемой Update Only и Create and Update.

    Для этой функции требуется подписка RAD или Enterprise. Если у вас нет подписки, см. как получить пробную версию.

  • Check Liquibase Changelog Includes – проверяет, соответствуют ли включения в корневом файле changelog дополнениям, используемым в проекте. Если есть несоответствие, Studio показывает диалоговое окно уведомления и предлагает добавить или удалить включения.

  • Generate Model from Database – генерирует модель данных из базы данных.

  • Jump to Source – открывает класс конфигурации Spring.