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 que pueden protegerse incluidos en SQL Server 2005. Utilice en su lugar sys.database_principals.

Icono de vínculo a temasConvenciones 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.

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

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

Role_name

sysname

Nombre de la función en la base de datos actual.

Role_id

smallint

Id. de función para la función en la base de datos actual.

Users_in_role

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.

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.

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'