📣
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. 右上隅の接続をクリックしてください。接続ダイアログが表示されます。

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

      • 接続タイプはPublicに設定されています。
      • ブランチはmainに設定されています。
      • 「接続」はMySQL Workbenchに設定されています。
      • お使いの環境に合ったオペレーティングシステムを選択してください。

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

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

      MySQL Workbench: add new connection

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

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

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

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

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

      • パスワード： [キーチェーンに保存...]または[Vaultに保存]をクリックし、手順4で作成したパスワードを入力して、 [OK]をクリックしてパスワードを保存します。

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

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

      MySQL Workbench: configure connection settings for TiDB Cloud Starter

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

    8. 接続テストが成功すると、 「MySQL接続が正常に確立されました」というメッセージが表示されます。 OKをクリックして接続設定を保存してください。

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

    2. 左側のナビゲーションペインで、 [設定] > [ネットワーク]をクリックします。

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

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

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

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

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

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

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

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

      • 接続名：この接続に分かりやすい名前を付けてください。
      • ホスト名： TiDB Cloud接続ダイアログからHOSTパラメータを入力します。
      • ポート: TiDB Cloud接続ダイアログからPORTパラメータを入力します。
      • ユーザー名： TiDB Cloud接続ダイアログからUSERNAMEパラメータを入力してください。
      • パスワード： [キーチェーンに保存...]または[Vaultに保存]をクリックし、 TiDB Cloud Premiumインスタンスのパスワードを入力して、 [OK]をクリックするとパスワードが保存されます。

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

    10. 接続テストが成功すると、 「MySQL接続が正常に確立されました」というメッセージが表示されます。 OKをクリックして接続設定を保存してください。

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

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

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

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

      TiDB Cloud Dedicated は、パブリック接続タイプに加えて、プライベート エンドポイントおよびVPC ピアリング接続タイプもサポートしています。詳細については、 TiDB Cloud Dedicatedクラスタに接続しますを参照してください。

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

      MySQL Workbench: add new connection

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

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

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

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

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

      • パスワード： [キーチェーンに保存...]をクリックし、 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. 接続テストをクリックして、 TiDB Cloud Dedicatedクラスターへの接続を検証してください。

    7. 接続テストが成功すると、 「MySQL接続が正常に確立されました」というメッセージが表示されます。 OKをクリックして接続設定を保存してください。

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

      MySQL Workbench: add new connection

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

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

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

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

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

      • パスワード： [キーチェーンに保存...]をクリックし、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. 接続テストをクリックして、TiDB Self-Managedクラスタへの接続を検証してください。

    4. 接続テストが成功すると、 「MySQL接続が正常に確立されました」というメッセージが表示されます。 OKをクリックして接続設定を保存してください。

    よくある質問

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

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

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

    2. SQL Editor > MySQL Sessionセクションで、 DBMS接続読み取りタイムアウト間隔（秒）オプションを設定します。これは、MySQL Workbenchがサーバーから切断されるまでにクエリが実行できる最大時間（秒単位）を設定します。

      MySQL Workbench: adjust timeout option in SQL Editor settings

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

    次のステップ

    お困りですか？

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