セルフホステッド統合ランタイムの作成と管理

統合ランタイム (IR) は、Microsoft Purview がさまざまなネットワーク環境でデータ スキャンを実行するために使用するコンピューティング インフラストラクチャです。

セルフホステッド統合ランタイム (SHIR) を使用して、オンプレミス ネットワークまたは仮想ネットワーク内のデータ ソースをスキャンできます。 セルフホステッド統合ランタイムのインストールには、オンプレミスのマシンまたはプライベート ネットワーク内の仮想マシンが必要です。

この記事では、セルフホステッド統合ランタイムの設定と、トラブルシューティングと管理の両方について説明します。

前提条件

• サポートされているバージョンの Windows は次のとおりです。
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2012
  • Windows Server 2012 R2
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022

ドメイン コントローラーへのセルフホステッド統合ランタイムのインストールはサポートされていません。

• Microsoft Purview で SHIR を追加および管理するには、Microsoft Purview の データ ソース管理者のアクセス許可 が必要です。

• セルフホステッド統合ランタイムには、.NET Framework 4.7.2 以上の 64 ビット オペレーティング システムが必要です。 詳細については、「.NET Frameworkシステム要件」を参照してください。

• セルフホステッド統合ランタイム マシンに推奨される最小構成は、8 コア、28 GB の RAM、80 GB の使用可能なハード ドライブ領域を備えた 2 GHz プロセッサです。 一部のデータ ソースをスキャンするには、シナリオに基づいて、より高いコンピューター仕様が必要になる場合があります。 対応するコネクタ記事の前提条件もチェックしてください。

• ホスト マシンが休止状態になった場合、セルフホステッド統合ランタイムはデータ要求に応答しません。 セルフホステッド統合ランタイムをインストールする前に、コンピューターに適切な電源プランを構成します。 コンピューターが休止状態に構成されている場合、セルフホステッド統合ランタイム インストーラーによってメッセージが表示されます。

• セルフホステッド統合ランタイムを正常にインストールして構成するには、コンピューターの管理者である必要があります。

• スキャン実行は、設定したスケジュールに従って特定の頻度で実行されます。 マシン上のプロセッサと RAM の使用量は、ピーク時とアイドル時間で同じパターンに従います。 リソースの使用量は、スキャンされるデータの量にも大きく依存します。 複数のスキャン ジョブが進行中の場合、ピーク時にリソース使用量が増えることがわかります。

セルフホステッド IR の使用に関する考慮事項

• 1 つのセルフホステッド統合ランタイムを使用して、複数のデータ ソースをスキャンできます。
• セルフホステッド統合ランタイムのインスタンスは、任意の 1 台のマシンに 1 つだけインストールできます。 オンプレミスのデータ ソースをスキャンする必要がある 2 つの Microsoft Purview アカウントがある場合は、セルフホステッド IR を 2 台のマシン (Microsoft Purview アカウントごとに 1 つ) にインストールします。
• セルフホステッド統合ランタイムは、各ソース記事の前提条件として特に呼び出されない限り、データ ソースと同じコンピューター上にある必要はありません。 セルフホステッド統合ランタイムをデータ ソースの近くに設定すると、セルフホステッド統合ランタイムがデータ ソースに接続する時間が短縮されます。

セルフホステッド統合ランタイムの設定

セルフホステッド統合ランタイムを作成して設定するには、次の手順を使用します。

セルフホステッド統合ランタイムを作成する

1. Microsoft Purview ガバナンス ポータルのホーム ページで、左側のナビゲーション ウィンドウから [データ マップ] を選択します。

2. 左側のウィンドウの [ ソースとスキャン ] で、[ 統合ランタイム] を選択し、[ + 新規] を選択します。

   

3. [ 統合ランタイムのセットアップ ] ページ で、[セルフホステッド ] を選択してセルフホステッド IR を作成し、[ 続行] を選択します。

   

4. IR の名前を入力し、[作成] を選択します。

