sp_add_proxy (Transact-SQL)
S'applique à : SQL Server
Ajoute le proxy SQL Server Agent spécifié.
Conventions de la syntaxe Transact-SQL
sp_add_proxy
[ @proxy_name = ] 'proxy_name'
, [ @enabled = ] is_enabled
, [ @description = ] 'description'
, [ @credential_name = ] 'credential_name'
, [ @credential_id = ] credential_id
, [ @proxy_id = ] id OUTPUT
[ ; ]
Nom du proxy à créer. Le @proxy_name est sysname, avec la valeur par défaut NULL
. Lorsque le @proxy_name est NULL
ou une chaîne vide, le nom du proxy est défini par défaut sur le @credential_name ou @credential_id fourni.
Indique si le proxy est activé. L’indicateur @enabled est tinyint, avec une valeur par défaut .1
Lorsque @enabled est 0
, le proxy n’est pas activé et ne peut pas être utilisé par une étape de travail.
Description du proxy. La description est nvarchar(512), avec la valeur par défaut NULL
. La description vous permet de documenter le proxy, mais n’est pas utilisée par SQL Server Agent. Cet argument est donc facultatif.
Nom relatif aux informations d'identification du proxy. La @credential_name est sysname, avec la valeur par défaut NULL
. Vous devez spécifier @credential_name ou @credential_id .
Numéro d'identification relatif aux informations d'identification du proxy. La @credential_id est int, avec la valeur par défaut NULL
. Vous devez spécifier @credential_name ou @credential_id .
Numéro d'identification attribué au proxy en cas de création réussie.
0
(réussite) or 1
(échec).
Aucune.
Cette procédure stockée doit être exécutée dans la msdb
base de données.
Un proxy SQL Server Agent gère la sécurité des étapes de travail qui impliquent des sous-systèmes autres que le sous-système Transact-SQL. Chaque proxy correspond à des informations d'identification de sécurité. Un proxy peut avoir accès à un nombre quelconque de sous-systèmes.
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.
Les membres du rôle de sécurité fixe sysadmin peuvent créer des étapes de travail qui utilisent n’importe quel proxy. Utilisez la procédure stockée sp_grant_login_to_proxy pour accorder à d’autres connexions l’accès au proxy.
Cet exemple crée un proxy pour les informations d'identification CatalogApplicationCredential
. Le code part du principe que les informations d'identification existent déjà. Pour plus d’informations sur les informations d’identification, consultez CREATE CREDENTIAL.
USE msdb;
GO
EXEC dbo.sp_add_proxy
@proxy_name = 'Catalog application proxy',
@enabled = 1,
@description = 'Maintenance tasks on catalog application.',
@credential_name = 'CatalogApplicationCredential';
GO