自訂外掛程式
注意
AKS 上的 Azure HDInsight 將於 2025 年 1 月 31 日退場。 請於 2025 年 1 月 31 日之前,將工作負載移轉至 Microsoft Fabric 或對等的 Azure 產品,以免工作負載突然終止。 訂用帳戶中剩餘的叢集將會停止,並會從主機移除。
在淘汰日期之前,只有基本支援可用。
重要
此功能目前為預覽功能。 Microsoft Azure 預覽版增補使用規定包含適用於 Azure 功能 (搶鮮版 (Beta)、預覽版,或尚未正式發行的版本) 的更多法律條款。 若需此特定預覽版的相關資訊,請參閱 Azure HDInsight on AKS 預覽版資訊。 如有問題或功能建議,請在 AskHDInsight 上提交要求並附上詳細資料,並且在 Azure HDInsight 社群上追蹤我們以獲得更多更新資訊。
本文詳細介紹如何使用 HDInsight on AKS 將自訂外掛程式部署到您的 Trino 叢集。
Trino 提供豐富的介面,可讓使用者撰寫自己的外掛程式,例如事件接聽程式、自訂 SQL 函式等。您可以新增本文中所述的設定,以便使用 ARM 範本在 Trino 叢集中提供自訂外掛程式。
必要條件
- 使用 HDInsight on AKS 的作業 Trino 叢集。
- 為叢集建立 ARM 範本。
- 檢閱完整的叢集 ARM 範本範例。
- 熟悉 ARM 範本製作和部署。
新增自訂外掛程式
ARM 樣本中的資源 [*].properties.clusterProfile.trinoProfile
區段中所撰寫的 userPluginsSpec.plugins
設定可讓您指定在叢集部署期間需要下載的外掛程式。
userPluginsSpec.plugins
定義了一個清單,說明需要安裝哪些外掛程式,以及從哪個位置安裝,如下列欄位所述。
屬性 | 描述 |
---|---|
NAME | 此欄位對應到 trino plugins 目錄中的子目錄,其中包含路徑欄位下的所有外掛程式,如這裡所述。 |
path | 包含外掛程式所需之所有 jar 檔案之目錄的完整路徑。 儲存這些 jar 的支援儲存體是 Azure Data Lake Storage Gen2。 |
已啟用 | 一個布林屬性,用於啟用/停用將此外掛程式下載到叢集上。 |
注意
自訂外掛程式部署會使用與叢集繫結的使用者指派的受控識別 (MSI) 來針對儲存體帳戶進行驗證。 確定持有外掛程式的儲存體帳戶具有針對與叢集繫結的受控識別所授與的適當存取權。
下列範例示範如何將範例外掛程式提供給 Trino 叢集。 在 ARM 範本中的 [*].properties.clusterProfile
下新增此範例 json。
"trinoProfile": {
"userPluginsSpec": {
"plugins": [
{
"name": "exampleplugin",
"path": "https://examplestorageaccount.blob.core.windows.net/plugins/myplugins/",
"enabled": true
}
]
}
}
部署更新的 ARM 範本以反映叢集中的變更。 了解如何部署 ARM 範本。
注意
若要更新現有叢集上的外掛程式,需要進行部署才能取得新的變更。