Раздел «Пространства»

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

В разделе представлены категории пространств, список папок и карточки пространств.

Категории пространств

В системе есть несколько категорий пространств:

• Все пространства: в категории представлены все пространства, доступные пользователю
• Пространства без папок: в категории представлены пространства, не добавленные ни в одну папку
• Избранное: в категории представлены пространства, которые пользователь добавил в избранное
• Корзина: в категории представлены пространства, которые пользователь удалил из системы. Из корзины можно восстановить пространства или удалить их насовсем

Во всех разделах и папках доступен поиск по пространствам. Чтобы найти пространство, воспользуйтесь строкой поиска в левом верхнем углу.

Список папок

В списке папок отображаются все папки, доступные пользователю.

Чтобы создать папку, нажмите + Новая папка, укажите уникальное название и кликните Добавить.

Откроется созданная папка. Добавить в нее пространства и подпапки можно несколькими способами:

• Нажмите кнопку с иконкой + рядом с названием пространства и выберите необходимый вариант
• Нажмите кнопку + Добавить в правом верхнем углу и выберите необходимый вариант
• Находясь в другом разделе или папке, нажмите карточку пространства и, удерживая ЛКМ нажатой, переместите пространство в необходимую папку

Находясь в папке, которая содержит пространства и/или подпапки, можно перемещаться по ним, кликая по необходимым карточкам.

В контекстном меню папки доступны следующие действия:

• Переместить: кликните, чтобы увидеть список папок, в которые можно переместить выбранную папку. Действие доступно, если в системе есть хотя бы две папки
• Переименовать
• Удалить: при удалении папки она перемещается в корзину. Также удаляются все подпапки и пространства, которые в ней находятся

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

Если папка содержит подпапки, слева от ее названия и иконки отображается стрелка. Кликните по ней, чтобы раскрыть иерархию папок.

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

Действия с пространствами

Добавление пространства

Чтобы добавить пространство, нажмите + Добавить.

В открывшемся модальном окне заполните следующие поля (обязательные отмечены значком *):

• Уникальное название*
• Папка (доступно, если создана хотя бы одна папка. Если поле не заполнено, пространство создается в разделе Пространства без папок)
• Подключение к хранилищу (выбор из списка доступных. Если доступен только один сервер базы данных, то поле Подключение к хранилищу не отображается)*
• Имя базы данных*
• Описание
• Пакет (для импорта пространства в формате ZIP-архива)

Когда все необходимые данные введены, нажмите Добавить.

Поле Имя базы данных заполняется автоматически, но при необходимости имя можно изменить. В поле недопустимы кириллические символы. Если название базы уникальное, то система создаст пространство с данным именем.

Узнать, как создается пространство, также можно в видеокурсе.

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

Контекстное меню пространства

Чтобы открыть контекстное меню пространства, кликните правой кнопкой мыши по карточке пространства.

Доступны следующие действия:

• Редактировать: при клике происходит переход в пространство
• На главную: кликните, чтобы увидеть список групп или создать новую группу и добавить пространство в нее (кнопка + Новая группа)
• Переместить: кликните, чтобы увидеть список папок, в которые можно переместить пространство. Действие доступно, если добавлена хотя бы одна папка
• Удалить из избранных: действие доступно, если пространство добавленно в избранное
• Экспортировать
• Дублировать
• Основное: кликните, чтобы открыть модальное окно редактирования основной информации о пространстве. В окне можно:
  • Изменить название
  • Переместить пространство в папку или в пространства без папок
  • Просмотреть, к какому хранилищу подключено пространство
  • Просмотреть имя базы данных
  • Редактировать описание
• Удалить

Также в систему можно импортировать конфигурацию пространства.

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

• Операция W, чтобы экспортировать и дублировать все пространства, а также импортировать готовое пространство в любое созданное
• Доступ на изменение в конкретном пространстве, чтобы экспортировать и дублировать только его, а также импортировать готовое пространство в него

Экспорт пространства

При экспорте пространства формируется архив с его конфигурацией. Название архива совпадает с названием экспортируемого пространства. Архив содержит следующие данные:

• Дашборды
• Скрипты
• Подключения (без настроек)
• Пакеты
• Модель данных:
  • Таблицы (без данных)
  • Связи
  • Процессы
  • Глобальные показатели

Чтобы экспортировать конфигурацию пространства, откройте главную страницу, кликните правой кнопкой мыши по необходимому пространству и выберите Экспортировать.

Импорт пространства

Импортируемое пространство и все его элементы, кроме скриптов, доступны для чтения. Чтобы скрипты отобразились в пространстве, необходимо разобрать пакет во вкладке Пакеты.

Импортировать конфигурацию пространства можно двумя способами: при создании нового пространства или в уже созданное пространство.

Импорт при создании нового пространства

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

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

Импорт в уже созданное пространство

Чтобы импортировать конфигурацию пространства в уже созданное пространство, перейдите во вкладку Пакеты и кликните + Добавить.

В открывшемся модальном окне нажмите на поле Импорт конфигурации и выберите ZIP-архив с конфигурацией пространства или перетащите архив в поле. Нажмите Импортировать.

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

Дублирование пространства

Дублирование пространства позволяет сохранить данные из исходного пространства в его копии. Копируются следующие данные:

• Дашборды
• Скрипты
• Подключения
• Модель данных
• Настройки доступа (только для пользователя, который создал копию)
• Пакеты
• Описание пространства

Чтобы дублировать пространство, кликните по нему правой кнопкой мыши и выберите Дублировать.

В модальном окне дублирования пространства укажите:

• Уникальное название (по умолчанию используется название исходного пространства и порядковый номер в скобках)
• Папку, в которую необходимо дублировать пространство (необязательно)
• Имя базы данных
• Тип подключения к хранилищу (по умолчанию указано подключение, используемое в исходном пространстве)
• Описание (необязательно)

Когда все необходимые данные введены, нажмите Дублировать.

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

Удаление пространства

При удалении пространства происходит проверка подключения к серверу ClickHouse:

• Если сервер доступен, то удаляются все данные, связанные с этим пространством
• Если сервер недоступен, то при подтверждении удаления информация о пространстве стирается, но база данных остается