本記事では、OceanBaseデータベースの自動パーティション機能における推奨される構成パラメータとバージョン要件について説明します。これには、OceanBaseデータベース、OceanBaseデータベースプロキシ（ODP）、およびKVクライアントの設定に関する推奨事項が含まれます。
OceanBaseデータベースの構成
バージョンの推奨
OceanBaseデータベースV4.3.5 hotfix4以降のバージョンを推奨します。
スプリット関連パラメータ
| パラメータ名 | 推奨値 | 推奨値の説明 |
|---|---|---|
| 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 | 再試行の待機間隔。 |