SET

更改 YMatrix 数据库配置参数的值。

概要

SET [SESSION | LOCAL] configuration_parameter {TO | =} value | 'value' | DEFAULT}
SET [SESSION | LOCAL] TIME ZONE {timezone | LOCAL | DEFAULT}

描述

SET命令更改服务器配置参数。任何分类为session参数的配置参数都可以使用SET即时更改。 SET仅影响当前会话使用的值。

如果在稍后中止的事务中发出SET或SET SESSION，则回滚该事务时SET命令的效果会消失。一旦提交了事务，效果将一直持续到会话结束，除非被另一个SET覆盖。

SET LOCAL的影响仅持续到当前事务结束为止，无论是否提交。特殊情况是在单个事务中SET LOCAL紧随SET其后： SET LOCAL值将一直显示到事务结束为止，但是此后（如果提交了事务）SET值将生效。

如果在包含针对同一配置参数的SET选项的函数中使用SET LOCAL（请参见CREATE FUNCTION），则SET LOCAL命令的效果在函数退出时消失；无论如何，将恢复调用该函数时有效的值。这允许将SET LOCAL用于函数中参数的动态或重复更改，同时保留使用SET选项保存和恢复调用者值的便利。请注意，常规的SET命令会覆盖周围函数的SET选项。除非回滚，否则其影响持续存在。

如果在事务中使用DECLARE命令创建游标，则只有在使用CLOSE命令关闭游标后才能在事务中使用SET命令。

参数

SESSION

指定该命令对当前会话生效。这是默认值。

LOCAL

指定该命令仅对当前事务生效。在COMMIT或ROLLBACK之后，会话级设置将再次生效。请注意，如果SET LOCAL在事务外部执行，则似乎无效。

configuration_parameter

YMatrix 数据库配置参数的名称。使用SET只能更改分类为session的参数。

value

参数的新值。可以将值指定为字符串常量，标识符，数字或以逗号分隔的列表。 DEFAULT可用于指定将参数重置为其默认值。如果指定内存大小或时间单位，则将值用单引号引起来。

TIME ZONE

SET TIME ZONE值是SET timezone TO value。语法SET TIME ZONE允许时区指定使用特殊语法。以下是有效值的示例：
- 'PST8PDT'
- 'Europe/Rome'
- -7 (UTC以西7小时时区)
- INTERVAL '-08:00' HOUR TO MINUTE (UTC以西8小时时区)。

LOCAL

DEFAULT