sp_helpuser (Transact-SQL)

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

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

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)