Partager via


Plug-ins personnalisés

Remarque

Nous allons mettre hors service Azure HDInsight sur AKS le 31 janvier 2025. Avant le 31 janvier 2025, vous devrez migrer vos charges de travail vers Microsoft Fabric ou un produit Azure équivalent afin d’éviter leur arrêt brutal. Les clusters restants de votre abonnement seront arrêtés et supprimés de l’hôte.

Seul le support de base sera disponible jusqu’à la date de mise hors service.

Important

Cette fonctionnalité est disponible actuellement en mode Aperçu. Les Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure contiennent davantage de conditions légales qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou ne se trouvant pas encore en disponibilité générale. Pour plus d’informations sur cette préversion spécifique, consultez les Informations sur la préversion d’Azure HDInsight sur AKS. Pour toute question ou tout envoi de suggestions sur la fonctionnalité, veuillez soumettre une requête sur AskHDInsight avec les détails et suivez-nous pour plus de mises à jour sur la Communauté Azure HDInsight.

Cet article fournit des détails sur la façon de déployer des 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.

Prérequis

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 qui doivent être installés et à partir de quel emplacement, comme décrit par les champs suivants.

Propriété Description
name Ce champ est mappé au sous-répertoire dans le répertoire des plug-ins Trino qui contient tous les plug-ins sous le champ de chemin d’accès, comme décrit ici.
path Chemin d’accès absolu vers 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.
enabled Une propriété booléenne qui permet/désactive ce plug-in d’être téléchargé sur le cluster.

Remarque

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 de code 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.

Remarque

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.