SET ROLE {
DEFAULT
| NONE
| ALL
| ALL EXCEPT role [, role ] ...
| role [, role ] ...
}
SET ROLE では、付与されたロールのうちアクティブなロールを指定することで、現行セッション内の現行ユーザーの有効な権限が変更されます。 付与されるロールには、ユーザーに明示的に付与されるロールと、mandatory_roles システム変数値で指定されるロールが含まれます。
例:
SET ROLE DEFAULT;
SET ROLE 'role1', 'role2';
SET ROLE ALL;
SET ROLE ALL EXCEPT 'role1', 'role2';
各ロール名は、セクション6.2.5「ロール名の指定」 で説明されている形式を使用します。 ロール名のホスト名部分は、省略すると'%'にデフォルト設定されます。
ユーザーに (ロールを介してではなく) 直接付与された権限は、アクティブなロールに対する変更の影響を受けません。
このステートメントは、次の役割指定子を許可します:
-
DEFAULT: アカウントのデフォルトロールをアクティブ化します。 デフォルトのロールは、SET DEFAULT ROLEで指定されたロールです。ユーザーがサーバーに接続して正常に認証されると、サーバーはデフォルトロールとしてアクティブ化するロールを決定します。
activate_all_roles_on_loginシステム変数が有効な場合、サーバーは付与されたすべてのロールをアクティブ化します。 それ以外の場合、サーバーはSET ROLE DEFAULTを暗黙的に実行します。 サーバーは、アクティブ化できるデフォルトのロールのみをアクティブ化します。 サーバーは、アクティブ化できないデフォルトロールのエラーログに警告を書き込みますが、クライアントは警告を受け取りません。ユーザーがセッション中に
SET ROLE DEFAULTを実行する場合、デフォルトロールをアクティブ化できないと (存在しない場合やユーザーに付与されていない場合など)、エラーが発生します。 この場合、現在アクティブなロールは変更されません。 NONE: アクティブなロールをNONEに設定します (アクティブなロールはありません)。ALL: アカウントに付与されているすべてのロールをアクティブ化します。ALL EXCEPT: 指定されたロールを除く、アカウントに付与されているすべてのロールをアクティブ化します。 指定したロールが存在しているか、アカウントに付与されている必要はありません。role[,role] ...role[,role] ...
SET DEFAULT ROLE と SET ROLE DEFAULT は異なるステートメントです:
SET DEFAULT ROLEでは、アカウントセッション内でデフォルトでアクティブ化するアカウントロールを定義します。SET ROLE DEFAULTは、現在のセッション内のアクティブロールを現在のアカウントのデフォルトロールに設定します。
ロールの使用例は、セクション6.2.10「ロールの使用」 を参照してください。