ALTER ROLE

기존 사용자 지정 역할 의 속성을 수정합니다. 현재 유일하게 지원되는 작업은 역할 이름 바꾸기 또는 역할에 대한 설명 추가/덮어쓰기/제거입니다.

참고 항목:

CREATE ROLE , DROP ROLE , SHOW ROLES

구문

ALTER ROLE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER ROLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER ROLE [ IF EXISTS ] <name> UNSET COMMENT

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

ALTER ROLE [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

매개 변수

name

변경할 역할의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

RENAME TO new_name

역할의 새 식별자를 지정하며, 계정에 고유한 식별자여야 합니다.

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

SET ...

역할에 대해 설정할 속성을 지정합니다.

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

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.

COMMENT = 'string_literal'

역할에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.

UNSET ...

역할에 대해 설정 해제할 속성을 지정하여 기본값으로 재설정합니다.

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

사용법 노트

  • 역할 소유자(즉, 역할에 대한 OWNERSHIP 권한을 가진 역할) 또는 그 이상의 역할만 이 명령을 실행할 수 있습니다.

  • (RENAME TO new_name 매개 변수를 사용하여) 역할의 이름을 바꾸려면 이 명령을 실행하는 역할에도 전역 CREATE ROLE 권한이 있어야 합니다.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

예

역할 이름을 role1 에서 role2 로 바꾸기:

ALTER ROLE role1 RENAME TO role2;
Copy

역할 myrole 에 대한 설명 추가:

ALTER ROLE myrole SET COMMENT = 'New comment for role';
Copy
언어: 한국어