ALTER SESSION POLICY¶

修改现有会话策略的属性。

在下一个使用会话策略的 SQL 查询运行时，对会话策略属性所做的任何更改才会生效。

另请参阅：: 会话策略 DDL 参考

语法¶

ALTER SESSION POLICY [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER SESSION POLICY [ IF EXISTS ] <name> SET
  [ SESSION_IDLE_TIMEOUT_MINS = <integer> ]
  [ SESSION_UI_IDLE_TIMEOUT_MINS = <integer> ]
  [ ALLOWED_SECONDARY_ROLES = ( [ { 'ALL' | <role_name> [ , <role_name> ... ] } ] ) ]
  [ BLOCKED_SECONDARY_ROLES = ( [ { 'ALL' | <role_name> [ , <role_name> ... ] } ] ) ]
  [ COMMENT = '<string_literal>' ]

ALTER SESSION POLICY [ IF EXISTS ] <name> SET
  TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SESSION POLICY [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER SESSION POLICY [ IF EXISTS ] <name> UNSET
  [ SESSION_IDLE_TIMEOUT_MINS ]
  [ SESSION_UI_IDLE_TIMEOUT_MINS ]
  [ ALLOWED_SECONDARY_ROLES ]
  [ BLOCKED_SECONDARY_ROLES ]
  [ COMMENT ]

Copy

参数¶

name

会话策略的标识符；对于您的账户必须是唯一的。

标识符值必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如 "My object"）。放在双引号内的标识符也区分大小写。

有关更多详细信息，请参阅标识符要求。

RENAME TO new_name

指定会话策略的新标识符；对于您的账户必须是唯一的。

有关更多详细信息，请参阅标识符要求。

可以将对象移动到其他数据库和/或架构，同时选择重命名对象。为此，请指定一个限定 new_name 值，该值分别以 db_name.schema_name.object_name 或 schema_name.object_name 的形式包含新数据库和/或架构名称。

备注

目标数据库和/或架构必须已存在。此外，新位置中不能存在同名对象；否则，该语句将返回错误。
除非对象所有者（即拥有对象 OWNERSHIP 权限的角色）也拥有目标架构，否则禁止将对象移动到托管访问架构。

SET ...

指定要为会话策略设置的一个或多个参数（用空格、逗号或新行分隔）。

SESSION_IDLE_TIMEOUT_MINS = integer

对于 Snowflake 客户端和程序化客户端，在用户必须再次对 Snowflake 进行身份验证之前，会话可以空闲的分钟数。如果未指定值，Snowflake 将使用默认值。

分钟数可以是介于 30 和 5 （含）之间的任意整数。

默认值：``30``（半小时）

SESSION_UI_IDLE_TIMEOUT_MINS = integer

对于 Snowsight，在用户必须再次对 Snowflake 进行身份验证之前，会话可以空闲的分钟数。如果未指定值，Snowflake 将使用默认值。

分钟数可以是介于 30 和 5 （含）之间的任意整数。

默认值：``30``（半小时）

ALLOWED_SECONDARY_ROLES = ( [ { 'ALL' | role_name [ , role_name ... ] } ] )

指定会话策略的次要角色（如果有）。

该属性的可能值为：

(): 不允许次要角色。
('ALL'): 允许所有次要角色。
( role_name [ , role_name ... ] ): 允许指定的角色作为次要角色。次要角色可以是用户定义的账户角色或系统角色。指定存储在 Snowflake 中的角色名称。有关详细信息，请参阅标识符要求。

Default: ('ALL'). If you unset this property, its value in the output of a DESCRIBE SESSION POLICY command is 'ALL'.

BLOCKED_SECONDARY_ROLES = ( [ { 'ALL' | role_name [ , role_name ... ] } ] )

Specifies the blocked secondary roles for a session policy, if any. Blocked secondary roles take precedence over allowed secondary roles.

该属性的可能值为：

(): 允许所有次要角色。
('ALL'): 不允许次要角色。
( role_name [ , role_name ... ] ): Blocks the specified roles as secondary roles. The specified roles, and the roles granted to those roles, cannot be activated as secondary roles. These blocked roles can be user-defined account roles or system roles. Specify the role name as it is stored in Snowflake. For details, see 标识符要求.

Default: (). If you unset this property, its value in the output of a DESCRIBE SESSION POLICY command is '()'.

COMMENT = 'string_literal'

为会话策略添加注释或覆盖现有注释。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

指定标签名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅对象的标签配额。

UNSET ...

指定一个或多个要取消设置的会话策略参数，这会将它们重置为系统默认值。

您可以使用单个 ALTER 语句重置多个属性。每个属性必须用逗号分隔。重置属性时，仅指定名称。为该属性指定值将返回错误。

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：

权限	对象	备注
OWNERSHIP	会话策略	OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需同时被授予该架构的 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

有关会话策略 DDL 和权限的其他详细信息，请参阅管理会话策略。

使用说明¶

如果您要更新现有掩码策略，并且需要查看该策略的当前定义，请调用 GET_DDL 函数或运行 DESCRIBE SESSION POLICY 命令。
在执行 ALTER 语句之前，您可以先执行 DESCRIBE SESSION POLICY 语句，确定策略的属性值。
关于元数据：

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

示例¶

以下示例更新了会话策略，使 Snowsight 会话超时值为 15 分钟。

DESC SESSION POLICY session_policy_prod_1;

Copy

+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+
| createdOn                       | name                  | sessionIdleTimeoutMins | sessionUIIdleTimeoutMins | comment                                          |
+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+
| Mon, 11 Jan 2021 00:00:00 -0700 | session_policy_prod_1 | 30                     | 30                       | session policy for use in the prod_1 environment |
+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+

ALTER SESSION POLICY session_policy_prod_1 SET SESSION_UI_IDLE_TIMEOUT_MINS = 15;

Copy