Хранимая процедура sp_helpgroup (Transact-SQL)

Предоставляет данные о роли или обо всех ролях в текущей базе данных.

Важно!
Хранимая процедура sp_helpgroup обеспечивает совместимость с более ранними версиями сервера SQL Server. В следующей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Используйте представление каталога sys.database_principals.

Соглашения о синтаксисе в Transact-SQL

Синтаксис

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'

Б. Получение данных обо всех ролях

В следующем примере возвращаются данные обо всех ролях в текущей базе данных.

EXEC sp_helpgroup

См. также

Справочник

Хранимые процедуры ядра СУБД (Transact-SQL)
sys.database_principals (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helprole (Transact-SQL)
sp_helpuser (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005