Partage via

Plug-ins personnalisés

  • Article

Important

Azure HDInsight sur AKS a été mis hors service le 31 janvier 2025. En savoir plus à propos de avec cette annonce.

Vous devez migrer vos charges de travail vers Microsoft Fabric ou un produit Azure équivalent pour éviter l’arrêt brusque de vos charges de travail.

Important

Cette fonctionnalité est actuellement en préversion. Les Conditions d’utilisation supplémentaires pour les préversions Microsoft Azure incluent des termes juridiques supplémentaires qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou qui ne sont pas encore publiées en disponibilité générale. Pour plus d’informations sur cette préversion spécifique, consultez informations sur Azure HDInsight sur AKS en préversion. Pour des questions ou des suggestions de fonctionnalités, envoyez une demande sur AskHDInsight avec les détails et suivez-nous pour plus de mises à jour sur Communauté Azure HDInsight.

Cet article fournit des détails sur le déploiement de plug-ins personnalisés sur votre cluster Trino avec HDInsight sur AKS.

Trino fournit une interface riche qui permet aux utilisateurs d’écrire leurs propres plug-ins tels que les écouteurs d’événements, les fonctions SQL personnalisées, etc. Vous pouvez ajouter la configuration décrite dans cet article pour rendre les plug-ins personnalisés disponibles dans votre cluster Trino à l’aide du modèle ARM.

Conditions préalables

  • Un cluster Trino opérationnel avec HDInsight sur AKS.
  • Créez modèle ARM pour votre cluster.
  • Passez en revue l’exemple complet de modèle ARM cluster.
  • Familiarité avec la rédaction et le déploiement de modèles ARM .

Ajouter des plug-ins personnalisés

Une configuration userPluginsSpec.plugins créée dans la section [*].properties.clusterProfile.trinoProfile ressource du modèle ARM vous permet de spécifier les plug-ins qui doivent être téléchargés pendant un déploiement de cluster.
userPluginsSpec.plugins définit une liste qui décrit les plug-ins à installer et à partir de quel emplacement, comme décrit par les champs suivants.

Propriété Description
nom Ce champ correspond au sous-répertoire dans le répertoire des plugins Trino qui contient tous les plugins sous le champ de chemin d'accès, comme décrit ici.
chemin Chemin complet d’un répertoire contenant tous les fichiers jar requis pour le plug-in. Le stockage pris en charge pour le stockage de ces fichiers jar est Azure Data Lake Storage Gen2.
Activé Propriété booléenne qui permet/désactive ce plug-in d’être téléchargé sur le cluster.

Note

Le déploiement de plug-in personnalisé utilise l’identité managée affectée par l’utilisateur (MSI) liée au cluster pour s’authentifier auprès du compte de stockage. Vérifiez que le compte de stockage contenant les plug-ins dispose d’un accès approprié accordé pour l’identité managée liée au cluster.

L’exemple suivant montre comment un exemple de plug-in est mis à la disposition d’un cluster Trino. Ajoutez cet exemple json sous [*].properties.clusterProfile dans le modèle ARM.

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

Déployez le modèle ARM mis à jour pour refléter les modifications apportées à votre cluster. Découvrez comment déployer un modèle ARM.

Note

Pour mettre à jour les plug-ins sur un cluster existant, il nécessite un déploiement afin que les nouvelles modifications soient récupérées.