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