Для создания датасета необходимо нажать на кнопку «Добавить», расположенную справа вверху над реестром датасетов. После нажатия на кнопку откроется окно для выбора способа создания датасета:
Создать датасет можно двумя способами:
- Загрузить из источника;
- Объединить датасеты.
Загрузить из источника
Выбор источника
Для создания датасета этим способом в окне выбора типа датасета необходимо нажать на вариант «Загрузить из источника». Откроется окно «Создание датасета».
Окно разделено на две вкладки:
- Из источника - отображает список имеющихся в системе источников на основе баз данных или API;
- Другие - отображает варианты загрузки из файловых источников.
Вкладка «Из источника» состоит из следующих элементов:
- Поиск - для поиска источника следует ввести в поле искомое значение. Список ниже отфильтруется относительно искомого значения. Введенное значение исчезает из поля при нажатии на кнопку ;
- Список источников в виде таблицы с двумя колонками:
- Название источника - в колонке отображается наименование имеющегося источника;
- Тип источника - в колонке отображается наименование коннектора источника;
- Сортировка - для применения сортировки по названию или типу необходимо нажать на заголовок столбца и выбрать опцию (по возрастанию/убыванию).
- Выбор источника - для выбора источника необходимо нажать на радио-кнопку, расположенную слева от названия источника.
Вкладка «Другие» отображает список доступных форматов файлов с данными для загрузки:
- XLSX;
- CSV или текстовый файл;
- JSON;
- XML.
В окне на одной из вкладок надо выбрать источник данных (база данных, API или файл).
Загрузка данных
Далее необходимо загрузить файловый источник или подключиться к СУБД/API. Рассмотрим на примере файлового источника в формате XLSХ. В модальном окне «Выбор источника» в списке источников необходимо выбрать формат XSLX, нажав радиокнопку слева от наименования, и нажать кнопку «Далее»:
После нажатия кнопки «Далее» открывается модальное окно с предложением загрузить файл. Необходимо загрузить файл в формате XLSX, нажав на кнопку «Загрузить» или перетащив файл в окно загрузки. После загрузки файла система уведомляет пользователя о статусе загрузки. Для перехода на следующий шаг система должна отобразить статус «Файл успешно загружен».
Проверка колонок
После нажатия кнопки «Далее» откроется модальное окно проверки колонок будущего датасета:
В окне проверки колонок отображается наименование каждой колонки, ее тип и переключатель (возможность выбрать или отменить колонку для загрузки в датасет). По умолчанию переключатели у всех колонок находятся во включенном состоянии. Чтобы датасет сформировался, обязательно должна быть выбрана хотя бы одна колонка.
В колонке "Тип" отображается раскрывающийся список, позволяющий изменить тип колонки, с четырьмя возможными типами:
- Строка;
- Число;
- Дата;
- Булево.
Правила приведения данных см. Настройки колонки - Тип данных.
Для перехода на следующий шаг необходимо нажать кнопку "Далее". Для закрытия окна проверки колонок следует нажать кнопку , расположенную в верхнем правом углу окна, или нажать левую кнопку мыши вне области окна. Для возврата на предыдущий шаг (окно для загрузки файла, ввода SQL-запроса или выбора варианта) необходимо нажать на кнопку "Назад".
Сохранение датасета
После проверки колонок датасета можно его сохранить. По нажатию на кнопку "Далее" отобразится модальное окно сохранения датасета:
Окно состоит из следующих блоков и полей:
- Поле "Название" - наименование датасета, обязательно к заполнению;
- Поле "Описание" - краткое описание датасета, необязательное поле;
- Блок "Права доступа". Для информации по настройке прав доступа см. Права доступа к сущности системы.
После заполнения полей наименования и описания и установки прав доступа к датасету необходимо нажать кнопку "Создать" в окне сохранения датасета.
Датасет сохранится, произойдет переход в реестр датасетов. Сохраненный датасет отобразится в реестре датасетов.
Для закрытия окна сохранения датасета следует нажать кнопку , расположенную в верхнем правом углу окна, или нажать левую кнопку мыши вне области окна.
Для возврата на предыдущий шаг (окно проверки колонок) необходимо нажать на кнопку "Назад".
Объединить датасеты
Общие сведения
Объединенный датасет - это аналог представления (view), которое не записывается в локальное хранилище.
Функциональность объединения датасетов позволяет:
- создавать объединенный датасет из одного или нескольких датасетов, загруженных в локальное хранилище;
- создавать объединенный датасет из одной или нескольких таблиц, подключаясь к источнику данных.
Особенности объединенного датасета
- При обновлении данных в датасетах или таблицах, из которых создан объединенный датасет, отображаемые данные в объединенном датасете обновляются автоматически, но обновленное количество записей в реестре датасетов отображается только после открытия датасета на просмотр, чтобы система запросила метаданные о количестве записей.
- Объединенный датасет не может быть создан из объединенных датасетов.
- Настройки объединения не могут быть изменены после создания объединенного датасета.
- Объединенный датасет позволяет добавлять расчетные колонки, при этом расчетная колонка не может быть записана в объединенный датасет.
- Объединенный датасет не может быть создан с использованием датасета, содержащего расчетную колонку с выключенным параметром «Записать расчет в датасет».
Несмотря на то, что объединенный датасет не записывается в локальное хранилище, виджеты на его основе поддерживают все функции агрегации. Агрегация данных выполняется в реальном времени при обращении к виждету.
Для объединения датасетов нажмите в окне выбора типа создаваемого датасета вариант «Объединить датасеты». Откроется окно объединения датасетов.
Для закрытия окна объединения датасетов необходимо нажать кнопку "Назад", расположенную в нижнем правом углу окна. Произойдет возврат в окно выбора типа создания датасета.
Создание объединенного датасета из локального хранилища
Для примера создадим датасет из двух датасетов, находящихся в локальном хранилище: один датасет загружен из файла, другой – из источника Polymatica Analytics.
Откроем окно объединения датасетов.
Перетащим из области «Доступные таблицы» в область «Настройки объединения» требуемые датасеты.
Нажмем для второго датасета кнопку
. В открывающемся по нажатию кнопки окне «Параметры объединения» настроим параметры объединения.Нажмем кнопку «Далее», сохраним датасет.
Обратите внимание
Вы можете создать объединенный датасет из одного датасета, например, чтобы постоянно отключить отображение одной или нескольких колонок.
Создание объединенного датасета из прямого подключения к источнику
Прямое подключение позволяет видеть все доступные таблицы в базе данных источника и создавать из них объединенный датасет, не используя SQL-запрос.
Выберем источник для прямого подключения в окне объединения датасетов, в области «Доступные таблицы», внизу, в поле «Источник». Чтобы источник отображался в списке, необходимо предварительно создать его и иметь к нему право доступа.
Обратите внимание
Прямое подключение поддерживают следующие типы источников:
- PostgreSQL
- MySQL
- Oracle
- Microsoft SQL Server
- Clickhouse
- Vertica
- YDB Cloud
- YDB Server
Актуальную информацию по типам источников, поддерживающим прямое подключение, можно найти на странице приложения https://адрес_приложения/setting/plugins
Когда источник выбран, в списке «Доступные таблицы» отображаются доступные таблицы базы данных источника.
Далее работайте с таблицами так же, как с датасетами из локального хранилища.
Сохранение объединенного датасета
Для сохранения объединенного датасета необходимо нажать кнопку «Далее», расположенную в нижнем правом углу окна объединения датасетов. После нажатия кнопки откроется окно сохранения объединенного датасета:
Окно состоит из следующих блоков и полей:
- Название датасета;
- Описание датасета;
- Права доступа к датасету.
В полях «Название датасета» и «Описание датасета» необходимо ввести название и описание датасета. Поле «Название датасета» является обязательным для заполнения, поле «Описание датасета» можно оставить пустым.
Для информации о предоставлении прав доступа см. Права доступа к сущности системы.
При нажатии на кнопку "Создать" датасет сохранится, произойдет переход в реестр датасетов. Объединенный датасет отобразится в реестре датасетов.
Для закрытия окна сохранения датасета следует нажать кнопку , расположенную в верхнем правом углу окна, или нажать левую кнопку мыши вне области окна.
Для возврата на предыдущий шаг (окно проверки колонок) необходимо нажать на кнопку "Назад" .