sp_add_proxy (Transact-SQL)

Artículo
06/18/2013

Agrega el proxy del Agente SQL Server especificado.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @proxy_name= ] 'proxy_name'
Nombre del proxy que se va a crear. proxy_name es de tipo sysname y su valor predeterminado es NULL. Cuando el valor de proxy_name es NULL o una cadena vacía, de manera predeterminada el nombre del proxy es el valor de user_name suministrado.
[ @enabled = ] is_enabled
Especifica si el proxy está habilitado. La marca is_enabled es tinyint, con un valor predeterminado de 1. Si is_enabled es 0, el proxy no está habilitado y no puede ser utilizado por un paso de trabajo.
[ @description= ] 'description'
Descripción del proxy. La descripción es de tipo nvarchar(512) y su valor predeterminado es NULL. La descripción permite documentar el proxy. El Agente SQL Server no le da otros usos. Por tanto, este argumento es opcional.
[ @credential_name = ] 'credential_name'
Nombre de la credencial para el proxy. credential_name es de tipo sysname y su valor predeterminado es NULL. Debe especificarse credential_name o credential_id.
[ @credential_id = ] credential_id
Número de identificación de la credencial para el proxy. credential_id es de tipo int y su valor predeterminado es NULL. Debe especificarse credential_name o credential_id.
[ @proxy_id= ] id OUTPUT
Número de identificación que se ha asignado al proxy si éste se ha creado correctamente.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

Este procedimiento almacenado se tiene que ejecutar en la base de datos msdb.

Un proxy del Agente SQL Server administra la seguridad para los pasos de trabajo que afectan a los subsistemas que no sean Transact-SQL. Cada proxy corresponde a una credencial de seguridad. Un proxy puede tener acceso a cualquier número de subsistemas.

Permisos

Solo pueden ejecutar este procedimiento los miembros del rol fijo de seguridad sysadmin.

Los miembros del rol fijo de seguridad sysadmin pueden crear pasos de trabajo que utilicen cualquier proxy. Use el procedimiento almacenado sp_grant_login_to_proxy (Transact-SQL) para conceder otros accesos de inicio de sesión al proxy.

Ejemplos

En este ejemplo se crea un proxy para la credencial CatalogApplicationCredential. El código da por supuesto que la credencial ya existe. Para obtener más información sobre las credenciales, vea 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