sp_help_proxy (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_help_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name' ,
    [ @subsystem_name = ] 'subsystem_name' ,
    [ @name = ] 'name'

Argumentos

  • [ [ @proxy_id = ] id
    O número de identificação de proxy do proxy para o qual listar informações. O proxy_id é int, com um padrão NULL. Pode ser especificada a id ou o proxy_name pode ser especificado

  • [ [ @proxy_name = ] 'proxy_name'
    O nome do proxy para o qual listar informações. O proxy_name é sysname, com um padrão NULL. Pode ser especificada a id ou o proxy_name pode ser especificado

  • [ [ @subsystem_name = ] 'subsystem_name'
    O nome do subsistema para o qual listar proxies. O subsystem_name é sysname, com um padrão NULL. Quando subsystem_name for especificado, name também deverá ser especificado.

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

    Valor

    Descrição

    ActiveScripting

    Script do ActiveX

    CmdExec

    Sistema Operacional (CmdExec)

    Snapshot

    Replication Snapshot Agent

    LogReader

    Replication Log Reader Agent

    Distribution

    Replication Distribution Agent

    Merge

    Replication Merge Agent

    QueueReader

    Replication Queue Reader Agent

    ANALYSISQUERY

    Comando do Analysis Services

    ANALYSISCOMMAND

    Consulta do Analysis Services

    Dts

    Execução do pacote SSIS

    PowerShell

    Scripts PowerShell

  • [ @name = ] 'name'
    O nome de um login do SQL Server para o qual listar proxies. O nome é nvarchar(256), com um padrão NULL. Quando name for especificado, subsystem_name também deverá ser especificado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos 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 o proxy está habilitado. { 0 = não habilitado, 1 = habilitado }

description

nvarchar(1024)

A descrição para esse proxy.

user_sid

varbinary(85)

A identificação 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 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 login pode usar em um determinado subsistema, especifique name e subsystem_name. Quando esses argumentos são fornecidos, sp_help_proxy lista os proxies que o login especificado pode acessar e que podem ser usados para o subsistema especificado.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários a função de banco de dados fixa SQLAgentOperatorRole no banco de dados msdb.

Para obter detalhes sobre SQLAgentOperatorRole, consulte Funções de banco de dados fixas do SQL Server Agent.

ObservaçãoObservação

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

Exemplos

A. Listando 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. Listando 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