Compartilhar via

Plug-ins personalizados

  • Artigo

Importante

O Azure HDInsight no AKS se aposentou em 31 de janeiro de 2025. Saiba mais com este comunicado.

Você precisa migrar suas cargas de trabalho para microsoft fabric ou um produto equivalente do Azure para evitar o encerramento abrupto de suas cargas de trabalho.

Importante

Esse recurso está atualmente em versão prévia. Os termos de uso complementares para o Microsoft Azure Previews incluem mais termos legais que se aplicam aos recursos do Azure que estão em versão beta, em versão prévia ou ainda não lançados em disponibilidade geral. Para obter informações sobre essa versão prévia específica, consulte Azure HDInsight em informações de visualização do AKS. Para perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para mais atualizações na Comunidade do Azure HDInsight .

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

O Trino fornece uma interface avançada que permite que os usuários escrevam seus próprios plug-ins, 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 do ARM.

Pré-requisitos

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

Adicionar plug-ins personalizados

Uma configuração userPluginsSpec.plugins acrescentada na seção de recursos [*].properties.clusterProfile.trinoProfile no template do 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 pelos campos a seguir.

Propriedade Descrição
nome Esse campo é mapeado para o subdiretório no diretório de plug-ins do Trino que contém todos os plug-ins no campo de caminho, conforme descrito aqui.
caminho Caminho totalmente qualificado para um diretório que contém todos os arquivos jar necessários para o plug-in. O armazenamento com suporte para armazenar esses jars é o Azure Data Lake Storage Gen2.
Habilitado Uma propriedade booliana que habilita/desabilita esse plug-in de ser baixado no cluster.

Nota

A implantação de plug-in personalizado utiliza a Identidade Gerenciada (MSI) atribuída pelo usuário, vinculada ao cluster, para autenticar-se na conta de armazenamento. Verifique se a conta de armazenamento que contém os plug-ins tem 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 json de exemplo em [*].properties.clusterProfile no modelo do ARM.

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

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

Nota

Para atualizar os plug-ins em um cluster existente, ele requer uma implantação para que as novas alterações sejam detectadas.