sp_add_proxy (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Agrega el proxy de Agente SQL Server especificado.

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. El @proxy_name es sysname, con un valor predeterminado de NULL. Cuando el @proxy_name es NULL o una cadena vacía, el nombre del proxy tiene como valor predeterminado el @credential_name o @credential_id proporcionado.

[ @enabled = ] is_enabled

Especifica si el proxy está habilitado. La marca @enabled es tinyint, con un valor predeterminado de 1. Cuando @enabled es 0, el proxy no está habilitado y no se puede usar en un paso de trabajo.

[ @description = ] 'description'

Descripción del proxy. La descripción es nvarchar(512), con un valor predeterminado de NULL. La descripción permite documentar el proxy, pero no lo usa Agente SQL Server. Por tanto, este argumento es opcional.

[ @credential_name = ] 'credential_name'

Nombre de la credencial para el proxy. El @credential_name es sysname, con un valor predeterminado de NULL. Se deben especificar @credential_name o @credential_id .

[ @credential_id = ] credential_id

Número de identificación de la credencial para el proxy. El @credential_id es int, con un valor predeterminado de NULL. Se deben especificar @credential_name o @credential_id .

[ @proxy_id = ] proxy_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 (erróneo).

Conjunto de resultados

Ninguno.

Comentarios

Este procedimiento almacenado debe ejecutarse en la msdb base de datos.

Un proxy de Agente SQL Server administra la seguridad de los pasos de trabajo que implican subsistemas distintos del subsistema transact-SQL. Cada proxy se corresponde con unas credenciales de seguridad. Un proxy puede tener acceso a cualquier número de subsistemas.

Permisos

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

Los miembros del rol fijo de seguridad sysadmin pueden crear pasos de trabajo que usen cualquier proxy. Use el procedimiento almacenado sp_grant_login_to_proxy (Transact-SQL) para conceder a otros inicios de sesión acceso 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

Contenido relacionado