Important
New database features are no longer connected to engine versions; features are now enabled independently during scheduled update windows, and “major” and “minor” releases no longer exist in Helios. Please visit the release notes to view the latest features available in your database clusters.
SET LEAF
On this page
The SET LEAF command sets a sync variable to propagate to all leaves in the cluster.
Syntax
SET LEAF variable_name = valueArguments
-
variable_: name of the sync variable.name -
value: value to be assigned to the sync variable.
Remarks
-
variable_must be a sync variable that can sync to all nodes (aggregators and leaves).name -
You cannot this command on a non-sync variable.
-
This command must be run on the master aggregator.
Examples
Example 1
The following example syncs the variable regexp_ to all leaves.SET LEAF can be run on regexp_ because regexp_ is a variable that can sync to all nodes (leaves and aggregators).
SET LEAF regexp_format = "extended";
Retrieve the variable’s value:
SELECT @@regexp_format;
+-----------------+
| @@regexp_format |
+-----------------+
| extended |
+-----------------+Example 2
The following example attempts to sync the variable auto_ to all leaves.SET LEAF fails because auto_ is a variable that can sync to all aggregators, only.
SET LEAF auto_attach = 1;
ERROR 2324 (HY000): This cluster-wide variable exists only on
aggregators, it's not possible to set a value for leavesLast modified: