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