Share via

sp_help_proxy (Transact-SQL)

  • Article

S’applique à :SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @proxy_id = ] proxy_id

Numéro d'identification du serveur proxy pour lequel énumérer les informations. @proxy_id est int, avec la valeur par défaut NULL. Le @proxy_id ou le @proxy_name peut être spécifié.

[ @proxy_name = ] N’proxy_name'

Nom du serveur proxy pour lequel énumérer les informations. @proxy_name est sysname, avec la valeur par défaut NULL. Le @proxy_id ou le @proxy_name peut être spécifié.

[ @subsystem_name = ] N’subsystem_name'

Nom du sous-système pour lequel énumérer les serveurs proxy. @subsystem_name est sysname, avec la valeur par défaut NULL. Lorsque @subsystem_name est spécifié, @name doit également être spécifié.

Le tableau suivant répertorie les valeurs possibles pour chaque sous-système.

Valeur Description
ActiveScripting Script ActiveX
CmdExec Système d’exploitation (CmdExec)
Snapshot Replication Snapshot Agent
LogReader Agent de lecture du journal des réplications
Distribution Replication Distribution Agent
Merge Replication Merge Agent
QueueReader Agent de lecture de la file d’attente de réplication
ANALYSISQUERY Commande Analysis Services
ANALYSISCOMMAND Requête Analysis Services
Dts Exécution de package SSIS
PowerShell Script PowerShell

[ @name = ] N’name'

Nom d’une connexion SQL Server pour laquelle répertorier les proxys. @name est nvarchar(256), avec la valeur par défaut NULL. Lorsque @name est spécifié, @subsystem_name doit également être spécifié.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

Nom de la colonne Type de données Description
proxy_id int Numéro d'identification du proxy.
name sysname Nom du 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 = n’existe pas, 1 = existe.

Notes

Lorsqu’aucun paramètre n’est fourni, sp_help_proxy répertorie les informations de tous les proxys dans l’instance.

Pour déterminer les proxys 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 proxys auxquels la connexion spécifiée peut accéder et qui peuvent être utilisés pour le sous-système spécifié.

Autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

D’autres utilisateurs doivent disposer de l’un des rôles de base de données fixes SQL Server Agent suivants dans la msdb base de données :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

Les credential_identity colonnes et user_sid les colonnes sont retournées uniquement dans le jeu de résultats lorsque les membres de sysadmin exécutent cette procédure stockée.

Exemples

R. Informations de liste pour tous les proxys

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. Répertorier les informations d’un 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

Contenu connexe