DBeaverを使用してTiDBに接続する
TiDBはMySQL互換データベースであり、 DBeaverコミュニティ開発者、データベース管理者、アナリスト、およびデータを扱うすべての人向けの無料のクロスプラットフォームデータベースツールです。
このチュートリアルでは、DBeaver Communityを使用してTiDBに接続する方法を学ぶことができます。
前提条件
このチュートリアルを完了するには、以下が必要です。
- DBeaver Community 23.0.3以降。
- TiDBクラスタ。
TiDBクラスタをお持ちでない場合は、以下の手順で作成できます。
- (推奨) TiDB Cloud Starterインスタンスを作成する。
- ローカルテスト用のTiDB Self-Managedクラスタをデプロイまたは本番のTiDB Self-Managedクラスタをデプロイ
さらに、 Windows上の DBeaver からTiDB Cloud StarterまたはTiDB Cloud Essential のパブリックエンドポイントに接続するには、以下の手順で追加の SSL 証明書 (ISRG Root X1) を設定する必要があります。設定しない場合、接続は失敗します。その他のオペレーティングシステムの場合は、これらの手順はスキップできます。
ISRGルートX1証明書をダウンロードし、
C:\certs\isrgrootx1.pemなどのローカルパスに保存します。DBeaverで接続設定を編集し、 SSLタブに移動します。
- Use SSLを選択してください。
- CA certificateフィールドで、ダウンロードした
isrgrootx1.pemファイルを選択します。 - その他の証明書欄は空欄のままにしてください。
SSL 構成の競合を避けるため、Driver propertiesタブで、既存の
sslMode、useSSL、またはrequireSSLエントリをすべて削除してください。Test Connectionをクリックして、接続が成功したことを確認してください。
TiDBに接続する
選択したTiDBのデプロイオプションに応じて、TiDBに接続してください。
My TiDBページに移動し、対象のTiDB Cloud StarterまたはEssentialインスタンスの名前をクリックして、概要ページに移動します。
右上隅のConnectをクリックしてください。接続ダイアログが表示されます。
接続ダイアログの設定がご使用のオペレーティング環境と一致していることを確認してください。
- Connection Typeは
Publicに設定されています。 - Branchは
mainに設定されています。 - Connect Withは
DBeaverに設定されています。 - お使いの環境に合ったOperating Systemを選択してください。
- Connection Typeは
Generate Passwordをクリックすると、ランダムなパスワードが生成されます。
DBeaverを起動し、左上隅のNew Database Connectionをクリックします。 Connect to a databaseダイアログで、リストからTiDBを選択し、 Nextをクリックします。
TiDB Cloud接続ダイアログから接続文字列をコピーします。DBeaverで、 Connect byにURLを選択し、 URLフィールドに接続文字列を貼り付けます。
Authentication (Database Native)セクションで、UsernameとPasswordを入力してください。例は以下のとおりです。
Test Connectionをクリックして、対象のTiDB Cloud StarterまたはEssentialインスタンスへの接続を検証してください。
Download driver filesダイアログが表示されたら、 Downloadをクリックしてドライバファイルを入手してください。
接続テストが成功すると、以下のようにConnection testダイアログが表示されます。 OKをクリックして閉じます。
接続設定を保存するには、 Finishをクリックしてください。
My TiDBページに移動し、対象のTiDB Cloud Premiumインスタンスの名前をクリックして概要ページに移動します。
左側のナビゲーションペインで、 Settings > Networkingをクリックします。
Networkingページで、Public EndpointのEnableをクリックし、次にAdd IP Addressをクリックします。
クライアントのIPアドレスがアクセスリストに追加されていることを確認してください。
左側のナビゲーションペインでOverviewをクリックすると、インスタンスの概要ページに戻ります。
右上隅のConnectをクリックしてください。接続ダイアログが表示されます。
接続ダイアログで、 Connection TypeドロップダウンリストからPublicを選択します。
- 公開エンドポイントがまだ有効化中であることを示すメッセージが表示された場合は、処理が完了するまでお待ちください。
- まだパスワードを設定していない場合は、ダイアログのSet Root Passwordをクリックしてください。
- サーバー証明書を確認する必要がある場合、または接続に失敗して認証局(CA)証明書が必要な場合は、 CA certをクリックしてダウンロードしてください。
- Public接続タイプに加えて、 TiDB Cloud Premium はPrivate Endpoint接続をサポートします。詳細については、 AWS PrivateLink経由でTiDB Cloud Premiumに接続しますを参照してください。
DBeaverを起動し、左上隅のNew Database Connectionをクリックします。 Connect to a databaseダイアログで、リストからTiDBを選択し、 Nextをクリックします。
適切な接続文字列をコピーして、DBeaverの接続パネルに貼り付けてください。DBeaverのフィールドとTiDB Cloud Premiumの接続文字列のマッピングは以下のとおりです。
SSL設定は無効のままにしてください。
Test Connectionをクリックして、 TiDB Cloud Premiumインスタンスへの接続を検証してください。
接続設定を保存するには、 Finishをクリックしてください。
My TiDBページに移動し、対象のTiDB Cloud Dedicatedクラスタの名前をクリックして概要ページに移動します。
右上隅のConnectをクリックしてください。接続ダイアログが表示されます。
接続ダイアログで、 Connection TypeドロップダウンリストからPublicを選択し、 CA certをクリックしてCA証明書をダウンロードします。
IP アクセス リストを設定していない場合は、最初の接続の前に、 Configure IP Access Listをクリックするか、IP アクセス リストを設定するの手順に従って設定します。
TiDB Cloud Dedicated は、Public接続タイプに加えて、Private EndpointおよびVPC Peering接続タイプもサポートしています。詳細については、 TiDB Cloud Dedicatedクラスタに接続しますを参照してください。
DBeaverを起動し、左上隅のNew Database Connectionをクリックします。 Connect to a databaseダイアログで、リストからTiDBを選択し、 Nextをクリックします。
適切な接続文字列をコピーして、DBeaverの接続パネルに貼り付けてください。DBeaverのフィールドとTiDB Cloud Dedicatedの接続文字列のマッピングは以下のとおりです。
例えば、以下のような例があります。
Test Connectionをクリックして、 TiDB Cloud Dedicatedクラスターへの接続を検証してください。
Download driver filesダイアログが表示されたら、 Downloadをクリックしてドライバファイルを入手してください。
接続テストが成功すると、以下のようにConnection testダイアログが表示されます。 OKをクリックして閉じます。
接続設定を保存するには、 Finishをクリックしてください。
DBeaverを起動し、左上隅のNew Database Connectionをクリックします。 Connect to a databaseダイアログで、リストからTiDBを選択し、 Nextをクリックします。
以下の接続パラメータを設定してください。
- Server Host:TiDB Self-ManagedクラスタのIPアドレスまたはドメイン名。
- Port:TiDB Self-Managedクラスタのポート番号。
- Username:TiDB Self-Managedクラスタに接続するために使用するユーザー名。
- Password:ユーザー名のパスワード。
例えば、以下のような例があります。
Test Connectionをクリックして、TiDB Self-Managedクラスタへの接続を検証してください。
Download driver filesダイアログが表示されたら、 Downloadをクリックしてドライバファイルを入手してください。
接続テストが成功すると、以下のようにConnection testダイアログが表示されます。 OKをクリックして閉じます。
接続設定を保存するには、 Finishをクリックしてください。
次のステップ
- DBeaver の使用法の詳細についてはDBeaverのドキュメントを参照してください。
- 開発者ガイド の データを挿入する、データの更新、データを削除する、単一表の読み取り、トランザクション、SQLパフォーマンス最適化 などの章を参考に、TiDB アプリケーション開発のベストプラクティスを学びます。
- プロフェッショナルなTiDB開発者向けコースコースを通じて学習し、試験に合格するとTiDB認定資格を取得します。
お困りですか?
- Discordor Slackコミュニティに質問してください。
- TiDB Cloudのサポートチケットを送信してください
- TiDB Self-Managedのサポートチケットを送信してください





