sp_helpuser (Transact-SQL)

Relata informações sobre principais em nível de banco de dados no banco de dados atual.

Observação importanteImportante

O sp_helpuser não retorna informações sobre protegíveis que foram introduzidos no SQL Server 2005. Use sys.database_principals em vez disso.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_helpuser [ [ @name_in_db = ] 'security_account' ]

Argumentos

  • [ @name_in_db = ] 'security_account'
    É o nome do usuário de banco de dados ou da função de banco de dados no banco de dados atual. security_account deve existir no banco de dados atual. security_account é sysname, com um padrão NULL. Se security_account não for especificado, sp_helpuser retornará informações sobre todos os principais de banco de dados.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

A tabela a seguir mostra o conjunto de resultados quando nenhuma conta de usuário nem um usuário do SQL Server ou do Windows for especificado para security_account.

Nome da coluna

Tipo de dados

Descrição

UserName

sysname

Usuários no banco de dados atual.

RoleName

sysname

Funções às quais UserName pertence.

LoginName

sysname

Logon de UserName.

DefDBName

sysname

Banco de dados padrão de UserName.

DefSchemaName

sysname

Esquema padrão do usuário de banco de dados.

UserID

smallint

ID de UserName no banco de dados atual.

SID

smallint

Número de identificação de segurança (SID) do usuário.

A tabela a seguir mostra o conjunto de resultados quando nenhum usuário é especificado e existem aliases no banco de dados atual.

Nome da coluna

Tipo de dados

Descrição

LoginName

sysname

Logons com aliases para usuários no banco de dados atual.

UserNameAliasedTo

sysname

Nome de usuário no banco de dados atual para o qual o logon possui alias.

A tabela a seguir mostra o conjunto de resultados quando uma função é especificada para security_account.

Nome da coluna

Tipo de dados

Descrição

Role_name

sysname

Nome da função no banco de dados atual.

Role_id

smallint

ID de função para a função no banco de dados atual.

Users_in_role

sysname

Membro da função no banco de dados atual.

Userid

smallint

ID de usuário do membro da função.

Comentários

Para consultar informações sobre associação de funções de banco de dados, use sys.database_role_members. Para consultar informações sobre membros de função de servidor, use sys.server_role_members, e para consultar informações sobre principais em nível de servidor, use sys.server_principals.

Permissões

Requer associação na função pública.

As informações retornadas estão sujeitas a restrições no acesso para metadados. Entidades em que o principal não tem nenhuma permissão não aparecem. Para obter mais informações, consulte Configuração de visibilidade de metadados.

Exemplos

A. Listando todos os usuários

O exemplo a seguir lista todos os usuários no banco de dados atual.

EXEC sp_helpuser

B. Listando informações para um único usuário

O exemplo a seguir lista informações sobre o proprietário banco de dados de usuário (dbo).

EXEC sp_helpuser 'dbo'

C. Listando informações para uma função de banco de dados

O exemplo a seguir lista informações sobre a função de banco de dados fixa db_securityadmin.

EXEC sp_helpuser 'db_securityadmin'