ALTER SESSION POLICY¶

기존 세션 정책의 속성을 수정합니다.

세션 정책 속성에 대한 변경 사항은 세션 정책을 사용하는 다음 SQL 쿼리가 실행될 때 적용됩니다.

참고 항목:: 세션 정책 DDL 참조

구문¶

ALTER SESSION POLICY [ IF EXISTS ] <name> [UN]SET [ SESSION_IDLE_TIMEOUT_MINS = <integer> ]
                                                  [ SESSION_UI_IDLE_TIMEOUT_MINS = <integer> ]
                                                  [ COMMENT = '{string_literal}' ]

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

Copy

매개 변수¶

name

세션 정책의 식별자입니다. 계정에 대해 고유해야 합니다.

식별자 값은 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

SESSION_IDLE_TIMEOUT_MINS = <integer>

Snowflake 클라이언트 및 프로그래밍 방식 클라이언트의 경우, 사용자가 Snowflake에 다시 인증해야 하기 전에 세션이 유휴 상태일 수 있는 시간(분)입니다. 분 수는 5 에서 240 사이(해당 숫자 포함)의 정수일 수 있습니다. 값을 지정하지 않으면 Snowflake는 기본값을 사용합니다.

기본값: 240 (즉, 4시간).

SESSION_UI_IDLE_TIMEOUT_MINS = <integer>

Snowflake 웹 인터페이스의 경우, 사용자가 Snowflake에 다시 인증해야 하기 전에 세션이 유휴 상태일 수 있는 시간(분)입니다. 분 수는 5 에서 240 사이(해당 숫자 포함)의 정수일 수 있습니다. 값을 지정하지 않으면 Snowflake는 기본값을 사용합니다.

기본값: 240 (즉, 4시간).

COMMENT = 'string_literal'

세션 정책에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.

RENAME TO new_name

세션 정책의 새 식별자를 지정합니다. 계정에 대해 고유해야 합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

선택적으로 오브젝트의 이름을 바꾸는 동안 오브젝트를 다른 데이터베이스 및/또는 스키마로 이동할 수 있습니다. 그러려면 각각 db_name.schema_name.object_name 또는 schema_name.object_name 형식으로 새 데이터베이스 및/또는 스키마 이름을 포함하는 정규화된 new_name 값을 지정하십시오.

참고

대상 데이터베이스 및/또는 스키마가 이미 있어야 합니다. 또한, 새 위치에 이름이 같은 오브젝트가 있으면 안 됩니다. 그렇지 않으면 문이 오류를 반환합니다.
오브젝트 소유자(즉, 오브젝트에 대한 OWNERSHIP 권한을 가진 역할) 역시 대상 스키마를 소유하지 않는 한 오브젝트를 관리되는 액세스 스키마로 이동하는 것은 금지됩니다.

액세스 제어 요구 사항¶

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
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 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

세션 정책 DDL 및 권한에 대한 추가적인 세부 사항은 세션 정책 관리하기 섹션을 참조하십시오.

사용법 노트¶

기존 세션 정책을 업데이트하고 정책의 현재 정의를 확인해야 하는 경우 GET_DDL 함수를 호출하거나 DESCRIBE SESSION POLICY 명령을 실행하십시오.
ALTER 문을 실행하기 전에, DESCRIBE SESSION POLICY 문을 실행하여 정책의 속성 값을 결정할 수 있습니다.

예¶

다음 예에서는 웹 인터페이스 세션 시간 초과 값이 60 분으로 설정되도록 세션 정책을 업데이트합니다.

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 | 60                     | 30                       | session policy for use in the prod_1 environment |
+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+

Copy

ALTER SESSION POLICY session_policy_prod_1 SET SESSION_UI_IDLE_TIMEOUT_MINS = 60;

Copy