sp_helpsrvrole (Transact-SQL)

Статья
08/21/2023

Применимо к:SQL Server

Возвращает список предопределенных ролей сервера SQL Server.

Синтаксис

  
sp_helpsrvrole [ [ @srvrolename = ] 'role' ]

Аргументы

[ @srvrolename = ] 'role' Имя предопределенных ролей сервера. роль — sysname с значением NULL по умолчанию. роль может быть одним из следующих значений.

Предопределенная роль сервера	Description
sysadmin	Системные администраторы
securityadmin	Администраторы безопасности.
serveradmin	Администраторы сервера.
setupadmin	Администраторы установки.
processadmin	Администраторы процесса.
diskadmin	Администраторы диска.
dbcreator	Создатели баз данных.
bulkadmin	Имеющие разрешение на выполнение инструкции BULK INSERT.

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Имя столбца	Тип данных	Описание:
ServerRole	sysname	Имя роли сервера
Description	sysname	Описание ServerRole

Замечания

Предопределенные роли сервера определены на уровне сервера и имеют разрешения на выполнение специальных административных действий на уровне сервера. Предопределенные роли сервера не могут быть добавлены, удалены или изменены.

Сведения о добавлении или удалении членов из ролей сервера см. в разделе ALTER SERVER ROLE (Transact-SQL).

Все имена входа являются участниками общедоступного доступа. sp_helpsrvrole не распознает общедоступную роль, так как SQL Server не реализует общедоступную роль в качестве роли.

sp_helpsrvrole не принимает определяемую пользователем роль сервера в качестве аргумента. Список определяемых пользователем ролей сервера см. в примерах в ALTER SERVER ROLE (Transact-SQL).

Разрешения

Требуется членство в роли public.

Примеры

О. Перечисление предопределенных ролей сервера

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

EXEC sp_helpsrvrole ;

B. Перечисление предопределенных и определяемых пользователем ролей сервера

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

SELECT * FROM sys.server_principals WHERE type = 'R' ;

C. Возврат описания предопределенной роли сервера

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

sp_helpsrvrole 'diskadmin' ;

См. также

Хранимые процедуры безопасности (Transact-SQL)
Роли уровня сервера
sp_addsrvrolemember (Transact-SQL)
sp_dropsrvrolemember (Transact-SQL)
sp_helpsrvrolemember (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)