User-managed интерпретаторы
Обзор
В данном разделе описаны особенности работы с кастомными Zeppelin-интерпретаторами, для которых задан параметр user-managed=true, а также представлены типичные сценарии их использования.
Интерпретаторы Zeppelin делятся на 2 категории:
-
Системные. Это те интерпретаторы, которые включены в бандл ADH и доступны в интерфейсе ADCM по умолчанию.
-
Кастомные. Это интерпретаторы, добавленные пользователями вручную.
В веб-интерфейсе Zeppelin для каждого интерпретатора можно добавить кастомные свойства типа ключ/значение для настройки поведения интерпретатора. Однако при рестарте Zeppelin-сервиса с помощью ADCM такие свойства теряются. Чтобы кастомные свойства сохранялись после рестарта, используйте опцию Allow user-managed interpreters в ADCM, как изображено на рисунке.
Если опция Allow user-managed interpreters включена, при рестарте Zeppelin-сервиса ADCM подтянет с Zeppelin-хоста конфигурации всех интерпретаторов, у которых есть свойство user-managed=true.
Если отключить Allow user-managed interpreters, при рестарте Zeppelin-сервиса ADCM будет создавать дефолтный список системных интерпретаторов.
Примеры использования
Ниже приведены примеры решения типовых задач с использованием user-managed интерпретаторов.
Кейс: защита системного интерпретатора от изменений при рестарте Zeppelin
Если вы не хотите, чтобы настройки интерпретатора изменялись при рестарте Zeppelin из ADCM, установите свойство user-managed=true для нужного интерпретатора в веб-интерфейсе Zeppelin.
Если опция Allow user-managed interpreters включена в ADCM, настройки кастомных интерпретаторов не будут изменяться после рестарта Zeppelin.
Кейс: обновление настроек интерпретатора после включения/отключения Kerberos/SSL/HA
Допустим, вы только что включили/отключили Kerberos/SSL/HA для ADH-сервиса. Обычно подобные операции приводят к изменению JDBC-строки подключения, поэтому если такая JDBC-строка была задана на интерпретаторе в виде пользовательского свойства, его необходимо обновить. Чтобы быстро обновить конфигурацию интерпретатора:
-
Отключите опцию Allow user-managed interpreters на странице конфигурации Zeppelin-сервиса в ADCM либо установите
user-managed=false(в Zeppelin UI) для тех интерпретаторов, чьи параметры необходимо обновить. -
Выполните рестарт Zeppelin.
После рестарта Zeppelin-сервиса ADCM сгенерирует список стандартных интерпретаторов по шаблону, используя корректное значение JDBC-строки.
Кейс: передача конфигурации интерпретатора в ADCM в виде файла
Вы можете определить содержимое файлов interpreter.json/interpreter.sh через ADCM. Для этого вставьте содержимое файлов на странице настройки Zeppelin-сервиса и сохраните конфигурацию. После рестарта Zeppelin инициализирует интерпретаторы, используя кастомные interpreter.json/interpreter.sh.
Кейс: сброс настроек для всех кастомных интерпретаторов
Чтобы сбросить настройки всех интерпретаторов, выполните следующее:
-
Отключите опцию Allow user-managed interpreters (по умолчанию включена) на странице конфигурации Zeppelin-сервиса в ADCM.
-
Отключите опции Custom interpreter.json/interpreter.sh.
-
Выполните рестарт Zeppelin.
После этого при рестарте Zeppelin-сервиса все интерпретаторы, у которых были объявлены кастомные свойства, будут созданы заново с настройками по умолчанию.