sp_helpuser (Transact-SQL)

Artículo
12/15/2008

Actualizado: 14 de abril de 2006

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 que pueden protegerse 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 del usuario o función de base de datos de la base de datos actual. El parámetro security_account debe existir en la base de datos actual. El parámetro security_account es de tipo sysname y su valor predeterminado de NULL. Si no se especifica security_account, sp_helpuser devuelve información acerca de todas las entidades de seguridad de la base de datos.

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.
GroupName	sysname	Funciones a las 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 una función para security_account.

Nombre de columna	Tipo de datos	Descripción
Group_name	sysname	Nombre de la función en la base de datos actual.
Group_id	smallint	Id. de función para la función en la base de datos actual.
Users_in_group	sysname	Miembro de la función en la base de datos actual.
Userid	smallint	Id. de usuario del miembro de la función.

Notas

Para obtener información acerca de la pertenencia de funciones de base de datos, use sys.database_role_members. Para obtener información acerca de miembros de función de servidor, use sys.server_role_members y para obtener información acerca de entidades de seguridad de nivel de servidor, utilice sys.server_principals.

La ejecución de sp_helpuser en una función de base de datos es equivalente a la ejecución de sp_helpgroup en dicha función de base de datos.

Permisos

Requiere la pertenencia a la función 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.

Valores de código de retorno

0 (correcto) o 1 (error)

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 una función de base de datos

En el siguiente ejemplo se presenta información acerca de la función fija de base de datos db_securityadmin.

EXEC sp_helpuser 'db_securityadmin'

Vea también

Historial de cambios

Versión	Historial
14 de abril de 2006	Contenido nuevo: Se ha agregado la columna DefSchemaName.