JetBrains DataGrip で TiDB に接続する
TiDB は MySQL 互換のデータベースであり、 ジェットブレインズ データグリップデータベースと SQL 用の強力な統合開発環境 (IDE) です。このチュートリアルでは、DataGrip を使用して TiDB クラスターに接続するプロセスについて説明します。
注記：
このチュートリアルは、 TiDB Cloud Serverless、 TiDB Cloud Dedicated、および TiDB Self-Managed と互換性があります。
DataGrip は次の 2 つの方法で使用できます。
- データグリップ IDEスタンドアロン ツールとして。
- IntelliJ、PhpStorm、PyCharm などの JetBrains IDE のデータベースツールとSQLプラグインとして。
このチュートリアルでは、主にスタンドアロンの DataGrip IDE に焦点を当てています。JetBrains IDE の JetBrains データベース ツールと SQL プラグインを使用して TiDB に接続する手順は同様です。また、任意の JetBrains IDE から TiDB に接続する場合は、このドキュメントの手順を参考にすることもできます。
前提条件
このチュートリアルを完了するには、次のものが必要です。
- DataGrip 2023.2.1以降または非コミュニティ エディションジェットブレインズ IDE。
- TiDB クラスター。
TiDB クラスターがない場合は、次のように作成できます。
- (推奨) TiDB Cloud Serverless クラスターの作成に従って、独自のTiDB Cloudクラスターを作成します。
- ローカルテストTiDBクラスタをデプロイまたは本番のTiDBクラスタをデプロイに従ってローカル クラスターを作成します。
TiDBに接続する
選択した TiDB デプロイメント オプションに応じて、TiDB クラスターに接続します。
- TiDB Cloud Serverless
- TiDB Cloud Dedicated
- TiDB Self-Managed
クラスターページに移動し、ターゲット クラスターの名前をクリックして概要ページに移動します。
右上隅の「接続」をクリックします。接続ダイアログが表示されます。
接続ダイアログの構成が動作環境と一致していることを確認します。
- 接続タイプは
Publicに設定されています - ブランチは
mainに設定されています - 接続先は
DataGripに設定されています - オペレーティング システムは環境に適合します。
- 接続タイプは
ランダムなパスワードを作成するには、 「パスワードの生成」をクリックします。
ヒント：
以前にパスワードを作成したことがある場合は、元のパスワードを使用するか、 「パスワードのリセット」をクリックして新しいパスワードを生成することができます。
DataGrip を起動し、接続を管理するためのプロジェクトを作成します。
新しく作成したプロジェクトで、データベース エクスプローラーパネルの左上隅にある+をクリックし、データ ソース>その他> TiDBを選択します。
TiDB Cloud接続ダイアログから接続文字列をコピーします。次に、それをURLフィールドに貼り付けると、残りのパラメータが自動的に入力されます。結果の例は次のとおりです。
不足しているドライバー ファイルをダウンロードする警告が表示された場合は、 [ダウンロード] をクリックしてドライバー ファイルを取得します。
「テスト接続」をクリックして、 TiDB Cloud Serverless クラスターへの接続を検証します。
[OK]をクリックして接続構成を保存します。
クラスターページに移動し、ターゲット クラスターの名前をクリックして概要ページに移動します。
右上隅の「接続」をクリックします。接続ダイアログが表示されます。
接続ダイアログで、 [接続タイプ]ドロップダウン リストから[パブリック]を選択し、 [CA 証明書]をクリックして CA 証明書をダウンロードします。
IP アクセス リストを設定していない場合は、 「IP アクセス リストの設定」をクリックするか、手順IPアクセスリストを構成するに従って最初の接続の前に設定してください。
TiDB Dedicated は、パブリック接続タイプに加えて、プライベートエンドポイントとVPC ピアリング接続タイプもサポートしています。詳細については、 TiDB専用クラスタに接続するを参照してください。
DataGrip を起動し、接続を管理するためのプロジェクトを作成します。
新しく作成したプロジェクトで、データベース エクスプローラーパネルの左上隅にある+をクリックし、データ ソース>その他> TiDBを選択します。
適切な接続文字列をコピーして、DataGrip の[データ ソースとドライバー]ウィンドウに貼り付けます。DataGrip フィールドとTiDB Cloud Dedicated 接続文字列間のマッピングは次のとおりです。
DataGrip フィールド TiDB Cloud専用接続文字列 ホスト {host}ポート {port}ユーザー {user}パスワード {password}例は以下のとおりです。
SSH/SSLタブをクリックし、 SSL を使用するチェックボックスをオンにして、 CA ファイルフィールドに CA 証明書のパスを入力します。
不足しているドライバー ファイルをダウンロードする警告が表示された場合は、 [ダウンロード] をクリックしてドライバー ファイルを取得します。
[詳細設定]タブをクリックし、スクロールしてenabledTLSProtocolsパラメータを見つけ、その値を
TLSv1.2,TLSv1.3に設定します。
「テスト接続」をクリックして、 TiDB Cloud Dedicated クラスターへの接続を検証します。
[OK]をクリックして接続構成を保存します。
DataGrip を起動し、接続を管理するためのプロジェクトを作成します。
新しく作成したプロジェクトで、データベース エクスプローラーパネルの左上隅にある+をクリックし、データ ソース>その他> TiDBを選択します。
次の接続パラメータを構成します。
- ホスト: TiDB セルフマネージド クラスターの IP アドレスまたはドメイン名。
- ポート: TiDB セルフマネージド クラスターのポート番号。
- ユーザー: TiDB セルフマネージド クラスターに接続するために使用するユーザー名。
- パスワード: ユーザー名のパスワード。
例は以下のとおりです。
不足しているドライバー ファイルをダウンロードする警告が表示された場合は、 [ダウンロード] をクリックしてドライバー ファイルを取得します。
「接続のテスト」をクリックして、TiDB セルフマネージド クラスターへの接続を検証します。
[OK]をクリックして接続構成を保存します。
次のステップ
- DataGripのドキュメントから DataGrip の使い方を詳しく学びます。
- 開発者ガイドのデータを挿入 、 データの更新 、 データを削除する 、 単一テーブル読み取り 、 取引 、 SQLパフォーマンスの最適化などの章で、 TiDB アプリケーション開発のベスト プラクティスを学習します。
- プロフェッショナルTiDB 開発者コースを通じて学び、試験に合格するとTiDB 認定獲得します。
ヘルプが必要ですか?
TiDB コミュニティ 、またはサポートチケットを作成するについて質問します。