説明
このビューはV4.3.4バージョンから導入され、主にOBKV-Tableクライアントに適用されます。
機能の概要
システムテナントでは、ビュー GV$OB_KV_CLIENT_INFO により、すべてのOBKVテナントのクライアント接続に関する構成パラメータ情報にアクセスできます。
フィールド説明
フィールド名 |
型 |
NULL許容 |
説明 |
|---|---|---|---|
| client_id | bigint | NO | クライアントID |
| client_ip | varchar:MAX_IP_ADDR_LENGTH | NO | クライアントIPアドレス |
| client_port | bigint | NO | クライアントポート |
| svr_ip | varchar:MAX_IP_ADDR_LENGTH | NO | 所在サーバーIPアドレス |
| svr_port | bigint | NO | 所在サーバーポート |
| tenant_id | bigint | NO | テナントID |
| user_name | varchar::OB_MAX_USER_NAME_LENGTH | NO | ユーザー名 |
| first_login_ts | timestamp(6) | NO | 最初ログイン時間 |
| last_login_ts | timestamp(6) | NO | 前回ログイン時間 |
| client_info | varchar:2048 | NO | クライアント情報JSON文字列 |
client_info フィールドのJSON文字列形式は次のとおりです：
{
"client_id": 242153145,
"runtime": {
"rpc.execute.timeout": "3000",
"rpc.operation.timeout": "10000",
"runtime.max.wait": "3000",
"runtime.retry.interval": "1",
"runtime.retry.times": "1",
"connection.max.expired.time": "8"
},
"log": {
"slow.query.monitor.threshold": "10"
},
"route": {
"metadata.refresh.interval": "60000",
"continuous.failure.ceiling": "100",
"server.address.caching.timeout": "3600000",
"server.address.priority.timeout": "1800000",
"table.entry.acquire.connect.timeout": "500",
"table.entry.acquire.socket.timeout": "3000",
"table.entry.refresh.interval.base": "100",
"table.entry.refresh.interval.ceiling": "1600",
"table.entry.refresh.try.times": "3"
},
"thread_pool": {
"runtime.batch.executor": "false"
}
}
JSONフィールド内のパラメータ説明は以下のとおりです：
パラメータ |
デフォルト値 |
説明 |
|---|---|---|
| metadata.refresh.interval | 60000 | METADATAのリフレッシュ時間間隔。 |
| rpc.execute.timeout | 3000 | RPCリクエストのソケットタイムアウト時間。 |
| rpc.operation.timeout | 10000 | OceanBase内部でのRPCリクエスト実行タイムアウト時間。 |
| runtime.continuous_failure.ceiling | 100 | 連続運用失敗の上限回数。この回数に達するとテーブルのアドレスがリフレッシュされます。 |
| runtime.max.wait | 3000 | 単一実行のタイムアウト時間内でのリトライ回数。 |
| runtime.retry.interval | 1 | 実行時エラー発生時のリトライ時間間隔。 |
| runtime.retry.times | 1 | 実行中にリトライ可能なエラーが発生した場合のリトライ回数。 |
| server.address.caching.timeout | 3600000L | SERVERアドレスキャッシュの有効期限。 |
| server.address.priority.timeout | 1800000L | SERVERアドレス優先順位の有効期限。 |
| slow.query.monitor.threshold | 10 | MONITORログに記録されるスロー操作の実行時間しきい値。 |
| table.entry.acquire.connect.timeout | 500 | TABLEアドレスリフレッシュ接続要求のタイムアウト時間。 |
| table.entry.acquire.socket.timeout | 3000 | TABLEアドレスのSOCKETタイムアウト時間。 |
| table.entry.refresh.interval.base | 100 | TABLEアドレスリフレッシュの基本時間間隔。 |
| table.entry.refresh.interval.ceiling | 1600 | TABLEアドレスリフレッシュの最大時間間隔。 |
| table.entry.refresh.try.times | 3 | TABLEアドレスリフレッシュの試行回数。 |
| runtime.batch_executor | false | バッチリクエスト時の並列実行スレッドプール |
| connection.max.expired.time | 8 | クライアント接続のリフレッシュ再ログインまでの最大時間間隔 |
クエリ例
システムテナントでビューGV$OB_KV_CLIENT_INFOをクエリするステートメントは次のとおりです：
obclient [oceanbase]> SELECT * FROM oceanbase.GV$OB_KV_CLIENT_INFO LIMIT 1;
実行結果の例は次のとおりです：
+---------------------+--------------+-------------+--------------+----------+-----------+-----------+----------------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| CLIENT_ID | CLIENT_IP | CLIENT_PORT | SVR_IP | SVR_PORT | TENANT_ID | USER_NAME | FIRST_LOGIN_TS | LAST_LOGIN_TS | CLIENT_INFO |
+---------------------+--------------+-------------+--------------+----------+-----------+-----------+----------------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 7409156147904779098 | xx.xx.xx.xx | 46318 | xx.xx.xx.xx | 2882 | 1010 | ots_user | 2026-02-11 15:47:51.336915 | 2026-02-11 16:03:51.344704 | {"route":{"metadata.refresh.interval":"60000","table.entry.refresh.try.times":"3","table.entry.acquire.socket.timeout":"3000","runtime.continuous.failure.ceiling":"100","server.address.priority.timeout":"1800000","server.address.caching.timeout":"3600000","table.entry.refresh.interval.ceiling":"1600","table.entry.acquire.connect.timeout":"500","table.entry.refresh.interval.base":"100"},"log":{"slow.query.monitor.threshold":"-1"},"thread_pool":{"runtime.batch.executor":false},"runtime":{"runtime.retry.times":"3","runtime.retry.interval":"100","rpc.execute.timeout":"15000","rpc.operation.timeout":"10000","runtime.max.wait":"20000","connection.max.expired.time":"8"},"client_id":7409156147904779098} |
+---------------------+--------------+-------------+--------------+----------+-----------+-----------+----------------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set