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プロダクトドキュメントを参照してください。