本記事では、OceanBaseデータベースの自動パーティション機能における推奨設定パラメータとバージョン要件について説明します。OceanBaseデータベース、OceanBaseデータベースプロキシ（ODP）、およびKVクライアントの設定に関する推奨事項を含みます。
OceanBaseデータベースの設定
バージョンの推奨
OceanBaseデータベースV4.4.0以降のバージョンを使用することを推奨します。
分割関連パラメータ
パラメータ名 |
推奨値 |
推奨値の説明 |
|---|---|---|
| enable_auto_split | True | 自動パーティション分割機能を有効にします。 |
| auto_split_tablet_size | 16GB | 自動パーティションのトリガーしきい値を設定し、テーブルレベルのパーティション数が許容上限を超えるのを防ぎます。 |
ロードバランシングパラメータ
自動パーティション化後、OceanBaseクラスタのロードバランシング（パーティションの均等化）を加速するため、以下のパラメータを調整することを推奨します：
パラメータ名 |
推奨値 |
推奨値の説明 |
|---|---|---|
| partition_balance_schedule_interval | 600s | パーティション均等化のスケジューリング間隔を短縮し、新規パーティションのリソース利用率を向上させます。これにより、パーティションの均等化がより迅速にスケジューリングされます。 |
ODPの設定
ODPバージョンの推奨
ODP V4.3.1.4-62025012317バージョンの使用を推奨します。
ODPパラメータの推奨
自動分割による変更がもたらすProxyのルートリフレッシュの遅延問題によるパフォーマンスのジッターを避けるため、以下のパラメータを調整することを推奨します。
パラメータ名 |
推奨値 |
推奨値の説明 |
|---|---|---|
| is_need_skip_delay_interval_schema_changed | True | パーティションのschema_versionがテーブルのschema_versionより小さい場合、間隔時間の影響を受けず、直接パーティションルートをリフレッシュします。 |
KVクライアントの設定
KVバージョンの推奨
- OBKVを使用する場合は、V1.4.0以降のバージョンを推奨します。
- OBHBase V1.xを使用する場合は、V1.1.0以降のバージョンを推奨します。
- OBHBase V2.xを使用する場合は、V2.1.0以降のバージョンを推奨します。
KVパラメータの推奨事項
自動シャーディングによるパフォーマンスのジッターまたはエラーを回避するため、以下のパラメータを調整することを推奨します。
パラメータ名 |
推奨値 |
推奨値の説明 |
|---|---|---|
| table.entry.refresh.interval.wait | True | 複数のスレッドが同時にリフレッシュするのを防ぎ、現在リフレッシュ中のスレッドが完了するのを待つことで、古いルートを読み取るのを防ぎます。クライアント側ではデフォルトで有効です。 |
| server.enable.rerouting | False | クライアント実装上の理由により、シングルシャードのリフレッシュ機能と相互排他となります。クライアント側ではデフォルトで無効です。 |
| runtime.retry.times | 100 | 再試行可能なエラーに遭遇した際の再試行回数。 |
| runtime.max.wait | 3000ms | 再試行のタイムアウト時間です。再試行回数またはこの時間のいずれか一方が満たされた場合にエラーが報告されます。 |
| runtime.retry.interval | 1ms | 再試行の待機間隔。 |