5. [Integration Runtime設定] ページで、[手動セットアップ] セクションの手順に従います。 統合ランタイムをダウンロード サイトから、実行する VM またはマシンにダウンロードする必要があります。

   

   • 認証キーをコピーして貼り付けます。

   • ローカル Windows マシン上のMicrosoft Integration Runtimeからセルフホステッド統合ランタイムをダウンロードします。 インストーラーを実行します。 5.4.7803.1 や 5.6.7795.1 などのセルフホステッド統合ランタイム バージョンがサポートされています。

   • [Integration Runtime (セルフホステッド)登録] ページで、先ほど保存した 2 つのキーのいずれかを貼り付けて、[登録] を選択します。

     

   • [新しいIntegration Runtime (セルフホステッド) ノード] ページで、[完了] を選択します。

6. セルフホステッド統合ランタイムが正常に登録されると、次のウィンドウが表示されます。

   

同じキーを使用して、セルフホステッド統合ランタイムに複数のノードを登録できます。 高可用性とスケーラビリティの詳細については、こちらをご覧ください。

セルフホステッド統合ランタイムを管理する

セルフホステッド統合ランタイムを編集するには、Microsoft Purview ガバナンス ポータルで [統合ランタイム ] に移動し、IR にマウス ポインターを合わせ、[ 編集 ] ボタンを選択します。

• [ 設定] タブでは、説明の更新、キーのコピー、または新しいキーの再生成を行うことができます。
• [ ノード ] タブには、登録済みノードの一覧と、ノード削除の状態、IP アドレス、オプションが表示されます。 高可用性とスケーラビリティの詳細については、こちらをご覧ください。
• [ バージョン ] タブで、IR バージョンの状態を確認できます。 セルフホステッド統合ランタイムの自動更新と期限切れの通知に関するページを参照してください。

セルフホステッド統合ランタイムを削除するには、[ 統合ランタイム] に移動し、IR にカーソルを合わせ、[ 削除 ] ボタンを選択します。

通知領域のアイコンと通知

通知領域のアイコンまたはメッセージの上にカーソルを移動すると、セルフホステッド統合ランタイムの状態の詳細を確認できます。

セルフホステッド統合ランタイムのサービス アカウント

セルフホステッド統合ランタイムの既定のサインイン サービス アカウントは NT SERVICE\DIAHostService です。 [サービス] - [Integration Runtime サービス] -> [プロパティ] ->> [ログオン] で確認できます。

アカウントにサービスとしてのログオンのアクセス許可があることを確認します。 そうしないと、セルフホステッド統合ランタイムを正常に開始できません。 アクセス許可は、[ローカル セキュリティ ポリシー] - [セキュリティ設定] -> [ローカル ポリシー] -> [ユーザー権利の割り当て] ->> [サービスとしてログオン] でチェックできます。

高可用性とスケーラビリティ

セルフホステッド統合ランタイムは、Azure 内の複数のオンプレミス マシンまたは仮想マシンに関連付けることができます。 これらのマシンはノードと呼ばれます。 セルフホステッド統合ランタイムには、最大 4 つのノードを関連付けることができます。 複数のノードを持つことの利点は次のとおりです。

• セルフホステッド統合ランタイムの可用性が高くなり、スキャンの単一障害点ではなくなります。 この可用性は、最大 4 つのノードを使用する場合の継続性を確保するのに役立ちます。
• より多くの同時実行スキャンを実行します。 セルフホステッド統合ランタイムごとに、マシンの CPU/メモリに基づいて自動的に決定される、多くのスキャン実行を同時に支援できます。 コンカレンシーが必要な場合は、より多くのノードをインストールできます。
• Azure Blob、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2、Azure Filesなどのソースをスキャンする場合、各スキャン実行では、これらのすべてのノードを利用してスキャンパフォーマンスを向上させることができます。 その他のソースの場合は、いずれかのノードでスキャンが実行されます。

ダウンロード センターからセルフホステッド統合ランタイム ソフトウェアをインストールすることで、複数のノードを関連付けることができます。 次に、同じ認証キーを使用して登録します。

ネットワークの要件

