Plug-ins personalizados

Observação

Desativaremos o Microsoft Azure HDInsight no AKS em 31 de janeiro de 2025. Para evitar o encerramento abrupto das suas cargas de trabalho, você precisará migrá-las para o Microsoft Fabric ou para um produto equivalente do Azure antes de 31 de janeiro de 2025. Os clusters restantes em sua assinatura serão interrompidos e removidos do host.

Somente o suporte básico estará disponível até a data de desativação.

Importante

Esse recurso está atualmente na visualização. Os Termos de uso complementares para versões prévias do Microsoft Azure 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, confira Informações sobre a versão prévia do Azure HDInsight no AKS. No caso de perguntas ou sugestões de recursos, envie uma solicitação no AskHDInsight com os detalhes e siga-nos para ver mais atualizações sobre a Comunidade do Azure HDInsight.

Esse artigo fornece detalhes sobre como implantar plug-ins personalizados em seu cluster de 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 do Trino usando o modelo do ARM.

Pré-requisitos

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

Plug-ins personalizados

Uma configuração userPluginsSpec.plugins criada na seção [*].properties.clusterProfile.trinoProfile do recurso no modelo do ARM permite que você especifique 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
name	Esse campo é mapeado para o subdiretório no diretório de plug-ins do trino que contém todos os plug-ins no campo caminho, conforme descrito aqui.
path	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.

Observação

A implantação de plug-in personalizado usa a identidade Gerenciada (MSI) atribuída pelo usuário vinculada ao cluster para se autenticar 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 do 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.

Observação

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