Важно: Данный раздел актуален для Платформы данных On-Premise.
¶ 1. Предварительные условия
1. Для того, чтобы иметь возможность задавать макросы в RT.WideStore должно быть выполнено следующее:
Должен быть развернут кластер RT.WideStore с использованием плагина версии не ниже 1.24.1.
Должен быть установлен компонент ch, выполнена его привязка к хостам провайдера, выполнена установка программного обеспечения на эти хосты.
¶ 2. Создание макросов для одного или нескольких хостов
Для создания макросов необходимо выполнить следующие действия:
1. Откройте форму: “Кластеры -> имя_кластера -> ch -> Конфигурация”, в правой части формы выберите вкладку “macros”.
2. Для параметра “macros_list” добавьте строку, нажав соответствующую кнопку или отредактируйте заданные по умолчанию.
3. В левой части строки введите имя макроса.
4. В правой части строки введите значение макроса.
Значение макроса может быть как общим для всех хостов кластера, так и уникальным для разных хостов кластера.
1) Чтобы задать общее значение для всех хостов кластера, укажите его обычной строкой.
Пример (см. Рис. 1):
cluster cluster12) Чтобы задать уникальные значения для разных хостов кластера, необходимо задать его строкой в JSON формате. Где ключ - имя хоста кластера, значение - уникальное значение макроса для данного хоста.
Пример (см. Рис. 2)
replica {"ws1.ru": "repl1", "ws2.ru": "repl2"}Если уникальное значение нужно указать на одном или нескольких хостах, а на остальных хостах установить одинаковое значение, то для таких хостов в ключе вместо имени можно указывать атрибут "dafault"
replica {"ws1.ru": "repl1", "default": "repl-default"}3) Кроме того в значение макроса можно использовать переменные:
1. %ip% - ipv4 адрес хоста кластера
2. %hostname% - hostname хоста кластера
5. Параметр “macros_list” может содержать несколько строк.
6. Нажмите кнопку “Сохранить” в нижней части формы.
7. Из меню действий, расположенном в правой верхней части формы запустите "Переконфигурировать".
8. После успешного выполнения действия, проверьте на серверах сервиса, что макросы создались в файле /etc/clickhouse-server/config.d/macros.xml.