セルフホステッド統合ランタイム マシンが正しく動作するには、複数のリソースに接続する必要があります。

• セルフホステッド統合ランタイムの管理に使用される Microsoft Purview サービス。
• セルフホステッド統合ランタイムを使用してスキャンするデータ ソース。
• Microsoft Purview によって作成されたマネージド ストレージ アカウント。 Microsoft Purview では、これらのリソースを使用してスキャンの結果を取り込みます。そのため、セルフホステッド統合ランタイムはこれらのリソースと接続できる必要があります。

考慮すべきファイアウォールは 2 つあります。

• organizationの中央ルーターで実行される企業ファイアウォール
• セルフホステッド統合ランタイムがインストールされているローカル コンピューターでデーモンとして構成されている Windows ファイアウォール

企業ファイアウォールと Windows/マシン ファイアウォールの両方で許可する必要があるドメインと送信ポートを次に示します。

スキャンするソースに応じて、他の Azure または外部ソースの他のドメインと送信ポートも許可する必要があります。 いくつかの例を次に示します。

Azure SQL Database や Azure Storage などの一部のクラウド データ ストアでは、ファイアウォール構成でセルフホステッド統合ランタイム マシンの IP アドレスを許可する必要がある場合や、セルフホステッド統合ランタイムのネットワークでサービスのプライベート エンドポイントを作成する必要がある場合があります。

Azure Relay の URL を取得する

ファイアウォールの許可リストに入れる必要がある必要があるドメインとポートの 1 つは、Azure Relay への通信用です。 セルフホステッド統合ランタイムは、テスト接続やフォルダー/テーブルリストの参照など、対話型のオーサリングに使用します。 .servicebus.windows.net を許可せず、より具体的な URL を使用する場合は、セルフホステッド統合ランタイムで必要なすべての FQDN を確認できます。 次の手順を実行します。

1. Microsoft Purview ガバナンス ポータル - データ マップ ->> 統合ランタイムに移動し、セルフホステッド統合ランタイムを編集します。

2. [編集] ページで、[ノード] タブ を 選択します。

3. [ サービス URL の表示] を 選択して、すべての FQDN を取得します。

   

4. これらの FQDN は、ファイアウォール規則の許可リストに追加できます。

プロキシ サーバーに関する考慮事項

企業ネットワーク環境でプロキシ サーバーを使用してインターネットにアクセスする場合は、適切なプロキシ設定を使用するようにセルフホステッド統合ランタイムを構成します。 最初の登録フェーズ中、または登録後にプロキシを設定できます。

構成すると、セルフホステッド統合ランタイムはプロキシ サーバーを使用して、HTTP または HTTPS プロトコルを使用するサービスに接続します。 このため、初期セットアップ時に [リンクの変更 ] を選択します。

Microsoft Purview でサポートされる構成オプションは 2 つあります。

• プロキシを使用しない: セルフホステッド統合ランタイムは、クラウド サービスへの接続にプロキシを明示的に使用しません。
• システム プロキシを使用する: セルフホステッド統合ランタイムは、実行可能ファイルの構成ファイルで構成されているプロキシ設定を使用します。 これらのファイルにプロキシが指定されていない場合、セルフホステッド統合ランタイムはプロキシを介さずにサービスに直接接続します。
• カスタム プロキシを使用する: diahost.exe.config と diawp.exe.config で構成を使用する代わりに、セルフホステッド統合ランタイムに使用する HTTP プロキシ設定を構成します。 アドレス と ポート の値が必要です。 プロキシの認証設定に応じて、ユーザー名とパスワードの値は省略可能です。 すべての設定は、セルフホステッド統合ランタイム上の Windows DPAPI で暗号化され、コンピューターにローカルに格納されます。

更新されたプロキシ設定を保存すると、統合ランタイム ホスト サービスが自動的に再起動されます。

セルフホステッド統合ランタイムを登録した後、プロキシ設定を表示または更新する場合は、Microsoft Integration Runtime Configuration Managerを使用します。

