sp_helpuser (Transact-SQL)
Relata informações sobre principais em nível de banco de dados no banco de dados atual.
.gif "Observação importante") Importante |
|---|
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. |
.gif "Ícone de vínculo de tópico")
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'
Consulte também