데이터베이스 역할 수정하기

데이터베이스 역할 수정하기 (ALTER DATABASE ROLE)

기존 데이터베이스 역할의 속성을 수정해요.

현재 지원되는 작업은 데이터베이스 역할 이름 바꾸기 또는 데이터베이스 역할에 대한 주석 추가/덮어쓰기/제거뿐이에요.

출처: 문서

본문

구문

ALTER DATABASE ROLE [ IF EXISTS ]  RENAME TO 

ALTER DATABASE ROLE [ IF EXISTS ]  SET COMMENT = ''

ALTER DATABASE ROLE [ IF EXISTS ]  UNSET COMMENT

ALTER DATABASE ROLE [ IF EXISTS ]  SET TAG  = '' [ ,  = '' ... ]

ALTER DATABASE ROLE [ IF EXISTS ]  UNSET TAG  [ ,  ... ]

ALTER DATABASE ROLE [ IF EXISTS ]  UNSET DCM PROJECT

매개 변수

name

데이터베이스 역할에 대한 식별자(즉, 이름)를 지정합니다. 역할이 생성되는 데이터베이스 내에서 고유해야 합니다.

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

식별자가 db_name.database_role_name 형식으로 완전히 한정되지 않은 경우, 명령은 세션의 현재 데이터베이스에서 데이터베이스 역할을 찾습니다.

RENAME TO new_name

데이터베이스 역할에 대한 새 식별자를 지정합니다. 계정 내에서 고유해야 합니다.

자세한 내용은 식별자 요구 사항을 참조하세요.

데이터베이스 역할의 완전히 한정된 이름을 지정할 때 다른 데이터베이스를 지정할 수 없습니다. 데이터베이스 이름(db_name)은 동일하게 유지되어야 합니다. 이름 변경 작업 중에는 database_role_name만 변경할 수 있습니다.

SET ...

데이터베이스 역할에 설정할 속성을 지정합니다:

COMMENT = 'string_literal'

데이터베이스 역할에 주석을 추가하거나 기존 주석을 덮어씁니다.

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

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

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

문에서 태그를 지정하는 방법에 대한 자세한 내용은 를 참조하세요.

UNSET ...

데이터베이스 역할에 대해 설정을 해제할 속성을 지정합니다. 이 속성들은 기본값으로 재설정됩니다.

COMMENT
TAG tag_name [ , tag_name ... ]

UNSET DCM PROJECT

현재 데이터베이스 역할을 관리하는 DCM 프로젝트에서 데이터베이스 역할을 분리합니다. 이 명령은 데이터베이스 역할을 삭제하지 않고 데이터베이스 역할과 %dcm-object% 간의 연결을 제거합니다. 자세한 내용은 를 참조하세요.

액세스 제어 권한

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요:

권한	개체	참고
OWNERSHIP	데이터베이스 역할	데이터베이스 역할 소유자(즉, 해당 데이터베이스 역할에 대한 OWNERSHIP 권한을 가진 데이터베이스 역할) 또는 상위 역할만 이 명령을 실행할 수 있어요. 소유자 역할은 소유한 데이터베이스 역할에 부여된 권한을 상속하지 않아요. 데이터베이스 역할에서 권한을 상속하려면 해당 데이터베이스 역할을 다른 역할에 부여해야 하며, 이를 통해 역할 계층 구조에서 부모-자식 관계가 만들어져요.
APPLY	태그	데이터베이스 역할에 태그를 설정할 수 있게 해요.

사용 참고 사항

메타데이터 관련:

고객은 Snowflake 서비스를 사용할 때 사용자 개체(User object) 외의 개인 데이터, 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터가 메타데이터로 입력되지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참조하세요.

예시

데이터베이스 d1에서 데이터베이스 역할 dr1의 이름을 dbr2로 변경:

ALTER DATABASE ROLE d1.dr1 RENAME TO d1.dbr2;

데이터베이스 역할 d1.dbr2에 주석 추가:

ALTER DATABASE ROLE d1.dbr2 SET COMMENT = 'New comment for database role';

데이터베이스 역할 수정하기