📣
TiDB Cloud Premium はパブリックプレビュー中です。エンタープライズワークロード向けの無制限のスケーリング、即時の弾力性、高度なセキュリティを提供します。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者
ベストプラクティス
API

Azureプライベートリンクを介してTiDB Cloud Dedicatedクラスタに接続する

このドキュメントではAzure プライベートリンク経由でTiDB Cloud Dedicatedクラスターに接続する方法について説明します。

TiDB Cloud は、 Azure プライベートリンク仮想ネットワークでホストされているTiDB Cloudサービスへの、Azure 経由の高度に安全な一方向アクセスをサポートしています。まるでサービスがお客様自身の仮想ネットワーク内にあるかのようにアクセスできます。仮想ネットワーク内にプライベートエンドポイントを作成し、そのエンドポイントを介して権限を付与してTiDB Cloudサービスに接続できます。

Azure Private Link を利用したエンドポイント接続は、安全かつプライベートであり、データがパブリックインターネットに公開されることはありません。さらに、エンドポイント接続は CIDR オーバーラップをサポートしており、ネットワーク管理が容易です。

Azure Private Link のアーキテクチャは次のとおりです: 1

Azure Private Link architecture

プライベートエンドポイントとエンドポイントサービスのより詳細な定義については、以下のAzureドキュメントを参照してください。

制限

  • Organization OwnerおよびProject Ownerロールのみがプライベートエンドポイントを作成できます。
  • 接続するプライベートエンドポイントとTiDBクラスタは、同じリージョンに配置されている必要があります。

プライベートエンドポイント経由でTiDB Cloud Dedicatedクラスタに接続するには、以下の手順を実行してください。

  1. TiDBクラスタを選択してください
  2. Azureプライベートエンドポイントを作成する
  3. エンドポイントを受け入れる
  4. TiDBクラスターに接続します

複数のクラスターがある場合は、Azure Private Link を使用して接続する各クラスターに対して、これらの手順を繰り返す必要があります。

ステップ1. TiDBクラスタを選択します

  1. My TiDBページで、対象のTiDB Cloud Dedicatedクラスタの名前をクリックすると、その概要ページに移動します。
  2. 右上隅の接続をクリックしてください。接続ダイアログが表示されます。
  3. Connection TypeドロップダウンリストでPrivate Endpointを選択し、 Create Private Endpoint Connectionをクリックして、 Azureプライベートエンドポイント接続の作成ダイアログを開きます。

ステップ2. Azureプライベートエンドポイントを作成する

  1. Azureプライベートエンドポイント接続の作成ダイアログで、プライベートリンクサービスのTiDB CloudリソースIDをコピーし、後で使用するためにダイアログを開いたままにしておきます。

  2. AzureポータルまたはAzure CLIを使用して、プライベートエンドポイントを作成します。

    1. Azureポータルにログインします。

    2. Private endpointsを検索し、検索結果からPrivate endpointsを選択してください。

    3. Private endpointページで、 + Createをクリックします。

    4. 基本タブで、プロジェクトとインスタンスの情報を入力し、 Next: Resourceをクリックします。

    5. リソースタブで、接続方法としてリソース ID またはエイリアスを使用して Azure リソースに接続するを選択し、コピーしたTiDB Cloudリソース ID をResource ID or aliasフィールドに貼り付けます。

    6. 引き続き次へをクリックして残りの構成タブに進み、必要な設定を完了します。次に、 [作成]をクリックしてプライベート エンドポイントを作成してデプロイします。 Azure のデプロイが完了するまでに数秒かかる場合があります。詳細については、Azure ドキュメントのプライベートエンドポイントを作成するを参照してください。

    7. プライベートエンドポイントの作成とデプロイが完了したら、 Go to resourceをクリックし、以下の手順を実行してください。

      • 左側のナビゲーションペインで設定 ＞ プロパティをクリックし、後で使用するためにResource IDをコピーしてください。

        Azure private endpoint resource ID

      • 左側のナビゲーションペインで設定 ＞ DNS configurationをクリックし、後で使用するためにIP addressをコピーしてください。

        Azure private endpoint DNS IP

    1. Azure CLI にサインインして、サブスクリプションを選択してください。

      az login
