ALTER DATABASE ROLE¶
기존 데이터베이스 역할의 속성을 수정합니다.
현재 유일하게 지원되는 작업은 데이터베이스 역할 이름 바꾸기 또는 데이터베이스 역할에 대한 설명 추가/덮어쓰기/제거입니다.
구문¶
ALTER DATABASE ROLE [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER DATABASE ROLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER DATABASE ROLE [ IF EXISTS ] <name> UNSET COMMENT
ALTER DATABASE ROLE [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER DATABASE ROLE [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
매개 변수¶
name
데이터베이스 역할의 식별자(즉, 이름)를 지정하며, 역할이 생성되는 데이터베이스에서 고유해야 합니다.
식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예:
"My object"
)로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.If the identifier is not fully qualified in the form of
db_name.database_role_name
, the command looks for the database role in the current database for the session.RENAME TO new_name
데이터베이스 역할의 새 식별자를 지정하며, 계정에 고유한 식별자여야 합니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
Note that when specifying the fully-qualified name of the database role, you cannot specify a different database. The name of the database,
db_name
, must remain the same. Only thedatabase_role_name
can change during a rename operation.SET ...
데이터베이스 역할에 대해 설정할 속성을 지정합니다.
COMMENT = 'string_literal'
데이터베이스 역할에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
태그 이름과 태그 문자열 값을 지정합니다.
태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.
문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.
UNSET ...
데이터베이스 역할에 대해 설정 해제할 속성을 지정하여 기본값으로 재설정합니다.
COMMENT
TAG tag_name [ , tag_name ... ]
액세스 제어 권한¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
---|---|---|
OWNERSHIP |
데이터베이스 역할 |
데이터베이스 역할 소유자(즉, 데이터베이스 역할에 대한 OWNERSHIP 권한을 가진 데이터베이스 역할) 또는 그 이상의 역할만 이 명령을 실행할 수 있습니다. 소유자 역할은 소유된 데이터베이스 역할에 부여된 권한을 상속하지 않습니다. 데이터베이스 역할에서 권한을 상속하려면, 해당 데이터베이스 역할의 권한을 다른 역할에 부여해 역할 계층 구조에서 상위-하위 관계를 생성해야 합니다. |
APPLY |
태그 |
데이터베이스 역할에 태그를 설정할 수 있습니다. |
사용법 노트¶
메타데이터 관련:
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 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';