sp_helprotect (Transact-SQL)

Aplica-se a:SQL Server

Retorna um relatório que tem informações sobre permissões 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 introduzidos no SQL Server 2005 (9.x). Em vez disso, use sys.database_permissions e fn_builtin_permissions .

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

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_helprotect [ [ @name = ] 'object_statement' ]   
     [ , [ @username = ] 'security_account' ]   
     [ , [ @grantorname = ] 'grantor' ]   
     [ , [ @permissionarea = ] 'type' ]  

Argumentos

[ @name = ] 'object_statement' É o nome do objeto no banco de dados atual ou uma instrução que tem as permissões para relatar. object_statement é nvarchar(776), com um padrão de NULL, que retorna todas as permissões de objeto 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 proprietário do formulário.objeto .

Se object_statement for uma instrução , ela poderá ser uma instrução CREATE.

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

[ @grantorname = ] 'grantor' É o nome da entidade de segurança que concedeu permissões. grantor é sysname, com um padrão de NULL, que retorna todas as informações para permissões concedidas por qualquer entidade de segurança no banco de dados.

[ @permissionarea = ] 'type' É uma cadeia de caracteres que indica se é necessário exibir permissões de objeto (cadeia de caracteres o), permissões de instrução (cadeia de caracteres s) ou ambos (so). type é varchar(10),com um padrão de os. type 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 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
Proprietário	sysname	Nome do proprietário do objeto.
Objeto	sysname	Nome do objeto.
Beneficiário	sysname	Nome do principal para o qual foram concedidas permissões.
Concessor	sysname	Nome do principal que concedeu permissões ao usuário autorizado especificado.
ProtectType	nvarchar(10)	Nome do tipo de proteção: GRANT REVOKE
Ação	nvarchar(60)	Nome da permissão. As instruções de permissão válidas dependem do tipo de objeto.
Coluna	sysname	Tipo de permissão: Todas = Permissão que cobre todas as colunas atuais do objeto. Nova = Permissão que cobre qualquer coluna nova que possa ser alterada (com a instrução ALTER) no objeto no futuro. Todas+Nova = combinação de Todas e Nova. Retornará um ponto se o tipo de permissão não se aplicar às colunas.

Comentários

Todos os parâmetros no procedimento seguinte são opcionais. Se for executado sem parâmetros, o sp_helprotect mostra todas as permissões que tenham sido 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 de concessor (dbo), execute o seguinte:

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. 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 as permissões de uma tabela

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

EXEC sp_helprotect 'titles';  

B. Listando as permissões de 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. Listando as permissões concedidas por um usuário específico

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

EXEC sp_helprotect NULL, NULL, 'Judy';  

D. Listando apenas as permissões de instruções

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 receberam a permissão CREATE TABLE.

EXEC sp_helprotect @name = 'CREATE TABLE';  

Consulte Também

Procedimentos armazenados de segurança (Transact-SQL)
DENY (Transact-SQL)
GRANT (Transact-SQL)
REVOKE (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)