Подключение Superset¶

В этом разделе описывается процесс подключения интерактивной платформы Apache Superset к функциональному решению "Сорока" с целью анализа исторических данных.

Развертывание Superset¶

В зависимости от типа инсталляции необходимо развернуть инстанс Apache Superset версии 4.1.1 с наличием доступа к СУБД PostgreSQL, используемой сервисами функционального решения "Сорока".

Подготовка дашборда для импорта¶

Чтобы подготовить дашборд для импорта, выполните следующие действия:

1. Разархивируйте архив с дашбордом, полученный в составе дистрибутива.

2. Откройте файл databases/VOX_DB.yaml и отредактируйте параметр sqlalchemy_uri.

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

sqlalchemy_uri: postgresql://vox:XXXXXXXXXX@fs-vox-postgresql-hl:5432/fs_vox
                             ^^^            ^^^^^^^^^^^^^^^^^^^^ ^^^^ ^^^^^^
                        пользователь БД             хост БД      порт имя БД

4. Сохраните внесенные в файле изменения.

5. Упакуйте директорию с обновленным файлом в архив.

Импорт дашборда¶

Для импорта дашборда выполните следующие действия:

1. Откройте интерфейс Apache Superset и авторизуйтесь в нем под учетной записью администратора.

2. Нажмите кнопку Import dashboards в правом верхнем углу.

3. В диалоговом окне импорта выберите архив с обновленными на предыдущем этапе значениями подключения к базе данных и нажмите кнопку Import.

После нажатия кнопки система предложит ввести пароль пользователя базы данных.

4. Введите пароль и нажмите кнопку Import.

Через короткое время дашборд будет импортирован и появится в списке с именем VOX.

5. Нажмите на дашборд, чтобы открыть его.

Дашборд функционального решения "Сорока"

На этом импорт завершен, а дашборд доступен для использования.

Разделение доступа между организациями¶

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

Создание роли¶

Совет

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

Чтобы создать роль, выполните следующие действия:

1. Перейдите в раздел Settings -> List Roles верхнего меню.

2. Добавьте новую роль.

3. Для роли укажите права в соответствии с примером на рисунке выше.

Создание пользователя¶

Чтобы создать пользователя, выполните следующие действия:

1. Перейдите в раздел Settings -> List Users.

2. Добавьте нового пользователя.

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

Ограничение списка записей по ID организации¶

Чтобы настроить ограничение списка записей по ID организации, выполните следующие действия:

1. В разделе Settings -> Row Level Security создайте новое правило.

2. Заполните поля в соответствии с примером на рисунке выше. В поле clause укажите rls_org_id='ORG_ID', где ORG_ID — идентификатор организации, для которой создаются роль, пользователи и правило RLS.

Использование¶

Для начала работы с Apache Superset выполните следующие действия:

1. Авторизуйтесь, используя логин и пароль пользователя, созданного на предыдущих этапах.

После авторизации пользователю будет доступен только просмотр дашборда VOX. Права на просмотр других разделов и внесение изменений будут отсутствовать.

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