その他のファイルを使用する
Note
Azure HDInsight on AKS は 2025 年 1 月 31 日に廃止されます。 2025 年 1 月 31 日より前に、ワークロードを Microsoft Fabric または同等の Azure 製品に移行することで、ワークロードの突然の終了を回避する必要があります。 サブスクリプション上に残っているクラスターは停止され、ホストから削除されることになります。
提供終了日までは基本サポートのみが利用できます。
重要
現在、この機能はプレビュー段階にあります。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用されるその他の法律条項については、「Microsoft Azure プレビューの追加の使用条件」に記載されています。 この特定のプレビューについては、「Microsoft HDInsight on AKS のプレビュー情報」を参照してください。 質問や機能の提案については、詳細を記載した要求を AskHDInsight で送信してください。また、その他の更新情報については、Azure HDInsight コミュニティをフォローしてください。
この記事では、その他のファイル構成を指定して使用する方法について詳しく説明します。
ARM テンプレートを使用して、クラスター内のその他のファイルを使用するための構成を追加できます。 より広範な例については、サービス構成を参照してください。
前提条件
- 操作可能な HDInsight on AKS を使用した Trino クラスター。
- クラスター用の ARM テンプレートを作成する。
- クラスターの ARM テンプレートの完全なサンプルを確認する。
- ARM テンプレートの作成とデプロイに関する知識。
その他のファイルを追加する。
ARM テンプレートの clusterProfile.serviceConfigsProfiles
の miscfiles
コンポーネントの各ファイルの指定には、次のものが必要です。
fileName
: 他の構成で参照として使用するファイルのシンボリック名。 この名前は物理ファイル名ではありません。 他の構成で特定のその他のファイルを使用するには、${MISC:\<fileName\>}
を指定し、実行時に HDInsight on AKS でこのタグを実際のファイル パスに置き換えます。指定する値は、次の条件を満たす必要があります。- 253 文字以下
- 小文字の英数字、
-
または.
のみを含む - 先頭と末尾が英数字
path
: ファイル名と拡張子 (該当する場合) を含む相対ファイル パス。 HDInsight on AKS の Trino では、ベース ディレクトリが変更される可能性がある他のファイルに対して、指定されたその他の各ファイルの場所のみが保証されます。 末尾が "path" プロパティで指定された値になっている場合を除き、その他のファイルの絶対パスについては何も仮定することはできません。content
: ファイル コンテンツを含む JSON エスケープ文字列。 コンテンツのフォーマットは Trino 機能によって異なり、たとえば、リソース グループの場合は JSON となります。
Note
構成を誤ると、Trino クラスタが起動しなくなることがあります。 構成を追加する場合は注意してください。
その具体的な例を次に示します。
- サンプルのリソース グループ JSON を追加し、それを使用するようにコーディネーターを構成します。
"serviceConfigsProfiles": [
{
"serviceName": "trino",
"configs": [
{
"component": "common",
"files": [
{
"fileName": "resource-groups.properties",
"values": {
"resource-groups.configuration-manager": "file",
"resource-groups.config-file": "${MISC:resource-groups}"
}
}
]
},
{
"component": "miscfiles",
"files": [
{
"fileName": "resource-groups",
"path": "/customDir/resource-groups.json",
"content": "{\"rootGroups\":[{\"name\":\"global\",\"softMemoryLimit\":\"80%\",\"hardConcurrencyLimit\":100,\"maxQueued\":1000,\"schedulingPolicy\":\"weighted\",\"jmxExport\":true,\"subGroups\":[{\"name\":\"data_definition\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":5,\"maxQueued\":100,\"schedulingWeight\":1},{\"name\":\"adhoc\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":50,\"maxQueued\":1,\"schedulingWeight\":10,\"subGroups\":[{\"name\":\"other\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":2,\"maxQueued\":1,\"schedulingWeight\":10,\"schedulingPolicy\":\"weighted_fair\",\"subGroups\":[{\"name\":\"${USER}\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":1,\"maxQueued\":100}]}]}]},{\"name\":\"admin\",\"softMemoryLimit\":\"100%\",\"hardConcurrencyLimit\":50,\"maxQueued\":100,\"schedulingPolicy\":\"query_priority\",\"jmxExport\":true}],\"selectors\":[{\"group\":\"global.adhoc.other.${USER}\"}],\"cpuQuotaPeriod\":\"1h\"}"
}
]
}
]
}
更新した ARM テンプレートをデプロイして、クラスターに変更を反映します。 ARM テンプレートをデプロイする方法を確認してください。