sp_help_proxy (Transact-SQL)
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
. Les @proxy_id ou les @proxy_name peuvent être spécifiés.
[ @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
. Les @proxy_id ou les @proxy_name peuvent être spécifiés.
[ @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) or 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 | Spécifie si ce proxy est activé. 0 = non activé, 1 = activé. |
description |
nvarchar(1024) | Description de ce serveur proxy. |
user_sid |
varbinary(85) | ID de sécurité Windows de l’utilisateur Windows pour ce proxy. |
credential_id |
int | Identifiant des informations d'identification associées à ce serveur proxy. |
credential_identity_exists |
int | Spécifie si l’existence credential_identity 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
Vous pouvez accorder EXECUTE
des autorisations sur cette procédure, 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