カテゴリ:

ユーザーとセキュリティ DDL (ロール)

ALTER ROLE

既存のロールのプロパティを変更します。現在、サポートされている操作は、ロールの名前変更またはロールのコメントの追加/上書き/削除のみです。

こちらもご参照ください:

CREATE ROLESHOW 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

パラメーター

名前

変更するロールの識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

RENAME TO 新しい名前

ロールの新しい識別子を指定します。アカウントに対して一意である必要があります。

詳細については、 識別子の要件 をご参照ください。

SET ...

ロールに設定するプロパティを指定します。

COMMENT = '文字列リテラル'

ロールのコメントを追加するか、既存のコメントを上書きします。

UNSET ...

ロールの設定を解除するプロパティを指定します。これにより、デフォルトにリセットされます。

現在、設定解除できるプロパティは COMMENT のみです。これにより、役割のコメントがあれば削除されます。

使用上の注意

  • RENAME TO 新しい名前 パラメーターを使用して)ロールの名前を変更するには、ロールの所有者(名前を変更するロールに対する OWNERSHIP 権限を持つロール)である必要があります。さらに、このアクションを行うには、アカウントで CREATE ROLE 権限を持つロールが必要です。

ロール role1 の名前を role2 に変更します。

ALTER ROLE role1 RENAME TO role2;

ロール myrole にコメントを追加します。

ALTER ROLE myrole SET COMMENT = 'New comment for role';