Compartilhar via


sp_add_proxy (Transact-SQL)

Aplica-se: SQL Server

Adiciona o proxy especificado do SQL Server Agent.

Convenções de sintaxe de 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 @credential_name ou @credential_id fornecido.

@enabled [ = ] is_enabled

Especifica se o proxy está habilitado. O sinalizador @enabled é tinyint, com um padrão de 1. Quando @enabled é 0, o proxy não está habilitado e não pode ser usado por uma etapa de trabalho.

@description [ = ] 'descrição'

Uma descrição do proxy. A descrição é nvarchar(512), com um padrão de NULL. A descrição permite que você documente o proxy, mas não é usada de outra forma pelo SQL Server Agent. 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. Deve ser especificado @credential_name ou @credential_id .

@credential_id [ = ] credential_id

O número de identificação da credencial para o proxy. O @credential_id é int, com um padrão de NULL. Deve ser especificado @credential_name ou @credential_id .

@proxy_id [ = ] proxy_id SAÍDA

O número de identificação de proxy atribuído ao proxy se for criado com êxito.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

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

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

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Os membros do direito de acesso fixo sysadmin podem criar etapas de trabalho que usam qualquer proxy. Use o procedimento armazenado sp_grant_login_to_proxy para conceder a outros logons acesso 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 credenciais, consulte CREATE CREDENTIAL.

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