Partager via

  • Article

sp_help_proxy (Transact-SQL)

Répertorie les informations d'un ou plusieurs serveurs proxy.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

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

Arguments

  • [ @proxy_id= ] id
    Numéro d'identification du serveur proxy pour lequel énumérer les informations. L'argument proxy_id est de type int, avec NULL comme valeur par défaut. L'argument id ou proxy_name peut être spécifié.

  • [ @proxy_name= ] 'proxy_name'
    Nom du serveur proxy pour lequel énumérer les informations. L'argument proxy_name est de type sysname, avec NULL comme valeur par défaut. L'argument id ou proxy_name peut être spécifié.

  • [ @subsystem_name = ] 'subsystem_name'
    Nom du sous-système pour lequel énumérer les serveurs proxy. L'argument subsystem_name est de type sysname, avec NULL comme valeur par défaut. Lorsque l'argument subsystem_name est spécifié, la valeur de name doit également être spécifiée.

    Le tableau ci-dessous répertorie les valeurs pour chaque sous-système.

    Valeur

    Description

    ActiveScripting

    Script ActiveX

    CmdExec

    Système d’exploitation (CmdExec)

    Snapshot

    Agent de capture instantanée des réplications

    LogReader

    Agent de lecture du journal des réplications

    Distribution

    Agent de distribution des réplications

    Merge

    Agent de fusion des réplications

    QueueReader

    Agent de lecture de file d'attente de la réplication

    ANALYSISQUERY

    Commande Analysis Services

    ANALYSISCOMMAND

    Requête Analysis Services

    Dts

    Exécution de package SSIS

    PowerShell

    script PowerShell

  • [ @name = ] 'name'
    Nom d'une connexion SQL Server pour laquelle énumérer les serveurs proxy. Le nom est de type nvarchar(256), avec pour valeur par défaut NULL. Lorsque l'argument name est spécifié, la valeur de subsystem_name doit également être spécifiée.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Nom de la colonne

Type de données

Description

proxy_id

int

Numéro d'identification du serveur proxy.

name

sysname

Nom du serveur proxy.

credential_identity

sysname

Nom du domaine Microsoft Windows et nom d'utilisateur pour les informations d'identification associées au serveur proxy.

enabled

tinyint

Indique si ce serveur proxy est activé. { 0 = non activé, 1 = activé }

description

nvarchar(1024)

Description de ce serveur proxy.

user_sid

varbinary(85)

Numéro d'identification de sécurité (SID) Windows de l'utilisateur Windows pour ce serveur proxy.

credential_id

int

Identifiant des informations d'identification associées à ce serveur proxy.

credential_identity_exists

int

Indique si l'identifiant des informations d'identification existe. { 0 = inexistant, 1 = existant }

Notes

Lorsque aucun paramètre n'est fourni, sp_help_proxy répertorie les informations pour tous les serveurs proxy de l'instance.

Pour déterminer les serveurs proxy qu'une connexion peut utiliser pour un sous-système donné, spécifiez name et subsystem_name. Lorsque ces arguments sont fournis, sp_help_proxy répertorie les serveurs proxy auxquels la connexion spécifiée peut accéder et qui sont utilisables pour le sous-système spécifié.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure stockée. D'autres utilisateurs doivent disposer du rôle de base de données fixe SQLAgentOperatorRole dans la base de données msdb.

Pour en savoir plus sur SQLAgentOperatorRole, consultez Rôles de base de données fixes de l'Agent SQL Server.

[!REMARQUE]

Les colonnes credential_identity et user_sid sont renvoyées dans l'ensemble de résultats uniquement lorsque ce sont des membres de sysadmin qui exécutent cette procédure stockée.

Exemples

A. Affichage des informations pour tous les serveurs proxy

L'exemple ci-dessous répertorie les informations pour tous les serveurs proxy de l'instance.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

B. Affichage des informations pour un serveur proxy spécifique

L'exemple ci-dessous répertorie les informations pour le serveur proxy nommé Catalog application proxy.

USE msdb ;
GO

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