1. Microsoft Integration Runtime Configuration Managerを開きます。
2. [設定] タブを選択します。
3. [ HTTP プロキシ] で、[ 変更 ] リンクを選択して [ HTTP プロキシの設定 ] ダイアログ ボックスを開きます。
4. [次へ] を選択します。 その後、プロキシ設定を保存し、統合ランタイム ホスト サービスを再起動するためのアクセス許可を求める警告が表示されます。

システム プロキシを使用している場合は、プロキシ サーバーで ネットワーク 規則への送信トラフィックが許可されていることを確認します。

プロキシ サーバーの設定を構成する

HTTP プロキシの [システム プロキシの使用] オプションを選択した場合、セルフホステッド統合ランタイムは、パス C:\Program Files\Microsoft Integration Runtime\5.0\ の下にある次の 4 つのファイルのプロキシ設定を使用して、さまざまな操作を実行します。

• .\Shared\diahost.exe.config
• .\Shared\diawp.exe.config
• .\Gateway\DataScan\Microsoft.DataMap.Agent.exe.config
• .\Gateway\DataScan\DataTransfer\Microsoft.DataMap.Agent.Connectors.Azure.DataFactory.ServiceHost.exe.config

これらのファイルにプロキシが指定されていない場合、セルフホステッド統合ランタイムはプロキシを介さずにサービスに直接接続します。

次の手順では、 diahost.exe.config ファイルを更新する手順を示します。

1. エクスプローラーで、元のファイルのバックアップとして C:\Program Files\Microsoft Integration Runtime\5.0\Shared\diahost.exe.config の安全なコピーを作成します。

2. 管理者として実行されているメモ帳を開きます。

3. メモ帳で、テキスト ファイル C:\Program Files\Microsoft Integration Runtime\5.0\Shared\diahost.exe.config を開きます。

4. 次のコードに示すように、既定の system.net タグを見つけます。

   <system.net>
       <defaultProxy useDefaultCredentials="true" />
   </system.net>
   

   次の例に示すように、プロキシ サーバーの詳細を追加できます。

   <system.net>
     <defaultProxy>
       <proxy bypassonlocal="true" proxyaddress="<your proxy server e.g. http://proxy.domain.org:8888/>" />
     </defaultProxy>
   </system.net>
   

   プロキシ タグを使用すると、他のプロパティで などの scriptLocation必要な設定を指定できます。 構文については、「proxy> 要素 (ネットワーク設定)」を参照してください<。

   <proxy autoDetect="true|false|unspecified" bypassonlocal="true|false|unspecified" proxyaddress="uriString" scriptLocation="uriString" usesystemdefault="true|false|unspecified "/>
   

5. 構成ファイルを元の場所に保存します。

同じ手順を繰り返して 、diawp.exe.config ファイルと Microsoft.DataMap.Agent.exe.config ファイルを更新します。

次に、パス C:\Program Files\Microsoft Integration Runtime\5.0\Gateway\DataScan\DataTransfer に移動し、"Microsoft.DataMap.Agent.Connectors.Azure.DataFactory.ServiceHost.exe.config" という名前のファイルを作成し、プロキシ設定を次のように構成します。 上記のように設定を拡張することもできます。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.net>
    <defaultProxy>
      <proxy bypassonlocal="true" proxyaddress="<your proxy server e.g. http://proxy.domain.org:8888/>" />
    </defaultProxy>
  </system.net>
</configuration>

Microsoft Purview アカウントがプライベート エンドポイントの背後にある場合など、ローカル トラフィックをプロキシから除外する必要があります。 このような場合は、パスの下にある次の 4 つのファイルを更新して、バイパス リスト C:\Program Files\Microsoft Integration Runtime\5.0\ を必要なバイパス リストに含めます。

• .\Shared\diahost.exe.config
• .\Shared\diawp.exe.config
• .\Gateway\DataScan\Microsoft.DataMap.Agent.exe.config
• .\Gateway\DataScan\DataTransfer\Microsoft.DataMap.Agent.Connectors.Azure.DataFactory.ServiceHost.exe.config

