sp_helprotect (Transact-SQL)
Returns a report that has information about user permissions for an object, or statement permissions, in the current database.
Important
sp_helprotect does not return information about securables that were introduced in SQL Server 2005. Use sys.database_permissions and fn_builtin_permissions instead.
Does not list permissions that are always assigned to the fixed server roles or fixed database roles. Does not include logins or users that receive permissions based on their membership in a role.
.gif "Topic link icon")
Transact-SQL Syntax Conventions
Syntax
sp_helprotect [ [ @name = ] 'object_statement' ]
[ , [ @username = ] 'security_account' ]
[ , [ @grantorname = ] 'grantor' ]
[ , [ @permissionarea = ] 'type' ]
Arguments
[ @name = ] 'object_statement'
Is the name of the object in the current database, or a statement, that has the permissions to report. object_statement is nvarchar(776), with a default of NULL, which returns all object and statement permissions. If the value is an object (table, view, stored procedure, or extended stored procedure), it must be a valid object in the current database. The object name can include an owner qualifier in the form owner**.**object.If object_statement is a statement, it can be a CREATE statement.
[ @username = ] 'security_account'
Is the name of the principal for which permissions are returned. security_account is sysname, with a default of NULL, which returns all principals in the current database. security_account must exist in the current database.[ @grantorname = ] 'grantor'
Is the name of the principal that granted permissions. grantor is sysname, with a default of NULL, which returns all information for permissions granted by any principal in the database.[ @permissionarea = ] 'type'
Is a character string that indicates whether to display object permissions (character string o), statement permissions (character string s), or both (o s). type is varchar(10),with a default of o s. type can be any combination of o and s, with or without commas or spaces between o and s.
Return Code Values
0 (success) or 1 (failure)
Result Sets
Column name |
Data type |
Description |
|---|---|---|
Owner |
sysname |
Name of the object owner. |
Object |
sysname |
Name of the object. |
Grantee |
sysname |
Name of the principal to which permissions were granted. |
Grantor |
sysname |
Name of the principal that granted permissions to the specified grantee. |
ProtectType |
nvarchar(10) |
Name of the type of protection: GRANT REVOKE |
Action |
nvarchar(60) |
Name of the permission. Valid permission statements depend upon the type of object. |
Column |
sysname |
Type of permission: All = Permission covers all current columns of the object. New = Permission covers any new columns that might be changed (by using the ALTER statement) on the object in the future. All+New = Combination of All and New. Returns a period if the type of permission does not apply to columns. |
Remarks
All the parameters in the following procedure are optional. If executed with no parameters, sp_helprotect displays all the permissions that have been granted or denied in the current database.
If some but not all the parameters are specified, use named parameters to identify the particular parameter, or NULL as a placeholder. For example, to report all permissions for the grantor database owner (dbo), execute the following:
EXEC sp_helprotect NULL, NULL, dbo
Or
EXEC sp_helprotect @grantorname = 'dbo'
The output report is sorted by permission category, owner, object, grantee, grantor, protection type category, protection type, action, and column sequential ID.
Permissions
Requires membership in the public role.
Information returned is subject to restrictions on access to metadata. Entities on which the principal has no permission do not appear. For more information, see Metadata Visibility Configuration.
Examples
A. Listing the permissions for a table
The following example lists the permissions for the titles table.
EXEC sp_helprotect 'titles';
B. Listing the permissions for a user
The following example lists all permissions that user Judy has in the current database.
EXEC sp_helprotect NULL, 'Judy';
C. Listing the permissions granted by a specific user
The following example lists all permissions that were granted by user Judy in the current database, and uses NULL as a placeholder for the missing parameters.
EXEC sp_helprotect NULL, NULL, 'Judy';
D. Listing the statement permissions only
The following example lists all the statement permissions in the current database, and uses NULL as a placeholder for the missing parameters.
EXEC sp_helprotect NULL, NULL, NULL, 's';
e. Listing the permissions for a CREATE statement
The following example list all users who have been granted the CREATE TABLE permission.
EXEC sp_helprotect @name = 'CREATE TABLE';