sp_helpgroup (Transact-SQL)
报告有关当前数据库中一个角色或全部角色的信息。
重要提示: |
---|
sp_helpgroup 提供了与 SQL Server 早期版本的兼容性。下一版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 请改用 sys.database_principals 目录视图。 |
语法
sp_helpgroup [ [ @grpname = ] 'role' ]
参数
- [ @grpname = ] 'role'
角色的名称。role 必须存在于当前数据库中。role 的数据类型为 sysname,默认值为 NULL。如果指定 role,则返回有关该角色名称和该角色成员的信息;否则,返回有关当前数据库中所有角色的信息。
返回代码值
0(成功)或 1(失败)
结果集
如果未指定 role,则返回下列有关所有角色的信息。
列名 | 数据类型 | 说明 |
---|---|---|
group_name |
sysname |
当前数据库中角色的名称。 |
group_id |
smallint |
当前数据库中角色的角色 ID。 |
如果指定 role,则返回下列信息。
列名 | 数据类型 | 说明 |
---|---|---|
group_name |
sysname |
当前数据库中角色的名称。 |
group_id |
smallint |
当前数据库中角色的角色 ID。 |
users_in_group |
sysname |
当前数据库中角色的成员。 |
userid |
smallint |
角色成员的用户 ID。 |
备注
若要查看与角色相关联的权限,请使用 sp_helprotect。
权限
要求具有 public 角色的成员身份。
示例
A. 返回有关单个角色的信息
以下查询将返回有关 SammamishShippers
角色的信息。
EXEC sp_helpgroup 'SammamishShippers'
B. 返回有关所有角色的信息
以下示例将返回有关当前数据库中所有角色的信息。
EXEC sp_helpgroup
请参阅
参考
数据库引擎存储过程 (Transact-SQL)
sys.database_principals (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helprole (Transact-SQL)
sp_helpuser (Transact-SQL)
系统存储过程 (Transact-SQL)