Azure Data Explorer のプライベートエンドポイントを作成する

Azure プライベートエンドポイントを使用して、 Azure 仮想ネットワーク (VNet) 内のクラスターに接続します。

プライベートエンドポイントでは、仮想ネットワークのプライベート IP アドレスを使用して、クラスターにプライベートに接続します。この設定により、プライベートネットワーク上のクライアントとクラスター間のネットワークトラフィックは、仮想ネットワークと Microsoft バックボーンネットワーク上のプライベートリンクを経由して移動します。この記事では、クラスターのプライベートエンドポイントを作成する方法について説明します。

[前提条件]

Azure サブスクリプション。無料の Azure アカウントを作成します。
Azure portal にサインインします。
仮想ネットワークに挿入されていない Azure Data Explorer クラスター。
仮想ネットワーク。

プライベートエンドポイントを作成する

クラスターのプライベートエンドポイントを作成するには、いくつかの方法があります。

ポータルでのクラスターのデプロイ中
プライベートエンドポイントリソースを直接作成する
既存のクラスター上

ポータルでのクラスターのデプロイ中にプライベートエンドポイントを作成する

クラスターの作成時にプライベートエンドポイントを作成するには、次の情報を使用します。

[ Azure Data Explorer クラスターの作成 ] ページで、[ ネットワーク ] タブを選択します。
[ 接続方法] で、[ プライベートエンドポイント] を選択します。
プライベートエンドポイント で追加を選択します。
プライベートエンドポイントを構成します。
クラスターを作成する手順を完了します。

既存のクラスターにプライベートエンドポイントを作成する

既存のクラスターにプライベートエンドポイントを作成するには、次の情報を使用します。

Azure portal でクラスターに移動し、[ ネットワーク] を選択します。
[ プライベートエンドポイント接続] を選択し、[ + プライベートエンドポイント] を選択します。
プライベートエンドポイントを構成します。

プライベートエンドポイントを構成する

[ 基本 ] タブで、基本的なクラスターの詳細に次の情報を入力し、[ 次へ] を選択します。

[プライベートエンドポイントの作成] ページのスクリーンショット。基本情報が表示されています。

設定	推奨値	フィールドの説明
Subscription	あなたのサブスクリプション	プライベートエンドポイントに使用する Azure サブスクリプションを選択する
リソースグループ	該当するリソースグループ	既存のリソースグループを使用するか、新しいリソースグループを作成する
名前	私の新しいプライベートエンドポイント	リソースグループ内のプライベートエンドポイントを識別する名前を選択する
リージョン	(ヨーロッパ)西ヨーロッパ	ニーズに最も適したリージョンを選択する

[ リソース ] タブで、[ ディレクトリ内の Azure リソースに接続] を選択し、リソースの詳細に次の情報を入力して、[ 次へ] を選択します。

リソース情報を示す [プライベートエンドポイントの作成] ページのスクリーンショット。

設定	推奨値	フィールドの説明
Subscription	あなたのサブスクリプション	クラスターに使用する Azure サブスクリプションを選択します
リソースの種類	該当するリソースグループ	[Microsoft.Kusto/clusters] を選択します
Resource	contoso-adx	新しい Azure プライベートエンドポイントの宛先として使用するクラスターを選択する
ターゲットサブリソース	cluster	他のオプションはありません

または、[ リソース ID またはエイリアスで Azure リソースに接続する] を選択することもできます。これは、別のテナント内のクラスターにプライベートエンドポイントを作成したり、リソースに対して少なくともReaderアクセスがない場合にプライベートエンドポイントを作成したりすることを可能にします。

設定	推奨値	フィールドの説明
リソースID またはエイリアス	/サブスクリプション/。。。	あなたと共有されているリソース ID またはエイリアス。リソース ID を取得する最も簡単な方法は、Azure portal でクラスターに移動し、[ プロパティ ] セクションからリソース ID をコピーすることです。
ターゲットサブリソース	cluster	他のオプションはありません
要求メッセージ	承認してください	プライベートエンドポイント接続の管理中にリソース所有者にこのメッセージが表示される

[ 仮想ネットワーク ] タブの [ ネットワーク] で、プライベートエンドポイントをデプロイする 仮想ネットワーク と サブネット を指定します。
[ プライベート IP 構成] で、[ IP アドレスを動的に割り当てる] を選択します。

注

