Пользовательские плагины

Важный

Azure HDInsight на AKS было выведено из эксплуатации 31 января 2025 г. Узнайте больше из этого объявления.

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

Важный

Эта функция сейчас доступна в предварительной версии. Дополнительные условия использования для предварительных версий Microsoft Azure включают дополнительные юридические термины, применимые к функциям Azure, которые находятся в бета-версии, в предварительной версии или в противном случае еще не выпущены в общую доступность. Сведения об этой конкретной предварительной версии см. в Azure HDInsight в предварительной версии AKS. Для вопросов или предложений функций отправьте запрос на AskHDInsight с подробными сведениями и следуйте за дополнительными обновлениями в Azure HDInsight Community.

В этой статье содержатся сведения о развертывании пользовательских плагинов в кластере Trino с HDInsight в AKS.

Trino предоставляет широкий интерфейс, позволяющий пользователям создавать собственные подключаемые модули, такие как прослушиватели событий, пользовательские функции SQL и т. д. Вы можете добавить конфигурацию, описанную в этой статье, чтобы сделать настраиваемые подключаемые модули доступными в кластере Trino с помощью шаблона ARM.

Необходимые условия

• Рабочий кластер Trino с HDInsight на AKS.
• Создайте шаблон ARM для кластера.
• Просмотрите пример полного шаблона кластера ARM .
• Знакомство с разработкой и развертыванием шаблонов ARM.

Добавить пользовательские подключаемые модули

Конфигурация userPluginsSpec.plugins, созданная в разделе ресурса [*].properties.clusterProfile.trinoProfile в шаблоне ARM, позволяет указать плагины, которые необходимо скачать во время развертывания кластера.
userPluginsSpec.plugins определяет список, какие подключаемые модули необходимо установить и откуда, как описано в следующих полях.

Свойство	Описание
имя	Это поле сопоставляется с подкаталогом в каталоге подключаемых модулей trino, который содержит все подключаемые модули в поле пути, как описано здесь.
путь	Полный путь к каталогу, содержащему все JAR-файлы, необходимые для подключаемого модуля. Поддерживаемое хранилище для хранения этих файлов JAR — Azure Data Lake Storage 2-го поколения.
Активирован	Логическое свойство, которое включает или отключает скачивание этого подключаемого модуля в кластер.

Заметка

Развертывание пользовательского подключаемого модуля использует назначаемое пользователем управляемое удостоверение (MSI), привязано к кластеру, для аутентификации с учетной записью хранения. Убедитесь, что учетная запись хранения, в котором хранятся плагины, имеет соответствующий доступ для Управляемой личности, связанной с кластером.

В следующем примере показано, как пример плагина сделан доступным для кластера Trino. Добавьте этот пример JSON под [*].properties.clusterProfile в шаблон ARM.

"trinoProfile": { 
  "userPluginsSpec": { 
    "plugins": [ 
      { 
        "name": "exampleplugin", 
        "path": "https://examplestorageaccount.blob.core.windows.net/plugins/myplugins/", 
        "enabled": true 
      }
    ] 
  } 
}

Разверните обновленный шаблон ARM, чтобы отразить изменения в кластере. Узнайте, как развернуть шаблон ARM.

Заметка

Чтобы обновить подключаемые модули в существующем кластере, требуется развертывание, чтобы новые изменения были учтены.