SET

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

概要

  1. SET [SESSION | LOCAL] configuration_parameter {TO | =} value | 'value' | DEFAULT}
  2. 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

Greenplum数据库配置参数的名称。 使用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

将时区设置为您的本地时区（即服务器的默认timezone）。 有关Greenplum数据库中时区的更多信息，请参见PostgreSQL文档的时区部。

示例

设置schema搜索路径：

  1. SET search_path TO my_schema, public;

将每个查询的segment主机内存增加到200 MB：

  1. SET statement_mem TO '200MB';

把日期风格设置为传统POSTGRES的”日在月之前”的输入习惯：

  1. SET datestyle TO postgres, dmy;

设置加利福尼亚州圣马特奥市的时区（太平洋时间）：

  1. SET TIME ZONE 'PST8PDT';

设置意大利的时区：

  1. SET TIME ZONE 'Europe/Rome';

兼容性

SET TIME ZONE扩展了SQL标准中定义的语法。 该标准仅允许数字时区偏移，而Greenplum数据库允许更灵活的时区规范。 SET的所有其他功能都是Greenplum数据库扩展。

另见

RESET, SHOW

Parent topic: SQL Command Reference