sp_helpuser (Transact-SQL)

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

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.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_helpuser [ [ @name_in_db = ] 'security_account' ]

Argumentos

• [ @name_in_db = ] 'security_account'
  É o nome do usuário ou função do 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 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

Referência

Procedimentos armazenados de segurança (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)

sys.database_principals (Transact-SQL)

sys.database_role_members (Transact-SQL)

sys.server_principals (Transact-SQL)

sys.server_role_members (Transact-SQL)

Conceitos

Entidades (Mecanismo de Banco de Dados)