moveToPartition

moveToPartition(destPartitionID: Integer64) updating;

The moveToPartition method of the Object class moves the receiver and its subobjects to the partition with the partition identifier specified by the destPartitionID parameter. The destination partition must be present, not frozen, and version-compatible with the receiver. The subobjects moved with an object include exclusive collections, JadeBytes properties, blob and slob properties.

This method must be executed in transaction state.

Before the move is executed, the receiver and any exclusive collection properties are exclusively locked to prevent any further changes until the transaction has committed or aborted.

Exclusive instances of JadeBytes are maintained in a UDR file that is peered with the data partition containing the parent object. Moving JadeBytes objects with the singleFile property set to true requires a file system rename operation if the partitions are located on the same physical device, otherwise the single file instance is moved to the directory containing the destination partition.

An exception is raised if the specified partition identifier is out of range or the destination partition is frozen or offline.