Tuple Mover Parameters

These parameters control how the Tuple Mover operates. Query system table CONFIGURATION_PARAMETERS to determine what levels (node, session, database) are valid for a given parameter.

Parameters Description


Sets the number of active partitions. The active partitions are those most recently created. For example:

=> ALTER DATABASE DEFAULT SET ActivePartitionCount = 2;	

For information about how the Tuple Mover treats active and inactive partitions during a mergeout operation, see Partition Mergeout.

Default: 1


When partition, copy table, and rebalance operations encounter a conflict with an internal Tuple Mover job, those operations attempt to cancel the conflicting Tuple Mover job. This parameter specifies the amount of time, in seconds, that the blocked operation waits for the Tuple Mover cancellation to take effect. If the operation is unable to cancel the Tuple Mover job within limit specified by this parameter, the operation displays an error and rolls back.

Default: 300


Boolean, specifies whether Tuple Mover performs moveout and mergeout activities on nodes with a node state of RECOVERING. Enabling Tuple Mover reduces the number of ROS containers generated during recovery. Having fewer than 1024 ROS containers per projection allows Vertica to maintain optimal recovery performance.

Default: 1 (enabled)


Specifies in MB the maximum size of ROS containers that are candidates for mergeout operations. The Tuple Mover avoids merging ROS containers that are larger than this setting.

Default: -1 (no maximum limit)


Specifies in seconds how frequently the Tuple Mover checks the mergeout request queue for pending requests:
  1. If the queue contains mergeout requests, the Tuple Mover does nothing and goes back to sleep.
  2. If the queue is empty, the Tuple Mover:
    • Processes pending storage location move requests.
    • Checks for new unqueued purge requests and adds them to the queue.

    It then goes back to sleep.

Default: 600


Specifies in seconds how frequently Tuple Mover checks for new data in the WOS to move to ROS.

Default: 300


Specifies in seconds how long the Tuple Mover waits before it is forced to write the WOS to disk.

Default: 1800


The percentage of the WOS that can be filled with data before the Tuple Mover performs a moveout operation.

Default: 0


Specifies as a percentage the threshold of deleted records in a ROS container that invokes an automatic mergeout operation, to purge those records. Vertica only counts the number of 'aged-out' delete vectors—that is, delete vectors that are as 'old' or older than the ancient history mark (AHM) epoch.

This threshold applies to all ROS containers for non-partitioned tables. It also applies to ROS containers of all inactive partitions. In both cases, aged-out delete vectors are permanently purged from the ROS container.

This configuration parameter only applies to automatic mergeout operations. It does not apply to manual mergeout operations that are invoked by calling meta-functions DO_TM_TASK('mergeout') and PURGE.

Default: 20 (percent)