Share via


sp_helprotect (Transact-SQL)

Aplica-se a:SQL Server

Retorna um relatório que contém informações sobre permissões de usuário para um objeto ou permissões de instrução no banco de dados atual.

Importante

sp_helprotect não retorna informações sobre protegíveis que foram introduzidas no SQL Server 2005 (9.x) e versões posteriores. Em vez disso, use sys.database_permissions e sys.fn_builtin_permissions .

Não lista permissões que são sempre atribuídas às funções de servidor fixas ou funções de banco de dados fixas. Não inclui logins ou usuários que recebem permissões com base em sua associação a uma função.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_helprotect
    [ [ @name = ] N'name' ]
    [ , [ @username = ] N'username' ]
    [ , [ @grantorname = ] N'grantorname' ]
    [ , [ @permissionarea = ] 'permissionarea' ]
[ ; ]

Argumentos

@name [ = ] N'nome'

O nome do objeto no banco de dados atual, ou uma instrução, que são as permissões para relatório. @name é nvarchar(776), com um padrão de , que retorna todas as permissões de NULLobjeto e instrução. Se o valor for um objeto (tabela, exibição, procedimento armazenado ou procedimento armazenado estendido), ele deverá ser um objeto válido no banco de dados atual. O nome do objeto pode incluir um qualificador de proprietário no formato <owner>.<object>.

Se @name é uma declaração, pode ser uma CREATE declaração.

@username [ = ] N'nome de usuário'

O nome da entidade de segurança para a qual as permissões são retornadas. @username é sysname, com um padrão de , que retorna todas as entidades no banco de NULLdados atual. @username deve existir no banco de dados atual.

@grantorname [ = ] N'grantorname'

O nome da entidade de segurança que concedeu permissões. @grantorname é sysname, com um padrão de , que retorna todas as informações para permissões concedidas por qualquer entidade de segurança no banco de NULLdados.

@permissionarea [ = ] 'área de permissão'

Uma cadeia de caracteres que indica se as permissões de objeto (cadeia de caracteres o), permissões de instrução (cadeia de scaracteres) ou ambas (o s). @permissionarea é varchar(10), com um padrão de o s. @permissionarea pode ser qualquer combinação de o e s, com ou sem vírgulas ou espaços entre o e s.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
Owner sysname Nome do proprietário do objeto.
Object sysname Nome do objeto.
Grantee sysname Nome do principal para o qual foram concedidas permissões.
Grantor sysname Nome do principal que concedeu permissões ao usuário autorizado especificado.
ProtectType nvarchar(10) Nome do tipo de proteção:

GRANT REVOKE
Action nvarchar(60) Nome da permissão. As instruções de permissão válidas dependem do tipo de objeto.
Column sysname Tipo de permissão:

All = A permissão abrange todas as colunas atuais do objeto.
New = A permissão abrange quaisquer novas colunas que possam ser alteradas (usando a ALTER instrução) no objeto no futuro.
All+New = Combinação de All e New.

Retorna um ponto se o tipo de permissão não se aplicar a colunas.

Comentários

Todos os parâmetros no procedimento seguinte são opcionais. Se executado sem parâmetros, sp_helprotect exibirá todas as permissões concedidas ou negadas no banco de dados atual.

Se alguns, mas não todos os parâmetros forem especificados, use parâmetros nomeados para identificar o parâmetro particular ou NULL como um espaço reservado. Por exemplo, para relatar todas as permissões para o proprietário do banco de dados concedente (dbo), execute o seguinte script:

EXEC sp_helprotect NULL, NULL, dbo;

Ou

EXEC sp_helprotect @grantorname = 'dbo';

O relatório de saída é classificado por categoria de permissão, proprietário, usuário autorizado, concessor, categoria de tipo de proteção, tipo de proteção, ação e ID sequencial de coluna.

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 o principal não tem permissão não aparecem. Para obter mais informações, consulte Metadata Visibility Configuration.

Exemplos

R. Listar as permissões para uma tabela

O exemplo seguinte lista as permissões para a tabela titles.

EXEC sp_helprotect 'titles';

B. Listar as permissões para um usuário

O exemplo seguinte lista todas as permissões que usuário Judy tem no banco de dados atual.

EXEC sp_helprotect NULL, 'Judy';

C. Listar as permissões concedidas por um usuário específico

O exemplo a seguir lista todas as permissões concedidas pelo usuário Judy no banco de dados atual e usa NULL como um espaço reservado para os parâmetros ausentes.

EXEC sp_helprotect NULL, NULL, 'Judy';

D. Listar somente as permissões de instrução

O exemplo a seguir lista todas as permissões de instrução no banco de dados atual e usa o NULL como um espaço reservado para os parâmetros ausentes.

EXEC sp_helprotect NULL, NULL, NULL, 's';

e. Listando as permissões de uma instrução CREATE

O exemplo a seguir lista todos os usuários que recebem a CREATE TABLE permissão.

EXEC sp_helprotect @name = 'CREATE TABLE';