Azure SQL Database および ADLS gen 2 Storage をスキャンするためのバイパス リストの例:

 <system.net>
   <defaultProxy>
     <bypasslist>
       <add address="scaneastus4123.blob.core.windows.net" />
       <add address="scaneastus4123.queue.core.windows.net" />
       <add address="Atlas-abc12345-1234-abcd-a73c-394243a566fa.servicebus.windows.net" />
       <add address="contosopurview123.purview.azure.com" />
       <add address="contososqlsrv123.database.windows.net" />
       <add address="contosoadls123.dfs.core.windows.net" />
       <add address="contosoakv123.vault.azure.net" />
     </bypasslist>
     <proxy proxyaddress=http://proxy.domain.org:8888 bypassonlocal="True" />
   </defaultProxy>
 </system.net>

セルフホステッド統合ランタイム ホスト サービスを再起動し、変更を受け取ります。 サービスを再起動するには、コントロール パネルからサービス アプレットを使用します。 または、Integration Runtime Configuration Managerから [サービスの停止] ボタンを選択し、[サービスの開始] を選択します。 サービスが開始されない場合は、編集したアプリケーション構成ファイルに不適切な XML タグ構文を追加した可能性があります。

また、Microsoft Azure が会社の許可リストに含まれていることも確認する必要があります。 有効な Azure IP アドレスの一覧をダウンロードできます。 各クラウドの IP 範囲 (リージョン別と、そのクラウド内のタグ付けされたサービス別に分類) が MS ダウンロードで利用できるようになりました。

• 公共： https://www.microsoft.com/download/details.aspx?id=56519

ファイアウォールとプロキシ サーバーに関連する問題の考えられる現象

次のようなエラー メッセージが表示される場合は、ファイアウォールまたはプロキシ サーバーの不適切な構成が原因である可能性があります。 このような構成により、セルフホステッド統合ランタイムが Microsoft Purview サービスに接続できなくなります。 ファイアウォールとプロキシ サーバーが正しく構成されていることを確認するには、前のセクションを参照してください。

• セルフホステッド統合ランタイムを登録しようとすると、次のエラー メッセージが表示されます。"このIntegration Runtime ノードを登録できませんでした! 認証キーが有効であり、統合サービス ホスト サービスがこのマシンで実行されていることを確認します。

• Integration Runtime Configuration Managerを開くと、[切断済み] または [接続中] の状態が表示されます。 Windows イベント ログを表示すると、[イベント ビューアー>Application and Services Logs>Microsoft Integration Runtimeに次のようなエラー メッセージが表示されます。

  Unable to connect to the remote server
  A component of Integration Runtime has become unresponsive and restarts automatically. Component name: Integration Runtime (Self-hosted)
  

Java ランタイム環境のインストール

Microsoft Purview とセルフホステッド統合ランタイムを使用して Parquet ファイルをスキャンする場合は、セルフホステッド IR マシンに Java ランタイム環境または OpenJDK をインストールする必要があります。

セルフホステッド IR を使用して Parquet ファイルをスキャンする場合、サービスは最初にレジストリの JRE を確認 (HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\{Current Version}\JavaHome) し、見つからない場合は 2 番目にシステム変数 JAVA_HOME の OpenJDK をチェックすることで、Java ランタイムを検索します。 JAVA_HOMEは、コンピューターの [システム設定] の [環境変数] で設定できます。 マシン上の Java jre を指すJAVA_HOME変数を作成または編集します。 例: C:\Program Files\Java\jdk1.8\jre

• JRE を使用するには:64 ビット IR には 64 ビット JRE が必要です。 ここから見つけることができます。
• OpenJDK を使用するには: IR バージョン 3.13 以降でサポートされています。 OpenJDK の他のすべての必要なアセンブリと共に jvm.dll をセルフホステッド IR マシンにパッケージ化し、それに応じてシステム環境変数をJAVA_HOME設定します。

次の手順

• Microsoft Purview ネットワーク アーキテクチャとベスト プラクティス

• Microsoft Purview でプライベート エンドポイントを使用する