sp_add_proxy (Transact-SQL)

Artículo
12/15/2008

Agrega el proxy especificado del Agente Microsoft SQL Server.

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 de tipo tinyint y su valor predeterminado es 1. Cuando el valor de is_enabled es 0, el proxy no está habilitado y no se puede utilizar en un paso del 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.

Conjuntos de resultados

Ninguno

Notas

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

Sólo pueden ejecutar este procedimiento los miembros de la función fija de seguridad sysadmin.

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

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Crear un proxy

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

Vea también

Referencia

CREATE CREDENTIAL (Transact-SQL)
sp_grant_login_to_proxy (Transact-SQL)
sp_revoke_login_from_proxy (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Share via