📣
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. 私のTiDBページで、対象のTiDB Cloud Dedicatedクラスタの名前をクリックすると、その概要ページに移動します。
  2. 右上隅の「接続」をクリックしてください。接続ダイアログが表示されます。
  3. 「接続の種類」ドロップダウンリストで「プライベートエンドポイント」を選択し、 「プライベートエンドポイント接続の作成」をクリックして、 「Azureプライベートエンドポイント接続の作成」ダイアログを開きます。

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

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

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

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

    2. 「プライベートエンドポイント」を検索し、検索結果から「プライベートエンドポイント」を選択してください。

    3. プライベートエンドポイントのページで、 [+ 作成]をクリックします。

    4. 「基本」タブで、プロジェクトとインスタンスの情報を入力し、 「次へ: リソース」をクリックします。

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

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

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

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

        Azure private endpoint resource ID

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

        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. プライベートエンドポイントのリソースIDを取得します。

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

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

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

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

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

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

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

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

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

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

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

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

    トラブルシューティング

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

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

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

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

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

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