sp_helprotect (Transact-SQL)
Devuelve un informe con información acerca de los permisos de usuario para un objeto o los permisos de una instrucción en la base de datos actual.
Importante
sp_helprotect no devuelve información acerca de los elementos protegibles incluidos en SQL Server 2005.Use sys.database_permissions y fn_builtin_permissions en su lugar.
No muestra los permisos que se asignan siempre a los roles fijos de servidor o a los roles fijos de base de datos. No incluye los inicios de sesión o los usuarios que reciben los permisos en función de su pertenencia a un rol.
Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual). |
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_helprotect [ [ @name = ] 'object_statement' ]
[ , [ @username = ] 'security_account' ]
[ , [ @grantorname = ] 'grantor' ]
[ , [ @permissionarea = ] 'type' ]
Argumentos
[ @name = ] 'object_statement'
Es el nombre del objeto de la base de datos actual, o una instrucción, cuyos permisos se van a presentar. object_statement es de tipo nvarchar(776) y su valor predeterminado es NULL, que devuelve los permisos de todos los objetos e instrucciones. Si el valor es un objeto (tabla, vista, procedimiento almacenado o procedimiento almacenado extendido), tiene que ser un objeto válido de la base de datos actual. El nombre del objeto puede incluir un calificador de propietario en el formato owner**.**object.Si object_statement es una instrucción, puede ser una instrucción CREATE.
[ @username = ] 'security_account'
Es el nombre de la entidad de seguridad para la que se muestran los permisos. security_account es de tipo sysname y su valor predeterminado es NULL, que devuelve todas las entidades de seguridad de la base de datos actual. security_account debe existir en la base de datos actual.[ @grantorname = ] 'grantor'
Es el nombre de la entidad de seguridad que ha concedido los permisos. grantor es de tipo sysname y su valor predeterminado es NULL, que devuelve la información de los permisos concedidos por las entidades de seguridad de la base de datos.[ @permissionarea = ] 'type'
Es una cadena de caracteres que indica si se muestran permisos de objeto (cadena de caracteres o), permisos de instrucción (cadena de caracteres s) o ambos (o s). type es de tipo varchar(10) y su valor predeterminado es o s. El parámetro type puede ser cualquier combinación de o y s, con o sin comas o espacios entre o y s.
Valores de código de retorno
0 (correcto) o 1 (error)
Conjuntos de resultados
Nombre de columna |
Tipo de datos |
Descripción |
|---|---|---|
Owner |
sysname |
Nombre del propietario del objeto. |
Objeto |
sysname |
Nombre del objeto. |
Grantee |
sysname |
Nombre de la entidad de seguridad en la que se conceden los permisos. |
Otorgante de permisos |
sysname |
Nombre de la entidad de seguridad que ha concedido los permisos al receptor de permisos especificado. |
ProtectType |
nvarchar(10) |
Nombre del tipo de protección: GRANT REVOKE |
Acción |
nvarchar(60) |
Nombre del permiso. Las instrucciones válidas de permisos dependen del tipo de objeto. |
Columna |
sysname |
Tipo de permiso: All = Permiso sobre todas las columnas actuales del objeto. New = Permiso sobre las nuevas columnas del objeto que se pueden cambiar (mediante la instrucción ALTER) posteriormente. All+New = Combinación de Todas y Nuevas. Devuelve un punto si el tipo de permiso no se aplica a las columnas. |
Comentarios
Todos los parámetros del siguiente procedimiento son opcionales. Si se ejecuta sin parámetros, sp_helprotect presenta todos los permisos que se han concedido o denegado en la base de datos actual.
Si se especifican algunos parámetros, pero no todos, se tienen que utilizar parámetros con nombre para identificar el parámetro concreto o NULL como marcador de posición. Por ejemplo, para presentar todos los permisos del propietario de la base de datos del otorgante de permisos (dbo), ejecute:
EXEC sp_helprotect NULL, NULL, dbo;
O bien
EXEC sp_helprotect @grantorname = 'dbo';
El resultado está ordenada por categoría de los permisos, propietario, objeto, beneficiario, asignador, categoría del tipo de protección, tipo de protección, acción e Id. secuencial de columna.
Permisos
Requiere la pertenencia al rol public.
La información mostrada está sometida a restricciones de acceso a los metadatos. No se mostrarán las entidades en las que la entidad de seguridad no tiene permiso. Para obtener más información, vea Configuración de visibilidad de los metadatos.
Ejemplos
A.Presentar los permisos de una tabla
En el siguiente ejemplo se presentan los permisos de la tabla titles.
EXEC sp_helprotect 'titles';
B.Presentar los permisos de un usuario
En el siguiente ejemplo se presentan todos los permisos que el usuario Judy tiene en la base de datos actual.
EXEC sp_helprotect NULL, 'Judy';
C.Presentar los permisos concedidos por un usuario específico
En el siguiente ejemplo se presentan todos los permisos concedidos por el usuario Judy en la base de datos actual, con NULL como marcador de posición en los parámetros no especificados.
EXEC sp_helprotect NULL, NULL, 'Judy';
D.Presentar solo los permisos de las instrucciones
En el siguiente ejemplo se presentan todos los permisos de instrucciones de la base de datos actual, con NULL como marcador de posición para los parámetros no especificados.
EXEC sp_helprotect NULL, NULL, NULL, 's';
e.Presentar los permisos de una instrucción CREATE
En el ejemplo siguiente se muestran todos los usuarios a los que se ha concedido el permiso CREATE TABLE.
EXEC sp_helprotect @name = 'CREATE TABLE';