sp_help_proxy (Transact-SQL)

Aplica-se: SQL Server

Lista as informações para um ou mais proxies.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @subsystem_name = ] N'subsystem_name' ]
    [ , [ @name = ] N'name' ]
[ ; ]

Argumentos

@proxy_id [ = ] proxy_id

O número de identificação de proxy do proxy para o qual listar informações. @proxy_id é int, com um padrão de NULL. O @proxy_id ou o @proxy_name podem ser especificados.

@proxy_name [ = ] N'proxy_name'

O nome do proxy para o qual listar informações. @proxy_name é sysname, com um padrão de NULL. O @proxy_id ou o @proxy_name podem ser especificados.

@subsystem_name [ = ] N'subsystem_name'

O nome do subsistema para o qual listar proxies. @subsystem_name é sysname, com um padrão de NULL. Quando @subsystem_name é especificado, @name também deve ser especificado.

A tabela a seguir lista os valores padrão para cada subsistema.

Valor Descrição
ActiveScripting Script ActiveX
CmdExec Sistema operacional (CmdExec)
Snapshot Replication Snapshot Agent
LogReader Agente do Leitor de Log de Replicação
Distribution Replication Distribution Agent
Merge Replication Merge Agent
QueueReader Agente de Leitor de Fila de Replicação
ANALYSISQUERY Comando do Analysis Services
ANALYSISCOMMAND Consulta do Analysis Services
Dts Execução do pacote SSIS
PowerShell Script do PowerShell

@name [ = ] N'nome'

O nome de um logon do SQL Server para listar proxies. @name é nvarchar(256), com um padrão de NULL. Quando @name é especificado, @subsystem_name também deve ser especificado.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
proxy_id int Número de identificação de proxy.
name sysname O nome do proxy.
credential_identity sysname O nome de domínio de Microsoft Windows e o nome de usuário para a credencial associada ao proxy.
enabled tinyint Especifica se esse proxy está habilitado. 0 = não habilitado, 1 = habilitado.
description nvarchar(1024) A descrição para esse proxy.
user_sid varbinary(85) A ID de segurança do Windows do usuário do Windows para esse proxy.
credential_id int O identificador para a credencial associada a esse proxy.
credential_identity_exists int Especifica se o credential_identity existe. 0 = não existe, 1 = existe.

Comentários

Quando nenhum parâmetro é fornecido, sp_help_proxy lista informações para todos os proxies na instância.

Para determinar quais proxies um logon pode usar para um determinado subsistema, especifique @name e @subsystem_name. Quando esses argumentos são fornecidos, sp_help_proxy lista os proxies que o logon especificado pode acessar e que podem ser usados para o subsistema especificado.

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas do msdb SQL Server Agent no banco de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

As credential_identity colunas e user_sid só são retornadas no conjunto de resultados quando os membros do sysadmin executam esse procedimento armazenado.

Exemplos

R. Listar informações para todos os proxies

O exemplo a seguir lista as informações para todos os proxies na instância.

USE msdb;
GO

EXEC dbo.sp_help_proxy;
GO

B. Listar informações para um proxy específico

O exemplo a seguir lista as informações para o proxy chamado Catalog application proxy.

USE msdb;
GO

EXEC dbo.sp_help_proxy
    @proxy_name = N'Catalog application proxy';
GO