TRIGGER_PARTITION_BALANCEは、パーティションの自動バランス調整を手動でトリガーするために使用します。
構文
DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(balance_timeout BINARY_INTEGER 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> BEGIN DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(); END;パーティションの自動バランス調整をトリガーした後、バックグラウンドのバランス調整タスクは最大2時間実行されます。完了しない場合はタイムアウトしてキャンセルされます。
obclient> BEGIN DBMS_BALANCE.TRIGGER_PARTITION_BALANCE(7200); END;