MySQL Workbench を使用して TiDB に接続する
TiDB は MySQL と互換性のあるデータベースであり、 MySQL ワークベンチは MySQL データベース ユーザー向けの GUI ツール セットです。
このチュートリアルでは、MySQL Workbench を使用して TiDB クラスターに接続する方法を学習できます。
注記：
このチュートリアルは、TiDB サーバーレス、TiDB 専用、および TiDB セルフホストと互換性があります。
前提条件
このチュートリアルを完了するには、次のものが必要です。
- MySQL ワークベンチ 8.0.31以降のバージョン。
- TiDB クラスター。
TiDB クラスターがない場合は、次のように作成できます。
- (推奨) TiDB サーバーレスクラスターの作成に従って、独自のTiDB Cloudクラスターを作成します。
- ローカル テスト TiDB クラスターをデプロイまたは本番TiDB クラスターをデプロイに従ってローカル クラスターを作成します。
TiDB クラスターがない場合は、次のように作成できます。
- (推奨) TiDB サーバーレスクラスターの作成に従って、独自のTiDB Cloudクラスターを作成します。
- ローカル テスト TiDB クラスターをデプロイまたは本番TiDB クラスターをデプロイに従ってローカル クラスターを作成します。
TiDB に接続する
選択した TiDB デプロイメント オプションに応じて、TiDB クラスターに接続します。
- TiDB Serverless
- TiDB Dedicated
- TiDB Self-Hosted
クラスターページに移動し、ターゲット クラスターの名前をクリックして、その概要ページに移動します。
右上隅にある「接続」をクリックします。接続ダイアログが表示されます。
接続ダイアログの設定が動作環境と一致していることを確認してください。
- エンドポイント タイプは
Publicに設定されます。 - ブランチは
mainに設定されます。 - [接続先] は
MySQL Workbenchに設定されます。 - オペレーティング システムが環境に一致します。
- エンドポイント タイプは
「パスワードの生成」をクリックして、ランダムなパスワードを作成します。
ヒント：
以前にパスワードを作成したことがある場合は、元のパスワードを使用するか、 「パスワードのリセット」をクリックして新しいパスワードを生成できます。
MySQL Workbench を起動し、 MySQL Connectionsタイトルの近くにある+をクリックします。
[新しい接続のセットアップ] ダイアログで、次の接続パラメータを構成します。
接続名: この接続に意味のある名前を付けます。
ホスト名: TiDB Cloud接続ダイアログから
HOSTパラメータを入力します。ポート: TiDB Cloud接続ダイアログから
PORTパラメータを入力します。ユーザー名: TiDB Cloud接続ダイアログから
USERNAMEパラメータを入力します。パスワード: [キーチェーンに保存 ...]または[ボールトに保存]をクリックし、TiDB サーバーレス クラスターのパスワードを入力し、 [OK]をクリックしてパスワードを保存します。
次の図は、接続パラメータの例を示しています。
「接続のテスト」をクリックして、TiDB サーバーレスクラスターへの接続を検証します。
接続テストが成功すると、 「MySQL 接続が成功しました」というメッセージが表示されます。 「OK」をクリックして接続構成を保存します。
クラスターページに移動し、ターゲット クラスターの名前をクリックして、その概要ページに移動します。
右上隅にある「接続」をクリックします。接続ダイアログが表示されます。
[どこからでもアクセスを許可する]をクリックします。
接続文字列の取得方法の詳細については、 TiDB専用標準接続を参照してください。
MySQL Workbench を起動し、 MySQL Connectionsタイトルの近くにある+をクリックします。
[新しい接続のセットアップ] ダイアログで、次の接続パラメータを構成します。
接続名: この接続に意味のある名前を付けます。
ホスト名: TiDB Cloud接続ダイアログから
HOSTパラメータを入力します。ポート: TiDB Cloud接続ダイアログから
PORTパラメータを入力します。ユーザー名: TiDB Cloud接続ダイアログから
USERNAMEパラメータを入力します。パスワード: [キーチェーンに保存...]をクリックし、TiDB 専用クラスターのパスワードを入力し、 [OK]をクリックしてパスワードを保存します。
次の図は、接続パラメータの例を示しています。
「接続のテスト」をクリックして、TiDB 専用クラスターへの接続を検証します。
接続テストが成功すると、 「MySQL 接続が成功しました」というメッセージが表示されます。 「OK」をクリックして接続構成を保存します。
MySQL Workbench を起動し、 MySQL Connectionsタイトルの近くにある+をクリックします。
[新しい接続のセットアップ] ダイアログで、次の接続パラメータを構成します。
接続名: この接続に意味のある名前を付けます。
ホスト名: TiDB セルフホスト クラスターの IP アドレスまたはドメイン名を入力します。
ポート: TiDB セルフホスト クラスターのポート番号を入力します。
ユーザー名: TiDB への接続に使用するユーザー名を入力します。
パスワード: [キーチェーンに保存...]をクリックし、TiDB クラスターへの接続に使用するパスワードを入力し、 [OK]をクリックしてパスワードを保存します。
次の図は、接続パラメータの例を示しています。
[接続のテスト]をクリックして、TiDB セルフホスト クラスターへの接続を検証します。
接続テストが成功すると、 「MySQL 接続が成功しました」というメッセージが表示されます。 「OK」をクリックして接続構成を保存します。
よくある質問
接続タイムアウト エラー「エラー コード: 2013。クエリ中に MySQLサーバーへの接続が失われました」を処理する方法は?
このエラーは、クエリの実行時間がタイムアウト制限を超えたことを示します。この問題を解決するには、次の手順でタイムアウト設定を調整します。
MySQL Workbench を起動し、 Workbench の設定ページに移動します。
[SQL エディター] > [MySQL セッション]セクションで、 DBMS 接続読み取りタイムアウト間隔 (秒単位)オプションを構成します。これは、MySQL Workbench がサーバーから切断されるまでのクエリにかかる最大時間 (秒単位) を設定します。
詳細については、 MySQL Workbench に関するよくある質問を参照してください。
次のステップ
- MySQL Workbench の詳しい使い方をMySQL Workbench のドキュメントから学びましょう。
- TiDB アプリケーション開発のSQLパフォーマンスの最適化プラクティスについてトランザクション 、 開発者ガイドの章 ( データの挿入など) データを更新する参照データの削除 単一テーブルの読み取りください。
- プロフェッショナルとしてTiDB 開発者コースを学び、試験合格後にTiDB 認定獲得します。
助けが必要？
不和またはサポートチケットを作成するについて質問してください。
不和またはサポートチケットを作成するについて質問してください。