ODCはOceanBaseデータベースのMySQLテナントへの接続をサポートしています。本記事では、この接続方法の前提条件と接続操作について説明します。
前提条件
OceanBase Developer Center（ODC）がデプロイ済みであり、Web版ODCのURLを取得していることを確認してください。デプロイの詳細な操作については、ODCのデプロイを参照してください。
手順
Web版ODCで個人接続（mysql@tenant）を作成する例を挙げます。具体的な操作手順は以下のとおりです：
ODCのログイン画面にアクセスし、登録済みのアカウント、パスワード、認証コードを入力した後、ログイン をクリックします。
ODCのホームページの 個人接続 タブの右上隅にある 新規接続 をクリックして、個人接続を作成します。
説明
ODCを初めて実行する場合、読み込み時間が長くなることがあります。しばらくお待ちください。
接続作成ページでは、以下の情報を入力または選択する必要があります。既にOceanBaseデータベースの接続文字列をお持ちの場合、以下の情報はすべて接続文字列から直接取得できます（mysql -h ホスト名 -P ポート番号 -u データベースユーザー名@テナント名# クラスター名 -D デフォルトデータベース -p 'データベースのパスワード'）。または、ページ内に提供されているインテリジェント解析ツールを使用して自動入力することもできます：
情報項目説明データベースタイプ 物理ライブラリ または ロジックライブラリ を選択します。 - 物理データベース：通常のデータベース。
- 論理データベース：ODP (Sharding)。
所属リージョン 接続が存在するリージョンとして 独立デプロイ/専用クラウド を選択します。 接続名 この接続の名前を指定します。 タグの設定 タグを使用すると、接続に補足説明などの情報を追加できます。
接続名 テキストボックスの後ろにある タグの設定 ボタンをクリックして、現在の接続にタグを指定します。表示されるドロップダウンリストで、タグの設定や管理を行えます：- タグの設定：ドロップダウンリストから対象のタグを選択して設定を完了します。リストが空の場合は、まず新しいタグを作成してください。
- タグの管理：リストの一番下にある 新しいタグ ボタン、またはリストの上部にある設定アイコンをクリックすると、タグ管理 ウィンドウが表示されます。タグ管理ウィンドウでは、作成したタグの編集や削除が可能です。また、上部の タグを作成 ボタンをクリックすると、新しいタグの名前とアイコンの色を指定できます。
インテリジェント解析 テキストボックスに接続文字列を貼り付けると、ODCが自動的にそれを認識し、各接続情報をウィンドウに入力します。 接続モード MySQL を選択します（論理データベースはMySQLモードのみサポートします）。 接続アドレス - ホストIP ：接続先データベースが配置されているサーバーのIPアドレス。
- ポート ：接続先データベースが配置されているサーバーのポート番号。
- クラスター名 ：接続先データベースが配置されているクラスタの名前（論理データベースは入力不要）。
- テナント名 ：接続先データベースが配置されているテナントの名前（論理データベースは入力不要）。
説明
ホスト名とポート番号は、接続先のデータベースが配置されているテナントの情報ページで取得できます。例えば、パブリッククラウドやOCP上で作成されたテナントの場合です。
データベースアカウント - データベースユーザー名：テナント内で作成されたアカウント（MySQLモードでは、このアカウントはデフォルトデータベースへのアクセス権限を持っている必要があります）。
- データベースのパスワード：テナント内で作成されたアカウントのパスワード。データベースパスワードボックスの後ろにある 接続テスト ボタンをクリックして、ターゲットデータベースに接続できるか確認します。
- パスワードの保存：このオプションをオフにすると、接続情報にデータベースのパスワードが保存されません。接続または接続テストを行うたびに、ポップアップ表示されるパスワード入力画面でパスワードを入力する必要があります。このオプションをオンにすると、接続情報にデータベースのパスワードが保存され、接続時に毎回パスワードを入力する必要がなくなります。
説明
- 設定情報に誤りがある場合、ユーザー名やパスワードが間違っている、ネットワーク異常など、エラーメッセージが表示されます。
- ユーザーは自身が所属するテナント内のデータベースにのみ接続できます。それ以外の場合、接続テスト失敗のエラーが表示されます。
- ODC V4.0.0以降のバージョンでは、アカウントとパスワードを入力しなくても接続を保存できます。
デフォルトデータベース/schema（オプション） MySQLテナント内のデータベースに接続する際、この接続で使用するデフォルトデータベースを入力する必要があります。 説明
MySQLモードでは、デフォルトのデータベースを指定しない場合、information_schemaデータベースに接続されます。information_schemaデータベースへの接続に失敗した場合は、デフォルトのデータベースをそのユーザーが権限を持つデータベースに設定してください。
SQLクエリのタイムアウト SQLのタイムアウト時間はカスタマイズ可能で、SQLクエリが指定された時間を超えると自動的にクエリが終了します（デフォルトは60秒）。 sysテナントアカウントの設定 sysテナントアカウントを使用してテナントビューをクエリするかどうかを選択し、選択した場合は、アカウント と パスワード を入力します。
データベースタイプが物理データベースの場合、sysテナントビューに対するクエリ権限を持つアカウントとパスワードを入力してください。接続アドレス に テナント がsysとして指定されている場合、この項目は自動的に入力されます。- アカウント ：sysテナントビューに対するクエリ権限を持つアカウント。
- パスワード ：アカウントに対応するパスワード。
説明
- ODC V2.3.0以降のバージョンでは、インポートおよびエクスポート機能は、接続作成時の詳細設定でroot@sysユーザーを設定する必要があります。
- ODC V2.4.1以降のバージョンでは、インポートおよびエクスポート機能によるビュー情報のクエリにおいて、root@sysアカウントへの依存関係がなくなりました（root@sysアカウントが設定されていない場合、ODCの一部のオブジェクト、例えばストアドプロシージャや関数などはエクスポート機能をサポートしません。root@sysアカウントが設定されている場合、
sysテナントのビュー情報にアクセスすることで最適なデータルーティング戦略を得て、エクスポート速度を向上させることができます）。 - sysテナントアカウントとパスワード は、クラスタテナント内のユーザーのアカウントとパスワードです（アカウントに「@sys#クラスタ」と入力しないでください）。例：アカウントはrootです。
ページ下部の 保存する ボタンをクリックすると、現在の設定情報がODC接続リストに永続的に保存されます。再度ODCにログインする際、接続設定リストからその接続を直接選択することができます。接続設定を保存する際、接続テストが成功している必要はありません。
説明
保存する前に、接続テストをクリックしてデータベース接続テストを行うことができます。データベースのユーザー名とパスワードが正しい場合、接続成功と表示されます。
関連ドキュメント
ODCのその他の機能については、OceanBaseデータベース公式ドキュメントセンターにログインし、対応するバージョンのODCプロダクトドキュメントを参照してください。