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

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

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

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

注記：

このチュートリアルは、 TiDB Cloud Starter、 TiDB Cloud Essential、 TiDB Cloud Premium、 TiDB Cloud Dedicated、およびTiDB Self-Managedに対応しています。

前提条件

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

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

TiDBに接続する

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

    1. 私の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. 私のTiDBページに移動し、対象のTiDB Cloud Premiumインスタンスの名前をクリックして概要ページに移動します。

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

    3. ネットワークのページで、 [パブリックエンドポイント**を有効にする]をクリックし、次に[IP アドレスの追加]**をクリックします。

      クライアントの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. 私の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セルフマネージドクラスタのIPアドレスまたはドメイン名を入力してください。

      • ポート：TiDBセルフマネージドクラスタのポート番号を入力してください。

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

      • パスワード： [キーチェーンに保存...]をクリックし、TiDBセルフマネージドクラスタへの接続に使用するパスワードを入力して、 [OK]をクリックしてパスワードを保存します。

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

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

      MySQL Workbench: configure connection settings for TiDB Self-Managed

    3. 「接続テスト」をクリックして、TiDBセルフマネージドクラスタへの接続を検証してください。

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

    よくある質問

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

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

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

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

      MySQL Workbench: adjust timeout option in SQL Editor settings

    詳細については、 MySQL Workbenchに関するよくある質問を参照してください。

    次のステップ

    お困りですか？

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