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 |
目前資料庫中角色的角色識別碼。 |
如果指定了 role,會傳回下列資訊。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
group_name |
sysname |
目前資料庫中角色的名稱。 |
group_id |
smallint |
目前資料庫中角色的角色識別碼。 |
users_in_group |
sysname |
目前資料庫中角色的成員。 |
userid |
smallint |
角色成員的使用者識別碼。 |
備註
若要檢視與角色關聯的權限,請使用 sp_helprotect。
權限
需要 public 角色中的成員資格。
範例
A. 傳回單一角色的相關資訊
下列查詢會傳回 SammamishShippers
角色的相關資訊。
EXEC sp_helpgroup 'SammamishShippers'
B. 傳回所有角色的相關資訊
下列範例會傳回目前資料庫中所有角色的相關資訊。
EXEC sp_helpgroup
請參閱
參考
Database Engine 預存程序 (Transact-SQL)
sys.database_principals (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helprole (Transact-SQL)
sp_helpuser (Transact-SQL)
系統預存程序 (Transact-SQL)