sp_helpuser (Transact-SQL)

Proporciona información acerca de las entidades de seguridad de base de datos en la base de datos actual.

Nota importanteImportante

sp_helpuser no devuelve información acerca de los elementos protegibles incluidos en SQL Server 2005. Utilice en su lugar sys.database_principals.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helpuser [ [ @name_in_db = ] 'security_account' ]

Argumentos

  • [ @name_in_db = ] 'security_account'
    Es el nombre de un usuario o un rol de la base de datos actual. security_account debe existir en la base de datos actual. security_account es de tipo sysname y su valor predeterminado es NULL. Si no se especifica security_account, sp_helpuser devuelve información acerca de todas las entidades de seguridad de la base de datos.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

En la siguiente tabla se muestra el conjunto de resultados cuando no se especifica una cuenta de usuario ni un usuario de Windows o de SQL Server para security_account.

Nombre de columna

Tipo de datos

Descripción

UserName

sysname

Usuarios en la base de datos actual.

RoleName

sysname

Roles a los que pertenece UserName.

LoginName

sysname

Inicio de sesión de UserName.

DefDBName

sysname

Base de datos predeterminada de UserName.

DefSchemaName

sysname

Esquema predeterminado del usuario de la base de datos.

UserID

smallint

Id. de UserName en la base de datos actual.

SID

smallint

Número de identificación de seguridad del usuario (SID).

En la siguiente tabla se muestra el conjunto de resultados cuando no se especifica una cuenta de usuario y existen alias en la base de datos actual.

Nombre de columna

Tipo de datos

Descripción

LoginName

sysname

Inicios de sesión asociados con los usuarios en la base de datos actual.

UserNameAliasedTo

sysname

Nombre de usuario en la base de datos actual al que está asociado el inicio de sesión.

En la siguiente tabla se muestra el conjunto de resultados cuando se especifica un rol para security_account.

Nombre de columna

Tipo de datos

Descripción

Role_name

sysname

Nombre del rol en la base de datos actual.

Role_id

smallint

Id. de rol para el rol en la base de datos actual.

Users_in_role

sysname

Miembro del rol en la base de datos actual.

Userid

smallint

Id. de usuario del miembro del rol.

Comentarios

Para obtener información acerca de la pertenencia a roles de base de datos, use sys.database_role_members. Para obtener información acerca de los miembros del rol de servidor, use sys.server_role_members y para obtener información acerca de las entidades de seguridad a nivel de servidor, utilice sys.server_principals.

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 todos los usuarios

En el siguiente ejemplo se presentan todos los usuarios de la base de datos actual.

EXEC sp_helpuser

B.Presentar información de un solo usuario

En el siguiente ejemplo se presenta información acerca del propietario de la base de datos del usuario (dbo).

EXEC sp_helpuser 'dbo'

C.Presentar información de un rol de base de datos

En el siguiente ejemplo se presenta información acerca del rol fijo de base de datos db_securityadmin.

EXEC sp_helpuser 'db_securityadmin'

Vea también

Referencia

Procedimientos almacenados de seguridad (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)

sys.database_principals (Transact-SQL)

sys.database_role_members (Transact-SQL)

sys.server_principals (Transact-SQL)

sys.server_role_members (Transact-SQL)

Conceptos

Entidades de seguridad (motor de base de datos)