Benutzerdefinierte Plug-Ins

  • Artikel

Hinweis

Azure HDInsight on AKS wird am 31. Januar 2025 eingestellt. Vor dem 31. Januar 2025 müssen Sie Ihre Workloads zu Microsoft Fabric oder einem gleichwertigen Azure-Produkt migrieren, um eine abruptes Beendigung Ihrer Workloads zu vermeiden. Die verbleibenden Cluster in Ihrem Abonnement werden beendet und vom Host entfernt.

Bis zum Einstellungsdatum ist nur grundlegende Unterstützung verfügbar.

Wichtig

Diese Funktion steht derzeit als Vorschau zur Verfügung. Die zusätzlichen Nutzungsbedingungen für Microsoft Azure-Vorschauen enthalten weitere rechtliche Bestimmungen, die für Azure-Features in Betaversionen, in Vorschauversionen oder anderen Versionen gelten, die noch nicht allgemein verfügbar gemacht wurden. Informationen zu dieser spezifischen Vorschau finden Sie unter Informationen zur Vorschau von Azure HDInsight on AKS. Bei Fragen oder Funktionsvorschlägen senden Sie eine Anfrage an AskHDInsight mit den entsprechenden Details, und folgen Sie uns für weitere Updates in der Azure HDInsight-Community.

In diesem Artikel wird beschrieben, wie Sie benutzerdefinierte Plug-Ins für Ihr Trino-Cluster in HDInsight on AKS bereitstellen.

Trino bietet eine umfassende Schnittstelle, mit der Benutzer*innen eigene Plug-Ins wie Ereignislistener und benutzerdefinierte SQL-Funktionen programmieren können. Sie können die in diesem Artikel beschriebene Konfiguration hinzufügen, um benutzerdefinierte Plug-Ins mithilfe der ARM-Vorlage in Ihrem Trino-Cluster verfügbar zu machen.

Voraussetzungen

Hinzufügen benutzerdefinierter Plug-Ins

Eine userPluginsSpec.plugins-Konfiguration, die im Ressourcenabschnitt [*].properties.clusterProfile.trinoProfile in der ARM-Vorlage erstellt wurde, ermöglicht es Ihnen, die Plug-Ins anzugeben, die während einer Clusterbereitstellung heruntergeladen werden müssen.
userPluginsSpec.plugins definiert eine Liste, die beschreibt, welche Plug-Ins von welchem Speicherort installiert werden müssen. Das wird in den folgenden Feldern beschrieben.

Eigenschaft Beschreibung
name Dieses Feld wird dem Unterverzeichnis im Trino-Plug-In-Verzeichnis zugeordnet, das alle Plug-Ins unter dem Pfadfeld wie hier beschrieben enthält.
path Dieses Feld steht für den absoluten Pfad zu einem Verzeichnis, das alle JAR-Dateien enthält, die für das Plug-In erforderlich sind. Als Speicher dieser JAR-Dateien wird Azure Data Lake Storage Gen2 unterstützt.
enabled Dieses Feld enthält eine boolesche Eigenschaft, die das Herunterladen dieses Plug-Ins in den Cluster aktiviert oder deaktiviert.

Hinweis

Die Bereitstellung benutzerdefinierter Plug-Ins verwendet eine benutzerseitig zugewiesene verwaltete Identität (MSI), die an den Cluster gebunden ist, um sich bei dem Speicherkonto zu authentifizieren. Stellen Sie sicher, dass das Speicherkonto, das die Plug-Ins enthält, über den entsprechenden Zugriff für die verwaltete Identität verfügt, die an den Cluster gebunden ist.

Das folgende Beispiel veranschaulicht, wie ein Beispiel-Plug-In in einem Trino-Cluster bereitgestellt wird. Fügen Sie diese JSON-Beispieldatei unter [*].properties.clusterProfile in der ARM-Vorlage hinzu.

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

Stellen Sie die aktualisierte ARM-Vorlage bereit, um die Änderungen in Ihrem Cluster widerzuspiegeln. Weitere Informationen finden Sie unter Bereitstellen einer ARM-Vorlage.

Hinweis

Um die Plug-Ins in einem vorhandenen Cluster zu aktualisieren, ist eine Bereitstellung erforderlich, damit die neuen Änderungen übernommen werden.