TablePlusでOceanBaseデータベースに接続する

TablePlusは、現代的でネイティブなデータベース管理ツールであり、MySQL、PostgreSQL、SQLiteなどさまざまなリレーショナルデータベースを管理するための使いやすく、ユーザーフレンドリーなグラフィカルユーザーインターフェースを提供します。本記事では、OB Cloudトランザクション型インスタンスのMySQLテナントとmacOSオペレーティングシステムを例に、TablePlusでOceanBaseデータベースに接続する方法を紹介します。

前提条件

• TablePlusをダウンロードし、インストール済みであること。詳細については、TablePlus公式サイトを参照してください。

• 接続対象のOBServerノードのIPアドレスと、TablePlusが稼働するマシン間でネットワークが接続されていることを確認してください。

• OceanBaseデータベースをインストール済みで、MySQLモードのテナントが作成されていること。

手順

ステップ１：データベース接続文字列を取得する

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：TablePlusでOceanBaseデータソースを作成して接続する

1. ローカルでTablePlusを開き、画面右側でマウスの右ボタンをクリックし、New > Connectionを選択します。

2. ポップアップウィンドウでMySQLを選択し、Createをクリックします。

3. MySQL Connectionダイアログボックスで、ステップ１：OceanBaseデータベース接続文字列を取得するで取得した接続文字列を使用して、以下の設定を完了します：

   パラメータ	説明
   Name	カスタムの接続名。
   Host/IP	接続文字列の -h パラメータから取得した、OceanBaseデータベースの接続アドレス。
   Port	接続文字列の -P パラメータから取得した、OB Cloudクラウドデータベースの接続ポート。
   User	接続文字列の -u パラメータから取得したアカウント名（例：test）。
   Password	接続文字列の -p パラメータから取得したアカウントのパスワード。
   Database	接続文字列の -D パラメータから取得した、アクセスするデータベース名。

4. Testをクリックして、接続が成功するかどうかをテストします。入力ボックスの背景色が緑色に変わった場合、接続は成功です。

5. 接続テストに成功したら、Connectをクリックして接続を完了します。

次のステップ

接続が完了したら、TablePlusの使用を開始できます。TablePlusの詳細な操作ガイドについては、TablePlus公式ドキュメントを参照してください。