DataGripは、JetBrainsが開発した統合開発環境(IDE)であり、データベース管理とSQL開発専用です。データベース開発者やデータアナリストがより効率的にデータベースを管理・クエリし、複雑なSQLクエリを作成、データベース設計・メンテナンスを行うのに役立ちます。本記事では、OceanBaseデータベースのMySQLテナントとmacOSオペレーティングシステムを例に、DataGripでOceanBaseデータベースに接続する方法を紹介します。
前提条件
DataGripをダウンロードしてインストール済みであること。詳細については、DataGrip公式Webサイトを参照してください。
接続対象のOBServerノードのIPアドレスと、DataGripが稼働するマシン間のネットワーク接続が確保されていること。
OceanBaseデータベースをインストール済みで、MySQLモードのテナントが作成されていること。
手順
ステップ1:データベース接続文字列の取得
OceanBaseデータベースのデプロイ担当者または管理者から、該当するデータベース接続文字列を取得します。例:
obclient -h$host -P$port -u$user_name -p$password -D$database_name
パラメータ説明:
$host:OceanBaseデータベースへの接続IPアドレス。OceanBaseデータベースプロキシ(OceanBase Database Proxy、ODP)接続方式ではODPアドレスを使用し、直接接続方式ではOBServerノードのIPアドレスを使用します。$port:OceanBaseデータベースへの接続ポート。ODP接続方式のデフォルトポートは2883で、ODPデプロイ時にカスタマイズ可能です。直接接続方式のデフォルトポートは2881で、OceanBaseデータベースのデプロイ時にカスタマイズ可能です。$database_name:アクセス対象のデータベース名。注意
テナントに接続するユーザーには、データベースに対する
CREATE、INSERT、DROP、およびSELECT権限が付与されていなければなりません。その他のユーザー権限の詳細については、MySQLモードの権限分類を参照してください。$user_name:テナントの接続アカウント。ODP接続の一般的な形式:ユーザー名@テナント名#クラスタ名またはクラスタ名:テナント名:ユーザー名。直接接続方式の形式:ユーザー名@テナント名。$password:アカウントのパスワード。
その他の接続文字列の情報については、OBClientを使用したOceanBaseテナントへの接続を参照してください。
例:
obclient -hxxx.xxx.xxx.xxx -P2881 -utest_user001@mysql001 -p****** -Dtest
ステップ2:DataGripでOceanBaseデータソースを作成して接続する
DataGripを初めて使用する場合は、ローカルに開いた後、New Project をクリックして新しいプロジェクトを作成します。
作成したプロジェクトで、ページ上部の
アイコンをクリックし、Database Explorerコントロールパネルを開きます。Database Explorerの左上隅で、+ > Data Source > MySQL > MySQL を選択します。
Data Sourcesポップアップウィンドウで、ステップ1:OceanBaseデータベースの接続文字列を取得する で取得した接続文字列を使用して、以下の設定を完了します:
パラメータ説明Name カスタムのData Source名。 Host 接続文字列から -hパラメータを取得した、OceanBaseデータベースの接続アドレス。User 接続文字列から -uパラメータを取得したアカウント名。例:test。Password 接続文字列から -pパラメータを取得したアカウントのパスワード。Port 接続文字列から -Pパラメータを取得した、OceanBaseデータベースの接続ポート。Database 接続文字列から -Dパラメータを取得した、アクセスするデータベース名。Test Connection をクリックして、接続が成功するかどうかをテストします。
接続成功のメッセージが表示されたら、OK をクリックして接続を完了します。
次のステップ
接続が完了したら、DataGripの使用を開始できます。DataGripの詳細な操作ガイドについては、DataGrip公式ドキュメントを参照してください。