Partager via

  • Article

sp_add_proxy (Transact-SQL)

Ajoute le proxy SQL Server Agent spécifié.

Icône Lien de rubriqueConventions de la syntaxe de 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. L'argument proxy_name est de type sysname, avec NULL comme valeur par défaut. Lorsque proxy_name a la valeur NULL ou contient une chaîne vide, le nom du proxy est extrait par défaut de l'argument user_name fourni.

  • [ @enabled = ] is_enabled
    Indique si le proxy est activé. L'indicateur is_enabled est de type tinyint, avec une valeur par défaut de 1. Lorsque is_enabled prend la valeur 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 de type nvarchar(512), avec NULL comme valeur par défaut. La description vous permet de documenter le proxy, mais elle n'est pas utilisée à d'autres fins par l'Agent SQL Server. Cet argument est donc facultatif.

  • [ @credential_name = ] 'credential_name'
    Nom relatif aux informations d'identification du proxy. L'argument credential_name est de type sysname, avec NULL comme valeur par défaut. credential_name ou credential_id doit être spécifié.

  • [ @credential_id = ] credential_id
    Numéro d'identification relatif aux informations d'identification du proxy. L'argument credential_id est de type int, avec NULL comme valeur par défaut. credential_name ou credential_id doit être spécifié.

  • [ @proxy_id= ] id OUTPUT
    Numéro d'identification attribué au proxy en cas de création réussie.

Valeurs des codes renvoyés

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

Jeux de résultats

Aucun

Notes

Cette procédure stockée doit être exécutée à partir de la base de données msdb.

Un proxy de l'Agent SQL Server 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 à plusieurs sous-systèmes.

Autorisations

Seuls les membres du rôle de sécurité fixe sysadmin peuvent exécuter cette procédure.

Les membres du rôle de sécurité fixe sysadmin peuvent créer des étapes de travail utilisant un proxy. Utilisez la procédure stockée sp_grant_login_to_proxy (Transact-SQL) pour autoriser d'autres connexions à accéder au proxy.

Exemple

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, voir CREATE CREDENTIAL (Transact-SQL).

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