OBKV-Table Javaクライアントを使用したクラスタへの接続

OBKV-Table Javaクライアントは、OceanBaseデータベースにアクセスするための豊富なAPIを提供します。この記事では、OBKV-Table Javaクライアントの初期化方法と、クラスタへの接続方法について説明します。

OBKV-Tableクライアントを使用してOBKV-Tableクラスタに接続し、データ処理を行う前に、準備作業が完了していることを確認してください。

OBKV-Table Java SDKのインストール

MavenプロジェクトでOBKV-Table Java SDKを使用するには、pom.xml ファイルに対応する依存関係を追加するだけです。ファイルの dependencies 部分に以下の内容を追加します：

<dependency>
    <groupId>com.oceanbase</groupId>
    <artifactId>obkv-table-client</artifactId>
    <version>1.2.12</version>
</dependency>

以下の点に注意してください：

• OBKV-Table Java SDKはJDK 1.8以降が必要です。
• 最新バージョンのJARパッケージを使用するようにしてください。古いバージョンのJARパッケージは、新しいサーバー側をサポートしていない可能性があります。
• ここに記載されているバージョン番号は最新ではない場合があります。中央リポジトリで公開されているOBKV-Tableのバージョンを参照し、バージョン番号を最新の公開バージョン番号に置き換えてください。

接続文字列の設定

## 現在のクラスタは以下のように仮定します
## DataBaseName: test
## UserName：root

#### 必須項目
Configuration conf = new Configuration();

## データベースの新規ユーザー名。3段階方式は不要です。username
conf.set(HBASE_OCEANBASE_FULL_USER_NAME, "root");

## ユーザーのPassword
conf.set(HBASE_OCEANBASE_PASSWORD, "");

## ODP Addressの備考を参照
conf.set(HBASE_OCEANBASE_ODP_ADDR,，

## OBKVのポートは3307（固定）
conf.setInt(HBASE_OCEANBASE_ODP_PORT, "3307");

## クラウドでODPモードを使用する場合（固定）
conf.setBoolean(HBASE_OCEANBASE_ODP_MODE, true);

## データベースのdatabase名
conf.set(HBASE_OCEANBASE_DATABASE, "test");

#### オプション
## リクエストの実行タイムアウト時間（業務特性に応じて設定）
conf.set("rpc.execute.timeout", "1000");

ODPアドレスは以下の方法で取得できます。OB Cloudテナントのダッシュボードにアクセスし、デプロイメント関係図を確認します。

次のステップ

• OBKV-Tableがサポートするすべての操作タイプについては、OBKV-Tableの操作タイプに関するドキュメントをご参照ください。
• OBKV-Tableがサポートするすべての値の種類については、OBKV-Tableのデータ型に関するドキュメントをご参照ください。
• クライアントを使用したデータ操作の例については、データ操作の例に関するドキュメントをご参照ください。
• OBKV-Tableクライアントの接続設定情報は、以下のビューで確認できます： GV$OB_KV_CLIENT_INFO V$OB_KV_CLIENT_INFO