Watch the 7.3 Webinar On-Demand
This new release brings updates to Universal Storage, query optimization, and usability that you won’t want to miss.

PROMOTE AGGREGATOR ... TO MASTER

Info

SingleStore Managed Service does not support this command.

This command promotes a child aggregator node to master, while demoting the current master to child. This is useful for host maintenance that requires a restart of the master aggregator, or replacement of the old master aggregator with new hardware.

Syntax

PROMOTE AGGREGATOR '<host>':<port> TO MASTER;

Arguments

  • <host> is the host of the child aggregator to be promoted.
  • <port> is the port of the child aggregator to be promoted.

Remarks

  • The node to be promoted must already be a child aggregator in the cluster and must currently be online.
  • enable_query_forwarding must be set to ON for DDL and DML queries to continue to run while PROMOTE AGGREGATOR executes. See List of Engine Variables for more information on this variable.
  • If there is permanent loss of the master aggregator, use AGGREGATOR SET AS MASTER instead of PROMOTE AGGREGATOR ... TO MASTER.
  • This command can be run on a master or child aggregator node (see Node Requirements for SingleStore DB Commands).

Permissions

The specified user account must have full permissions on the node to execute this command, namely the cluster privilege. For more information, see Permissions Matrix.

Example

PROMOTE AGGREGATOR '127.0.0.1':3307 TO MASTER;
****
Query OK, 0 rows affected (2.971 sec)

Related Topics