カスタムプラグイン

[アーティクル]
09/20/2024

大事な

AKS 上の Azure HDInsight は、2025 年 1 月 31 日に廃止されました。このお知らせでについて詳しく学びましょう。

ワークロードの突然の終了を回避するには、ワークロードを Microsoft Fabric または同等の Azure 製品に移行する必要があります。

大事な

この機能は現在プレビュー段階です。 Microsoft Azure プレビューの追加使用条件には、ベータ版、プレビュー版、または一般公開されていない Azure 機能に適用される、より多くの法的条件が含まれています。この特定のプレビューの詳細については、AKS プレビュー情報 Azure HDInsightを参照してください。ご質問や機能の提案がある場合は、詳細を記載して AskHDInsight にリクエストを送信してください。また、Azure HDInsight Community の最新情報をフォローしてください。

この記事では、AKS 上の HDInsight を使用して Trino クラスターにカスタムプラグインをデプロイする方法について詳しく説明します。

Trino は、ユーザーがイベントリスナー、カスタム SQL 関数などの独自のプラグインを記述できる豊富なインターフェイスを提供します。この記事で説明されている構成を追加して、ARM テンプレートを使用して Trino クラスターでカスタムプラグインを使用できるようにします。

前提条件

AKS 上の HDInsight を使用した運用 Trino クラスター。
クラスター用の ARM テンプレートを作成します。
クラスターの完全性を確認する ARM テンプレートサンプル。
ARM テンプレートの作成とデプロイに精通していること。

カスタムプラグインを追加する

ARM テンプレートのリソース [*].properties.clusterProfile.trinoProfile セクションで作成された userPluginsSpec.plugins 構成を使用すると、クラスターのデプロイ中にダウンロードする必要があるプラグインを指定できます。
userPluginsSpec.plugins では、次のフィールドで説明するように、インストールする必要があるプラグインとその場所を説明するリストを定義します。

財産	説明
名前	このフィールドは、ここで説明するように、パスフィールドのすべてのプラグインを含む trino plugins ディレクトリのサブディレクトリにマップされます。
パス	プラグインに必要なすべての jar ファイルを含むディレクトリへの完全修飾パス。これらの jar を格納するためにサポートされているストレージは、Azure Data Lake Storage Gen2 です。
有効	このプラグインがクラスターにダウンロードされることを有効または無効にするブール型プロパティ。

手記

カスタムプラグインのデプロイでは、クラスターに関連付けられているユーザー割り当てマネージド ID (MSI) を使用して、ストレージアカウントに対する認証を行います。プラグインを保持しているストレージアカウントに、クラスターに関連付けられているマネージド ID に対して適切なアクセス権が付与されていることを確認します。

次の例は、Trino クラスターでサンプルプラグインを使用できるようにする方法を示しています。 ARM テンプレートの [*].properties.clusterProfile の下に、このサンプル json を追加します。

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

更新された ARM テンプレートをデプロイして、クラスター内の変更を反映します。 ARM テンプレートデプロイする方法について説明します。

手記

既存のクラスター上のプラグインを更新するには、新しい変更が取得されるようにデプロイが必要です。