Поделиться через


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

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

ms188925.note(ru-ru,SQL.90).gifВажно!
Хранимая процедура 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