sp_helpuser (Transact-SQL)

Aplica-se a:SQL Server

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

Importante

sp_helpuser não retorna informações sobre protegíveis introduzidos no SQL Server 2005 (9.x). Em vez disso , use sys.database_principals .

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_helpuser [ [ @name_in_db = ] 'security_account' ]  

Argumentos

[ @name_in_db = ] 'security_account' É o nome do usuário do 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 de NULL. Se security_account não for especificado, sp_helpuser retornará informações sobre todas as entidades de segurança do banco de dados.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

A tabela a seguir mostra o conjunto de resultados quando nem uma conta de usuário nem um SQL Server ou um usuário do Windows são especificados 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 do 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 ver informações sobre a associação de funções de banco de dados, use sys.database_role_members. Para ver informações sobre membros da função de servidor, use sys.server_role_members e para ver informações sobre entidades de segurança no nível do servidor, use sys.server_principals.

Permissões

Requer associação à 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 Metadata Visibility Configuration.

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

Procedimentos armazenados de segurança (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
Entidades (Mecanismo de Banco de Dados)
sys.database_principals (Transact-SQL)
sys.database_role_members (Transact-SQL)
sys.server_principals (Transact-SQL)
sys.server_role_members (Transact-SQL)