TRIGGER_PARTITION_BALANCEは、パーティションの自動バランス調整を手動でトリガーするために使用されます。
構文
DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(balance_timeout INT DEFAULT NULL);
パラメータ説明
balance_timeoutパラメータは秒単位で、バックグラウンドで実行されるパーティションの自動バランス調整タスクのタイムアウト時間を制御します。
注意事項
- このシステムパッケージはユーザーテナントでのみ呼び出し可能です。sysテナントからの呼び出しは、
OB_OP_NOT_ALLOWエラーが発生します。 - テナントレベルの構成パラメータ
enable_rebalanceまたはenable_transferが無効な場合、OB_OP_NOT_ALLOWエラーが発生し、パーティションの自動バランス調整の手動トリガーは許可されません。 - 他のバランス調整タスクが実行中の場合、
OB_OP_NOT_ALLOWエラーが発生します。現在のバランス調整タスクが完了するまで待機してください。 - 現在のテナントで既にパーティションの自動バランス調整が実行されている場合、
OB_PARTITION_ALREADY_BALANCEDエラーが発生します。
例
パーティションの自動バランス調整を1回トリガーします。バックグラウンドでのバランス調整タスクにタイムアウト時間はなく、終了するまで続行されます。
obclient> CALL DBMS_BALANCE.TRIGGER_PARTITION_BALANCE();パーティションの自動バランス調整をトリガーした後、バックグラウンドでのバランス調整タスクは最大2時間実行されます。完了しない場合はタイムアウトしてキャンセルされます。
obclient> CALL DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(7200);