本記事では、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 | 再試行待機間隔。 |