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