Compartilhar via


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 que foram introduzidos no SQL Server 2005 (9.x) e versões posteriores. Em vez disso, use sys.database_principals .

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_helpuser [ [ @name_in_db = ] N'name_in_db' ]
[ ; ]

Argumentos

@name_in_db [ = ] N'name_in_db'

O nome do usuário do banco de dados ou da função de banco de dados no banco de dados atual. @name_in_db é sysname, com um padrão de NULL. @name_in_db deve existir no banco de dados atual. Se @name_in_db não for especificado, sp_helpuser retornará informações sobre todas as entidades de banco de dados.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

A tabela a seguir mostra o conjunto de resultados quando nenhuma conta de usuário, SQL Server ou usuário do Windows é especificado para @name_in_db.

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 Login de UserName.
DefDBName sysname Banco de dados padrão do UserName.
DefSchemaName sysname Esquema padrão do usuário de banco de dados.
UserID smallint ID de no banco de UserName 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 @name_in_db.

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. As entidades nas quais a entidade de segurança não tem permissão não aparecem. Para obter mais informações, consulte Metadata Visibility Configuration.

Exemplos

R. Listar todos os usuários

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

EXEC sp_helpuser;

B. Listar 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. Listar 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';