Группы параметров

В этом разделе описан инструмент, позволяющий сохранять наборы определённых значений параметров PostgreSQL-конфигурации, автоматически применять их к экземплярам баз данных и синхронизиорвать с ними:

  1. Страница Parameter groups - описание страницы, с которой можно управлять группами параметров и модификаторами.

  2. Страница конфигурации конкретной группы параметров - описание страницы, на которой можно задавать необходимые значения параметров для конкретной группы.

  3. Страница конкретного модификатора - описание страницы, на которой можно добавлять параметры в модификатор и устанавливать их значения.

  4. Вкладка «Группы параметров» на странице конфигурации экземпляров - описание страницы, с которой можно привязывать экземпляры к группам параметров и синхронизировать экземпляры с группами, а также привязывать экземпляры к модификаторам.

Внимание

Группы параметров доступны только для standalone экземпляров. Для кластеров patroni данный функционал недоступен.

Страница Parameter groups

Попасть на страницу «Parameter groups» можно, выбрав пункт «Группы параметров» в шестерёнке настроек.

Внимание

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

Откроется страница Parameter groups с двумя вкладками:

  • Группы параметров

  • Модификаторы

Вкладка «Группы параметров»

Во вкладке «Группы параметров» отображены два вида групп параметров:

  • Системные;

  • Пользовательские - группы параметров, созданные на основе системных групп.

Также на странице находится следующая информация о группах параметров:

  • Название группы параметров

  • Описание

  • Семейство, к которому относится данная группа параметров

  • Тип СУБД

  • Дата создания группы параметров

  • Дата изменения группы параметров

  • Количество синхронизированных с данной группой экземпляров

Системные группы являются предустановленными. Чтобы создать пользовательскую группу параметров, нужно кликнуть на кнопку «Создать группу параметров».

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

  1. В выпадающем списке выберите семейство, к которому будет принадлежать группа - версию СУБД.

  2. В выпадающем списке выберите группу параметров, на основе которой будет создана новая группа.

  3. Введите название новой группы параметров.

  4. Введите описание новой группы параметров (необязательное для заполнения поле).

После заполнения полей нажмите на кнопку «Создать».

С помощью поисковой строки (цифра 1 на рисунке ниже) можно найти интересующую группу параметров по её названию.

Группы можно фильтровать (цифра 2 на рисунке выше) по двум параметрам:

  • Семейство (версия СУБД PostgreSQL или Tantor)

  • Тип (системный или пользовательский)

У каждой группы параметров есть меню.

Оно состоит из следующих опций:

Внимание

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

  • Дублировать - с помощью этого пункта меню можно создать такую же группу параметров, заполнив её название и описание.

  • Удалить - кликнув на этот пункт меню группы параметров, можно её удалить.

Внимание

Нельзя удалить группу параметров, к которой привязан хот бы один экземпляр.

Чтобы удалить группу параметров, введите «удалить» в окно подтверждения.

Внимание

Системную группу параметров нельзя удалить.

Группы параметров можно сравнивать. Для этого нужно поставить галочки в чекбоксах рядом с группами (цифра 1 на рисунке ниже), а затем нажать на кнопку «Сравнить» (цифра 2 на рисунке ниже).

Появится окно со значениями параметров, которые различаются у сравниваемых групп.

Примечание

Сравнивать можно до трёх групп сразу.

Вкладка «Модификаторы»

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

Во вкладке «Модификаторы» отображается список модификаторов с информацией о них:

  • Название модификатора

  • Описание

  • Дата создания

  • Дата изменения

  • Количество экземпляров, к которым применён данный модификатор

Чтобы создать новый модификатор, нужно нажать на кнопку «Создать модификатор».

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

  1. Название модификатора.

  2. Описание модификатора (необязательное для заполнения поле).

После заполнения полей кликните по кнопке «Создать».

У модификаторов есть меню.

Оно включает следующие опции:

  • Открыть - кликнув на данный пункт меню, вы перейдёте на страницу конкретного модификатора.

  • Дублировать - с помощью данной опции можно создать такой же модификатор, заполнив название нового модификатора и его описание.

  • Удалить - нажав на эту кнопку, можно удалить модификатор, введя «удалить» в окно подтверждения удаления.

С помощью поисковой строки вверху страницы можно найти нужный модификатор по имени.

Страница конфигурации конкретной группы параметров

Кликнув по группе параметров, можно провалиться на страницу с её конфигурацией, имеющей две вкладки:

  • Параметры

  • Экземпляры

Вкладка «Параметры»

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

Для сохранения изменений необходимо нажать на кнопку «Сохранить изменения». Откроется модальное окно со списком изменённых параметров, в котором нужно кликнуть по кнопке «Сохранить».

Внимание

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

Если группа уже синхронизирована с определённым экземпляром, вверху страницы высветится следующее сообщение:

