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

MySQL Workbenchを使用してTiDBに接続する

TiDBはMySQL互換データベースであり、 MySQL WorkchenはMySQLデータベースユーザー向けのGUIツールセットです。

このチュートリアルでは、MySQL Workbenchを使用してTiDBに接続する方法を学ぶことができます。

前提条件

このチュートリアルを完了するには、以下が必要です。

TiDBクラスタをお持ちでない場合は、以下の手順で作成できます。

TiDBに接続する

選択したTiDBのデプロイオプションに応じて、TiDBに接続してください。

    1. My TiDBページに移動し、対象のTiDB Cloud StarterまたはEssentialインスタンスの名前をクリックして、概要ページに移動します。

    2. 右上隅のConnectをクリックしてください。接続ダイアログが表示されます。

    3. 接続ダイアログの設定がご使用のオペレーティング環境と一致していることを確認してください。

      • Connection TypeはPublicに設定されています。
      • Branchはmainに設定されています。
      • Connect WithはMySQL Workbenchに設定されています。
      • お使いの環境に合ったOperating Systemを選択してください。

    4. Generate Passwordをクリックすると、ランダムなパスワードが生成されます。

    5. MySQL Workbenchを起動し、 MySQL Connectionsタイトルの横にある+をクリックします。

      MySQL Workbench: add new connection

    6. Setup New Connectionダイアログで、以下の接続パラメータを設定します。

      • Connection Name：この接続に分かりやすい名前を付けてください。

      • Hostname： TiDB Cloud接続ダイアログからHOSTパラメータを入力します。

      • Port: TiDB Cloud接続ダイアログからPORTパラメータを入力します。

      • Username： TiDB Cloud接続ダイアログからUSERNAMEパラメータを入力してください。

      • Password： Store in Keychain ...またはStore in Vaultをクリックし、手順4で作成したパスワードを入力して、 OKをクリックしてパスワードを保存します。

        MySQL Workbench: store the password of TiDB Cloud Starter in keychain

      次の図は、接続パラメータの例を示しています。

      MySQL Workbench: configure connection settings for TiDB Cloud Starter

    7. Test Connectionをクリックして、対象のTiDB Cloud StarterまたはEssentialインスタンスへの接続を検証してください。

    8. 接続テストが成功すると、 Successfully made the MySQL connectionというメッセージが表示されます。 OKをクリックして接続設定を保存してください。

    1. My TiDBページに移動し、対象のTiDB Cloud Premiumインスタンスの名前をクリックして概要ページに移動します。

    2. 左側のナビゲーションペインで、 Settings > Networkingをクリックします。

    3. Networkingページで、Public EndpointのEnableをクリックし、次にAdd IP Addressをクリックします。

      クライアントのIPアドレスがアクセスリストに追加されていることを確認してください。

    4. 左側のナビゲーションペインでOverviewをクリックすると、インスタンスの概要ページに戻ります。

    5. 右上隅のConnectをクリックしてください。接続ダイアログが表示されます。

    6. 接続ダイアログで、 Connection TypeドロップダウンリストからPublicを選択します。

      • 公開エンドポイントがまだ有効化中であることを示すメッセージが表示された場合は、処理が完了するまでお待ちください。
      • まだパスワードを設定していない場合は、ダイアログのSet Root Passwordをクリックしてください。
      • サーバー証明書を確認する必要がある場合、または接続に失敗して認証局（CA）証明書が必要な場合は、 CA certをクリックしてダウンロードしてください。
      • Public接続タイプに加えて、 TiDB Cloud Premium はPrivate Endpoint接続をサポートします。詳細については、 AWS PrivateLink経由でTiDB Cloud Premiumに接続しますを参照してください。

    7. MySQL Workbenchを起動し、 MySQL Connectionsタイトルの横にある+をクリックします。

    8. Setup New Connectionダイアログで、以下の接続パラメータを設定します。

      • Connection Name：この接続に分かりやすい名前を付けてください。
      • Hostname： TiDB Cloud接続ダイアログからHOSTパラメータを入力します。
      • Port: TiDB Cloud接続ダイアログからPORTパラメータを入力します。
      • Username： TiDB Cloud接続ダイアログからUSERNAMEパラメータを入力してください。
      • Password： Store in Keychain ...またはStore in Vaultをクリックし、 TiDB Cloud Premiumインスタンスのパスワードを入力して、 OKをクリックするとパスワードが保存されます。

    9. Test Connectionをクリックして、 TiDB Cloud Premiumインスタンスへの接続を検証してください。

    10. 接続テストが成功すると、 Successfully made the MySQL connectionというメッセージが表示されます。 OKをクリックして接続設定を保存してください。

    1. My TiDBページに移動し、対象のTiDB Cloud Dedicatedクラスタの名前をクリックして概要ページに移動します。

    2. 右上隅のConnectをクリックしてください。接続ダイアログが表示されます。

    3. 接続ダイアログで、 Connection TypeドロップダウンリストからPublicを選択し、 CA certをクリックしてCA証明書をダウンロードします。

      IP アクセス リストを設定していない場合は、最初の接続の前に、 Configure IP Access Listをクリックするか、IP アクセス リストを設定するの手順に従って設定します。

      TiDB Cloud Dedicated は、Public接続タイプに加えて、Private EndpointおよびVPC Peering接続タイプもサポートしています。詳細については、 TiDB Cloud Dedicatedクラスタに接続しますを参照してください。

    4. MySQL Workbenchを起動し、 MySQL Connectionsタイトルの横にある+をクリックします。

      MySQL Workbench: add new connection

    5. Setup New Connectionダイアログで、以下の接続パラメータを設定します。

      • Connection Name：この接続に分かりやすい名前を付けてください。

      • Hostname： TiDB Cloud接続ダイアログからHOSTパラメータを入力します。

      • Port: TiDB Cloud接続ダイアログからPORTパラメータを入力します。

      • Username： TiDB Cloud接続ダイアログからUSERNAMEパラメータを入力してください。

      • Password： Store in Keychain ...をクリックし、 TiDB Cloud Dedicatedクラスタのパスワードを入力して、 OKをクリックするとパスワードが保存されます。

        MySQL Workbench: store the password of TiDB Cloud Dedicated in keychain

      次の図は、接続パラメータの例を示しています。

      MySQL Workbench: configure connection settings for TiDB Cloud Dedicated

    6. Test Connectionをクリックして、 TiDB Cloud Dedicatedクラスターへの接続を検証してください。

    7. 接続テストが成功すると、 Successfully made the MySQL connectionというメッセージが表示されます。 OKをクリックして接続設定を保存してください。

    1. MySQL Workbenchを起動し、 MySQL Connectionsタイトルの横にある+をクリックします。

      MySQL Workbench: add new connection

    2. Setup New Connectionダイアログで、以下の接続パラメータを設定します。

      • Connection Name：この接続に分かりやすい名前を付けてください。

      • Hostname：TiDB Self-ManagedクラスタのIPアドレスまたはドメイン名を入力してください。

      • Port：TiDB Self-Managedクラスタのポート番号を入力してください。

      • Username：TiDBに接続するために使用するユーザー名を入力してください。

      • Password： Store in Keychain ...をクリックし、TiDB Self-Managedクラスタへの接続に使用するパスワードを入力して、 OKをクリックしてパスワードを保存します。

        MySQL Workbench: store the password of TiDB Self-Managed in keychain

      次の図は、接続パラメータの例を示しています。

      MySQL Workbench: configure connection settings for TiDB Self-Managed

    3. Test Connectionをクリックして、TiDB Self-Managedクラスタへの接続を検証してください。

    4. 接続テストが成功すると、 Successfully made the MySQL connectionというメッセージが表示されます。 OKをクリックして接続設定を保存してください。

    よくある質問

    接続タイムアウトエラー「エラーコード：2013。クエリ実行中にMySQLサーバーへの接続が失われました」への対処方法を教えてください。

    このエラーは、クエリの実行時間がタイムアウト制限を超えたことを示しています。この問題を解決するには、以下の手順でタイムアウト設定を調整してください。

    1. MySQL Workbenchを起動し、 Workbench Preferencesページに移動します。

    2. SQL Editor > MySQL Sessionセクションで、 DBMS connection read timeout interval (in seconds)オプションを設定します。これは、MySQL Workbenchがサーバーから切断されるまでにクエリが実行できる最大時間（秒単位）を設定します。

      MySQL Workbench: adjust timeout option in SQL Editor settings

    詳細については、 MySQL Workbench frequently asked questionsを参照してください。

    次のステップ

    お困りですか？

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