Plugins personalizados

Nota

Vamos desativar o Azure HDInsight no AKS em 31 de janeiro de 2025. Antes de 31 de janeiro de 2025, você precisará migrar suas cargas de trabalho para o Microsoft Fabric ou um produto equivalente do Azure para evitar o encerramento abrupto de suas cargas de trabalho. Os clusters restantes na sua subscrição serão interrompidos e removidos do anfitrião.

Apenas o apoio básico estará disponível até à data da reforma.

Importante

Esta funcionalidade está atualmente em pré-visualização. Os Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure incluem mais termos legais que se aplicam a funcionalidades do Azure que estão em versão beta, em pré-visualização ou ainda não disponibilizadas para disponibilidade geral. Para obter informações sobre essa visualização específica, consulte Informações de visualização do Azure HDInsight no AKS. Para perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para obter mais atualizações na Comunidade do Azure HDInsight.

Este artigo fornece detalhes sobre como implantar plug-ins personalizados em seu cluster Trino com o HDInsight no AKS.

Trino fornece uma interface rica que permite aos usuários escrever seus próprios plugins, como ouvintes de eventos, funções SQL personalizadas, etc. Você pode adicionar a configuração descrita neste artigo para disponibilizar plug-ins personalizados em seu cluster Trino usando o modelo ARM.

Pré-requisitos

• Um cluster Trino operacional com HDInsight no AKS.
• Crie um modelo ARM para seu cluster.
• Analise o exemplo de modelo ARM de cluster completo.
• Familiaridade com a criação e implantação de modelos ARM.

Adicionar plugins personalizados

Uma userPluginsSpec.plugins configuração criada na seção de recursos [*].properties.clusterProfile.trinoProfile no modelo ARM permite especificar os plug-ins que precisam ser baixados durante uma implantação de cluster.
userPluginsSpec.plugins Define uma lista que descreve quais plug-ins precisam ser instalados e de qual local, conforme descrito nos campos a seguir.

Property	Descrição
nome	Este campo é mapeado para o subdiretório no diretório trino plugins que contém todos os plugins no campo de caminho, conforme descrito aqui.
path	Caminho totalmente qualificado para um diretório contendo todos os arquivos jar necessários para o plugin. O armazenamento suportado para armazenar esses jars é o Azure Data Lake Storage Gen2.
ativado	Uma propriedade booleana que permite/desativa o download deste plugin para o cluster.

Nota

A implantação de plug-in personalizada usa a Identidade Gerenciada (MSI) atribuída pelo usuário vinculada ao cluster para autenticação na conta de armazenamento. Certifique-se de que a conta de armazenamento que contém os plug-ins tenha acesso apropriado concedido para a Identidade Gerenciada vinculada ao cluster.

O exemplo a seguir demonstra como um plug-in de exemplo é disponibilizado para um cluster Trino. Adicione este exemplo de json em [*].properties.clusterProfile no modelo ARM.

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

Implante o modelo ARM atualizado para refletir as alterações no cluster. Saiba como implantar um modelo ARM.

Nota

Para atualizar os plug-ins em um cluster existente, é necessária uma implantação para que as novas alterações sejam coletadas.