Кликнув на ссылку «Посмотреть экземпляры», вы попадёте во вкладку «Экземпляры» данной страницы.

С помощью поисковой строки можно искать нужный параметр по его названию.

Вкладка «Экземпляры»

Во вкладке «Экземпляры» представлен список экземпляров, привязанных к данной группе параметров с информацией о них:

  • Имя узла, на который установлен экземпляр

  • Конечная точка

  • Порт

  • Информация о том, привязан ли экземпляр к данной группе параметров

  • Информация о том, синхронизирован ли экземпляр с данной группой параметров

  • Дата последней синхронизации экземпляра с данной группой параметров

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

С помощью фильтра экземпляры можно отфильтровать только синхронизированные или несинхронизированные с данной группой экземпляры.

Также можно открыть страницу конфигурации данного экземпляра с помощью его меню → «Открыть».

С помощью поисковой строки можно найти нужный экземпляр по имени узла, на который он установлен.

Экземпляр можно синхронизировать с группой, поставив галочку в чекбоксе рядом с ним и нажав на кнопку «Синхронизировать и применить».

В модальном окне отобразятся изменившиеся значения параметров. В этом окне нужно кликнуть по кнопке «Синхронизировать».

Если вы синхронизируете сразу несколько экземпляров, в модальном окне будет две кнопки для синхронизации:

  1. Синхронизировать текущий - с помощью этой кнопки можно синхронизировать с группой параметров только тот экземпляр, во вкладке которого вы находитесь.

  2. Синхронизировать все - эта кнопка позволяет синхронизировать с группой параметров все экземпляры, которые вы выбрали.

Внимание

Синхронизация произойдёт через 5 минут после нажатия на эту кнопку.

Страница конкретного модификатора

Кликнув на конкретный модификатор, вы провалитесь на его страницу, имеющую две вкладки:

  • Параметры

  • Экземпляры

Вкладка «Параметры»

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

Чтобы добавить параметр, нужно кликнуть по кнопке «Добавить параметр» в центре страницы или вверху справа, если в данном модификаторе уже есть параметры.

  1. В выпадающем списке модального окна выберите необходимый параметр (можно начать вводить название параметра, что сильно сократит список)

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

  3. Кликните по кнопке «Привязать».

С помощью иконки в виде карандаша можно редактировать значения параметров.

А с помощью меню параметра → «удалить» можно удалить параметр.

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

Вкладка «Экземпляры»

Во вкладке «Экземпляры» отображается список привязанных к данному модификатору экземпляров и информация о них:

  • Имя узла, на который установлен экземпляр

  • Конечная точка

  • Порт

  • Информация о том, привязан ли экземпляр к данной группе параметров

  • Информация о том, синхронизирован ли экземпляр с данной группой параметров

  • Дата последней синхронизации экземпляра с данной группой параметров

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

Экземпляры можно сортировать по статусу их синхронизации с группами параметров.

При нажатии на меню экземпляра → «Открыть» вы попадёте на страницу конфигурации экземпляра.

Вкладка «Группы параметров» на странице конфигурации экземпляров

Частью описанного выше функционала можно управлять на странице конфигурации экземпляров во вкладке «Группы параметров».

Внимание

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

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

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

Примечание

Привязать экземпляр к группе параметров и синхронизировать его - это разные понятия.

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

Синхронизировать экземпляр - значит, применить настройки данной группы параметров к определённому экземпляру.

Для того, чтобы привязать экземпляр к группе параметров, кликните по меню уже привязанной группы → «Сменить группу».

Или, если к данному экземпляру ещё не было привязано ни одной группы параметров, нажмите на кнопку «Привязать группу параметров» в центре экрана.

Внимание

Если вы однажды привязали группу параметров к экземпляру, совсем отвязать её будет нельзя, можно поменять на другую.

Затем, чтобы синхронизировать экземпляр и применить значения параметров привязанной группы, нажмите на кнопку «Синхронизировать и применить».

Внимание

Синхронизация произойдёт через 5 минут после нажатия на эту кнопку.

Отобразится модальное окно с изменившимися значениями параметров. В этом окне нужно кликнуть по кнопке «Синхронизировать».

Внимание

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

С помощью меню группы параметров можно не только сменить группу данного экземпляра.

Доступны ещё две опции:

  • Открыть - данный пункт меню откроет страницу данной группы параметров.

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

С помощью кнопки «Добавить модификатор» можно привязать модификатор к данному экземпляру.

У модификаторов есть меню.

С помощью него можно осуществлять следующие действия:

  • Открыть - кликнув на этот пункт, вы перейдёте на страницу данного модификатора.

  • Информация - после клика на этот пункт появится модальное окно с информацией о том, кто и когда привязал экземпляр к модификатору.

  • Отвязать - с помощью данной опции можно отвязать экземпляр от модификатора.

    (гифка, когда поправят баг)