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