静的割り当て IP アドレス オプションはサポートされていません。
[ プライベート DNS 統合] で、[ プライベート DNS との統合] ゾーンをオンにします。インジェスト機能とエクスポート機能に必要なストレージアカウントを含む、エンジンとデータ管理エンドポイントを解決する必要があります。

注

プライベート DNS 統合オプションを使用することをお勧めします。このオプションを使用できない状況がある場合は、「カスタム DNS サーバーを使用する」の手順に従ってください。
[次へ] を選択します。
[ タグ ] タブで、必要なタグを構成し、[ 次へ] を選択します。
構成の詳細を確認し、[ 作成 ] を選択してプライベートエンドポイントリソースを作成します。

プライベートエンドポイントの作成を確認する

プライベートエンドポイントの作成が完了すると、Azure portal でそのエンドポイントにアクセスできるようになります。

プライベートエンドポイントの作成ページのスクリーンショット。プライベートエンドポイントの作成結果が表示されています。

クラスター用に作成されたすべてのプライベートエンドポイントを表示するには:

Azure portal でクラスターに移動し、[ネットワーク] を選択します
[プライベートエンドポイント] を選択します。この表では、クラスター用に作成されたすべてのプライベートエンドポイントを確認できます。
[ 接続状態 ] 列で、プライベートエンドポイントが承認されていることを確認します。

カスタム DNS サーバーを使用する

状況によっては、仮想ネットワークのプライベート DNS ゾーンと統合できない場合があります。たとえば、独自の DNS サーバーを使用している場合や、仮想マシン上のホストファイルを使用して DNS レコードを作成する場合があります。このセクションでは、DNS ゾーンにアクセスする方法について説明します。

choco をインストールする
ARMClient のインストール
```
choco install armclient
```
ARMClient を使用してログインする
```
armclient login
```

次の REST API 呼び出しを実行して、クラスターのプライベート DNS ゾーンを取得します。

#replace the <...> placeholders with the correct values
armclient GET /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/privateLinkResources?api-version=2022-02-01

応答を確認します。必要な DNS ゾーンは、結果の応答の "requiredZoneNames" 配列にあります。

{
  "value": [
    {
      "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/PrivateLinkResources/cluster",
      "name": "<clusterName>/cluster",
      "type": "Microsoft.Kusto/Clusters/PrivateLinkResources",
      "___location": "<the region of your cluster>",
      "properties": {
        "groupId": "cluster",
        "requiredMembers": [
          "Engine",
          "DataManagement",
          "blob-storageAccount1",
          "queue-storageAccount1",
          "table-storageAccount1",
          "blob-storageAccount2",
          "queue-storageAccount2",
          "table-storageAccount2"
        ],
        "requiredZoneNames": [
          "privatelink.<the region of your cluster>.kusto.windows.net",
          "privatelink.blob.core.windows.net",
          "privatelink.queue.core.windows.net",
          "privatelink.table.core.windows.net"
        ],
        "provisioningState": "Succeeded"
      }
    }
  ]
}

Azure portal でプライベートエンドポイントに移動し、 DNS 構成を選択します。このページでは、DNS 名への IP アドレスマッピングに必要な情報を取得できます。

Warnung

この情報を使用すると、カスタム DNS サーバーを必要なレコードと共に伝達できます。仮想ネットワークのプライベート DNS ゾーンと統合し、独自のカスタム DNS サーバーを構成しないことを強くお勧めします。 Azure Data Explorer クラスターのプライベートエンドポイントの性質は、他の Azure PaaS サービスの場合とは異なります。高いインジェスト負荷などの状況では、スループットを向上させるために、サービスがプライベートエンドポイント経由でアクセスできるストレージアカウントの数をスケールアウトすることが必要になる場合があります。独自のカスタム DNS サーバーを運用することを選択した場合、このような状況で DNS レコードを更新し、後でレコードを削除する必要があります。そして、ストレージアカウントの数が減少した場合には、記録を整理する責任があります。

クラスターのプライベートエンドポイントのトラブルシューティング

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-10-10

次の方法で共有

Azure Data Explorer のプライベート エンドポイントを作成する

[前提条件]

プライベート エンドポイントを作成する

ポータルでのクラスターのデプロイ中にプライベート エンドポイントを作成する

既存のクラスターにプライベート エンドポイントを作成する

プライベート エンドポイントを構成する

プライベート エンドポイントの作成を確認する