SET and SET SESSION

The SET [SESSION] command sets a session variable. Its value remains in effect for the duration of the current database connection.

Warning

SingleStore recommends using the SET SESSION statement for session variables that are only referenced by the aggregator nodes on which the variable is set. For session variables with values that need to be propagated to leaf nodes from the aggregator nodes, use a global setting instead.

Syntax

SET [SESSION] variable_name = value;
SET @@SESSION.variable_name = value;

Arguments

  • variable_name: Name of the session variable to configure.

  • value: The session variable's value.

Remarks

  • The SESSION keyword is optional. Including it does not change this command’s behavior.

  • The @@SESSION.variable_name syntax is supported for compatibility with other database systems, such as MySQL.

  • This command can be run on a Master or Child aggregator node to set sync variables, but otherwise must be run on the Master Aggregator.

  • Refer to Engine Variables for information on other ways to set variables.

  • SET PASSWORD sets the user password. Refer to SET PASSWORD topic for details.

Warning

SET NAMES, SET CHARSET, and SET CHARACTER SET are non-operational in SingleStore. These commands are included only for MySQL compatibility.

Examples

The following queries set the value of the session variable net_read_timeout to 5000.

SET net_read_timeout = 5000;
SET @@SESSION.net_read_timeout = 5000;

The following query retrieves the value of the session variable net_read_timeout.

SELECT @@net_read_timeout;

Refer to Assigning Expressions to Variables for more examples.

Last modified:

Was this article helpful?