sp_add_proxy (Transact-SQL)

Artigo
06/18/2013

Adiciona o proxy especificado do SQL Server Agent.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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'
O nome do proxy a ser criado. O proxy_name é sysname, com um padrão de NULL. Quando o proxy_name é NULL ou uma cadeia de caracteres vazia, o nome do proxy assume como padrão o user_name fornecido.
[ @enabled = ] is_enabled
Especifica se o proxy está habilitado. O sinalizador is_enabled é tinyint, com um padrão de 1. Quando is_enabled for 0, o proxy não estará habilitado e não poderá ser usado por uma etapa de trabalho.
[ @description= ] 'description'
Uma descrição do proxy. A descrição é nvarchar(512), com um padrão de NULL. A descrição permite documentar o proxy, mas não é usada pelo SQL Server Agente. Portanto, este argumento é opcional.
[ @credential_name = ] 'credential_name'
O nome da credencial para o proxy. O credential_name é sysname, com um padrão de NULL. É necessário especificar o credential_name ou o credential_id.
[ @credential_id = ] credential_id
O número de identificação da credencial para o proxy. A credential_id é int, com um padrão de NULL. É necessário especificar o credential_name ou o credential_id.
[ @proxy_id= ] id OUTPUT
O número de identificação de proxy atribuído ao proxy se for criado com êxito.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

Este procedimento armazenado deve ser executado no banco de dados msdb.

Um proxy do SQL Server Agent gerencia a segurança para etapas de trabalho que envolvem subsistemas diferentes do subsistema Transact-SQL. Cada proxy corresponde a uma credencial de segurança. Um proxy pode ter acesso a qualquer número de subsistemas.

Permissões

Somente membros da função de segurança fixa sysadmin podem executar esse procedimento.

Membros da função de segurança fixa sysadmin podem criar etapas de trabalho que usam qualquer proxy. Use o procedimento armazenado sp_grant_login_to_proxy (Transact-SQL) para conceder outro acesso de logon ao proxy.

Exemplos

Este exemplo cria um proxy para a credencial CatalogApplicationCredential. O código supõe que a credencial já exista. Para obter mais informações sobre essas credenciais, consulte 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