• Articolo

sp_help_proxy (Transact-SQL)

Visualizza le informazioni per uno o più proxy.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @proxy_id = ] id
    Numero di identificazione del proxy per cui visualizzare un elenco di informazioni. proxy_id è di tipo int e il valore predefinito è NULL. È possibile specificare l'argomento id o l'argomento proxy_name.

  • [ @proxy_name = ] 'proxy_name'
    Nome del proxy per cui visualizzare un elenco di informazioni. proxy_name è di tipo sysname e il valore predefinito è NULL. È possibile specificare l'argomento id o l'argomento proxy_name.

  • [ @subsystem_name = ] 'subsystem_name'
    Il nome del sottosistema per cui visualizzare un elenco dei proxy. subsystem_name è di tipo sysname e il valore predefinito è NULL. Se si specifica subsystem_name, è necessario specificare anche name.

    Nella tabella seguente vengono elencati i valori disponibili per ogni sottosistema.

    Valore

    Descrizione

    ActiveScripting

    Script ActiveX

    CmdExec

    Sistema operativo (CmdExec)

    Snapshot

    Agente snapshot repliche

    LogReader

    Agente lettura log repliche

    Distribution

    Agente distribuzione repliche

    Merge

    Agente merge repliche

    QueueReader

    Agente lettura coda repliche

    ANALYSISQUERY

    Comando di Analysis Services

    ANALYSISCOMMAND

    Query di Analysis Services

    Dts

    Esecuzione pacchetti SSIS

    PowerShell

    Script di PowerShell

  • [ [ @name = ] 'name'
    Il nome di un accesso SQL Server per cui visualizzare un elenco dei proxy. Il nome è nvarchar(256) e il valore predefinito è NULL. Se si specifica name, è necessario specificare anche subsystem_name.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nome colonna

Tipo di dati

Descrizione

proxy_id

int

Numero di identificazione del proxy.

name

sysname

Nome del proxy.

credential_identity

sysname

Nome utente e del dominio Microsoft Windows per le credenziali associate al proxy.

enabled

tinyint

Indica se il proxy è attivato. { 0 = non attivato, 1 = attivato }

description

nvarchar(1024)

Descrizione del proxy.

user_sid

varbinary(85)

ID di protezione (SID) di Windows dell'utente di Windows per questo proxy.

credential_id

int

Identificatore per le credenziali associate a questo proxy.

credential_identity_exists

int

Indica se credential_identity esiste. { 0 = non esiste, 1 = esiste }

Osservazioni

Se non vengono specificati parametri, sp_help_proxy restituisce un elenco di informazioni relative a tutti i proxy nell'istanza.

Per determinare quali proxy possono essere utilizzati da un account di accesso per un determinato sottosistema, specificare gli argomenti name e subsystem_name. Quando vengono specificati questi argomenti, sp_help_proxy visualizza un elenco di proxy cui può accedere l'account di accesso specificato e che può essere utilizzato per il sottosistema specificato.

Autorizzazioni

Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere al ruolo predefinito del database SQLAgentOperatorRole nel database msdb.

Per informazioni su SQLAgentOperatorRole, vedere Ruoli di database predefiniti di SQL Server Agent.

Nota

Le colonne credential_identity e user_sid vengono restituite nel set di risultati solo quando la stored procedure viene eseguita da membri di sysadmin.

Esempi

A. Visualizzazione di un elenco di di informazioni per tutti i proxy

Nell'esempio seguente viene visualizzato un elenco di informazioni per tutti i proxy nell'istanza.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

B. Visualizzazione di un elenco di informazioni per un proxy specifico

Nell'esempio seguente viene visualizzato un elenco di informazioni per il proxy denominato Catalog application proxy.

USE msdb ;
GO

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