Updating object partition mapping

Partitioned objects can be re-partitioned on an active system. This provides a mechanism for mapping objects to new partitions.

The partition mapping for objects is updated using an administrative command or an API. Partition mapping updates can only be initiated on the active node for a partition. When the partition update is requested an audit is performed to ensure that the node list is consistent for all discovered nodes in the cluster. This audit is done to ensure that no object data is migrated to other nodes as part of remapping the partitions.

When a partition update is requested, all installed partition mappers on the active node are called for all partitioned objects. The objects will be moved to the partition returned by the partition mapper.

[Warning]

Object partition mapping updates only occur if the partition mapper installed by the application supports a dynamic mapping of objects to partitions. If the partition mapper only supports a static mapping of objects to partitions no remapping will occur.

New partition mappers can be installed on a node to perform partition updates as shown in these steps:

  1. Define and enable a new partition on the local node.

  2. Install a new partition mapper that maps objects to the new partition.

  3. Perform the partition update.

  4. Optionally migrate the partition as needed.

This technique has the advantage that objects created while the partition update is executing will be mapped to the new partition.