その他のファイルの使用

2024-09-20

大事な

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

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

大事な

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

この記事では、その他のファイル構成を指定して使用する方法について詳しく説明します。

ARM テンプレートを使用して、クラスター内のその他のファイルを使用するための構成を追加できます。より広範な例については、サービス構成を参照してください。

前提条件

AKS 上の HDInsight を使用した運用 Trino クラスター。
クラスター用の ARM テンプレートを作成します。
完全なクラスターを確認し、ARM テンプレートのサンプルをレビューします。
ARM テンプレートの作成とデプロイについての理解。

その他のファイルを追加する

ARM テンプレートの miscfiles に含まれる clusterProfile.serviceConfigsProfiles コンポーネントの各ファイル仕様には、以下が必要です。

fileName: 他の構成で参照として使用するファイルのシンボリック名。この名前は物理ファイル名ではありません。他の構成で特定のその他のファイルを使用するには、${MISC:\<fileName\>} を指定し、AKS 上の HDInsight でこのタグを実行時の実際のファイルパスに置き換えます。指定された値は、次の条件を満たす必要があります。
- 253文字以内にしてください
- 小文字の英数字、-、または . のみを含む
- 英数字で開始および終了する
path: ファイル名と拡張子 (該当する場合) を含む相対ファイルパス。 AKS 上の HDInsight を使用する Trino では、指定された各ファイルの各位置は、他のファイルとの相対的な位置のみが保証され、ベースディレクトリが変更される可能性があります。 "path" プロパティで指定された値で終わる点を除き、その他のファイルの絶対パスについては何も想定できません。
content: ファイルコンテンツを含む JSON エスケープ文字列。コンテンツの形式は、特定の Trino 機能に固有であり、たとえば、リソースグループの jsonによって異なる場合があります。

手記

構成が誤っていると、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 テンプレートデプロイする方法について説明します。

次の方法で共有

その他のファイルの使用

前提 条件

その他のファイルを追加する

その他のリソース

前提条件