az account set --subscription ${your_subscription_id}

    2. Azureプライベートエンドポイント接続の作成ダイアログからコピーしたTiDB CloudリソースIDを使用して、プライベートエンドポイントを作成します。

      az network private-endpoint create \
  --name ${your_private_endpoint_name} \
  --resource-group ${your_resource_group_name} \
  --vnet-name ${your_vnet_name} \
  --subnet ${your_subnet_name} \
  --private-connection-resource-id "${your_tidb_cloud_resource_id}" \
  --connection-name ${your_private_endpoint_connection_name} \
  --location ${your_region}

    3. プライベートエンドポイントのResource IDを取得します。

      az network private-endpoint show \
  --name ${your_private_endpoint_name} \
  --resource-group ${your_resource_group_name} \
  --query "id" \
  --output tsv

    4. DNS設定からプライベートエンドポイントのIP addressを取得します。

      az network private-endpoint show \
  --name ${your_private_endpoint_name} \
  --resource-group ${your_resource_group_name} \
  --query "customDnsConfigs[0].ipAddresses[0]" \
  --output tsv

    ステップ3. エンドポイントを受け入れる

    1. TiDB CloudコンソールのAzureプライベートエンドポイント接続の作成ダイアログに戻り、コピーしたResource IDとIP addressそれぞれのフィールドに貼り付けます。
    2. Verify Endpointをクリックして、プライベートエンドポイントへのアクセスを検証してください。エラーが発生した場合は、エラーメッセージの手順に従ってトラブルシューティングを行い、再度お試しください。
    3. 検証が成功したら、 Accept Endpointをクリックして、プライベートエンドポイントからの接続を承認してください。

    ステップ4. TiDBクラスターに接続します

    エンドポイント接続を承認すると、接続ダイアログにリダイレクトされます。

    1. プライベートエンドポイントの接続ステータスがアクティブになるまでお待ちください（約5分）。ステータスを確認するには、左側のナビゲーションペインで設定 > ネットワークをクリックして、 ネットワークページに移動してください。
    2. Connect Withドロップダウンリストから、希望する接続方法を選択してください。対応する接続​​文字列がダイアログの下部に表示されます。
    3. 接続文字列を使用してクラスターに接続してください。

    プライベートエンドポイントの状態参照

    プライベートエンドポイントまたはプライベートエンドポイントサービスのステータスを表示するには、左側のナビゲーションペインで設定 > ネットワークをクリックして、 ネットワークページに移動します。

    プライベートエンドポイントの可能なステータスは、以下のように説明されます。

    • 発見： TiDB Cloudは、リクエストを受け入れる前にエンドポイントサービスに関連付けられたプライベートエンドポイントを自動的に検出できるため、別のエンドポイントを作成する必要がなくなります。
    • 保留中：処理待ち。
    • アクティブ：プライベートエンドポイントは使用可能です。このステータスのプライベートエンドポイントは編集できません。
    • 削除中：プライベートエンドポイントが削除されています。
    • 失敗：プライベートエンドポイントの作成に失敗しました。該当行の「編集」をクリックすると、作成を再試行できます。

    プライベートエンドポイントサービスの可能なステータスは、以下のように説明されます。

    • 作成中：エンドポイントサービスが作成されています。これには3～5分かかります。
    • アクティブ：プライベートエンドポイントが作成されるかどうかに関わらず、エンドポイントサービスが作成されます。

    トラブルシューティング

    TiDB Cloudでエンドポイントサービスの作成に失敗しました。どうすればよいですか？

    Create Azure Private Endpointページを開き、TiDB クラスターを選択すると、エンドポイント サービスは自動的に作成されます。失敗と表示される場合、または作成中の状態が長時間続く場合は、サポートに問い合わせてサポートチケットを受けてください。

    セットアップ中にアクションをキャンセルした場合、プライベートエンドポイントを受け入れる前に何をすべきですか？

    Azure プライベート エンドポイント接続機能は、プライベート エンドポイントを自動的に検出できます。つまり、 Azureプライベートエンドポイントの作成Azure ポータルで、 TiDB Cloudコンソールの [ Azure プライベート エンドポイント接続の作成] ダイアログで[キャンセル] をクリックしても、作成されたエンドポイントを[ネットワーク]ページで表示できます。キャンセルが意図的でない場合は、エンドポイントの設定を続行してセットアップを完了できます。キャンセルが意図的な場合は、TiDB Cloudコンソールでエンドポイントを直接削除できます。

    1. Azure Private Linkアーキテクチャの図は、Creative Commons Attribution 4.0 International に基づいてライセンスされている、Azure ドキュメントの「AzureプライベートリンクサービスAzureプライベートリンクサービスとは何ですか？ドキュメント ( ソースファイルはGitHubにあります) からのものです。↩

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