ODCは、OceanBaseデータベースのOracleテナントへの接続をサポートしています。本記事では、この接続方法の前提条件と操作手順について説明します。
前提条件
クライアント版ODCをダウンロードし、インストール済みであることを確認してください。
手順
本記事では、クライアント版ODCで個人接続(oracle@tenant)を作成する例を説明します。具体的な操作手順は以下のとおりです：
ODCにアクセスし、ODCホームページの個人接続タブの右上にある新規接続をクリックして個人接続を作成します。
説明
ODCを初めて実行する際は、読み込みに時間がかかる場合があります。しばらくお待ちください。
接続作成ページでは、以下の情報を入力または選択する必要があります。既にOceanBaseデータベースの接続文字列をお持ちの場合、以下の情報はすべて接続文字列から直接取得できます（mysql -h ホスト名 -P ポート番号 -u データベースユーザー名@テナント名 # クラスタ名 -D デフォルトデータベース -p ' データベースパスワード '）または、ページ内に提供されているインテリジェント解析ツールを使用して自動入力することもできます：
プロパティ説明データベースタイプ 物理データベースを選択します。 - 物理データベース：通常のデータベース。
- 論理データベース：ODP (Sharding)。
所属リージョン 独立デプロイ/専用クラウドを選択します。 接続名 接続名を指定します。 タグの設定 タグを使用して、接続に補足説明などの情報を追加できます。
接続名テキストボックスの後ろにあるタグの設定ボタンをクリックして、現在の接続にタグを指定します。表示されるドロップダウンリストで、タグの設定や管理を行えます：- タグの設定：ドロップダウンリストから対象のタグを選択して設定を完了します。リストが空の場合は、まず新しいタグを作成してください。
- タグの管理：リストの一番下にある新規タグボタン、またはリストの上部にある設定アイコンをクリックすると、タグ管理ウィンドウが表示されます。タグ管理ウィンドウでは、作成したタグの編集や削除を行えます。また、上部の新規タグボタンをクリックすると、新しいタグの名前とアイコンの色を指定できます。
インテリジェント解析 テキストボックスに接続文字列を貼り付けると、ODCが自動的にそれを認識し、各接続情報をウィンドウに入力します。 接続モード Oracleを選択します（論理データベースはMySQLモードのみサポート）。 接続アドレス - ホストIP：接続先データベースが存在するサーバーのIPアドレス。
- ポート：接続先データベースが存在するサーバーのポート番号。
- クラスタ名：接続先データベースが存在するクラスタの名前（論理データベースは不要）。
- テナント名：接続先データベースが存在するテナントの名前（論理データベースは不要）。
説明
ホスト名とポート番号は、接続先データベースが存在するテナントの情報ページから取得できます。例えば、パブリッククラウドやOCP上で作成されたテナントの場合です。
データベースアカウント - データベースユーザー名：テナント内で作成されたユーザー。
- データベースパスワード：テナント内で作成されたユーザーのパスワード。データベースパスワードボックスの後ろにある接続テストボタンをクリックして、ターゲットデータベースに接続できるか確認します。
- パスワードの保存：この項目をオフにすると、接続情報にデータベースのパスワード情報が保存されません。接続または接続テストを行うたびに、ポップアップ表示されるパスワード入力窓でデータベースのパスワードを入力する必要があります。この項目をオンにすると、接続情報にデータベースのパスワード情報が保存され、接続する際に毎回パスワードを入力する必要がなくなります。
説明
- 設定情報に誤りがある場合、ユーザー名やパスワードが間違っている、ネットワーク異常など、エラーメッセージが表示されます。
- ユーザーは自身が所属するテナント内のデータベースにのみ接続できます。それ以外の場合、接続テスト失敗のエラーが表示されます。
- ODC V4.0.0以降では、アカウントとパスワードを入力しなくても接続を保存できます。
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プロダクトドキュメントを参照してください。