Partager via


sp_add_proxy (Transact-SQL)

S'applique à : SQL Server

Ajoute le proxy SQL Server Agent spécifié.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_add_proxy
    [ @proxy_name = ] 'proxy_name'
    , [ @enabled = ] is_enabled
    , [ @description = ] 'description'
    , [ @credential_name = ] 'credential_name'
    , [ @credential_id = ] credential_id
    , [ @proxy_id = ] id OUTPUT
[ ; ]

Arguments

[ @proxy_name = ] 'proxy_name'

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.

[ @enabled = ] is_enabled

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 = ] 'description'

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.

[ @credential_name = ] 'credential_name'

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 .

[ @credential_id = ] 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 .

[ @proxy_id = ] sortie proxy_id

Numéro d'identification attribué au proxy en cas de création réussie.

Valeurs des codes de retour

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

Jeu de résultats

Aucune.

Notes

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.

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.

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.

Exemples

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