sp_add_proxy (Transact-SQL)

Articolo
06/18/2013

Aggiunge il proxy SQL Server Agent specificato.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

[ @proxy_name= ] 'proxy_name'
Nome del proxy da creare. proxy_name è di tipo sysname e il valore predefinito è NULL. Quando proxy_name è NULL o una stringa vuota, il nome del proxy corrisponde per impostazione predefinita al nome specificato in user_name.
[ @enabled = ] is_enabled
Specifica se il proxy è attivato. Il flag is_enabled è di tipo tinyint e il valore predefinito è 1. Quando is_enabled è 0 il proxy non è abilitato e non può essere utilizzato da un passaggio di processo.
[ @description= ] 'description'
Descrizione del proxy. La descrizione è di tipo nvarchar(512) e il valore predefinito è NULL. La descrizione consente di documentare il proxy, ma non viene altrimenti utilizzata da SQL Server Agent. Questo argomento è pertanto facoltativo.
[ @credential_name = ] 'credential_name'
Nome delle credenziali per il proxy. credential_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare l'argomento credential_name o l'argomento credential_id.
[ @credential_id = ] credential_id
Numero di identificazione delle credenziali per il proxy. credential_id è di tipo int e il valore predefinito è NULL. È necessario specificare l'argomento credential_name o l'argomento credential_id.
[ @proxy_id= ] id OUTPUT
Numero di identificazione assegnato al proxy se viene creato correttamente.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

Questa stored procedure deve essere eseguita nel database msdb.

Un proxy di SQL Server Agent gestisce la sicurezza per i passaggi di processo che implicano i sottosistemi diversi da Transact-SQL. Ogni proxy corrisponde a una credenziale di sicurezza. Un proxy può avere accesso a qualsiasi numero di sottosistemi.

Autorizzazioni

Solo i membri del ruolo di sicurezza predefinito sysadmin possono eseguire questa procedura.

I membri del ruolo di sicurezza predefinito sysadmin possono creare passaggi di processi che utilizzano qualsiasi proxy. Utilizzare la stored procedure sp_grant_login_to_proxy (Transact-SQL) per concedere l'accesso al proxy ad altri account di accesso.

Esempi

In questo esempio viene creato un proxy per le credenziali CatalogApplicationCredential. Nel codice si presuppone che le credenziali esistano già. Per ulteriori informazioni sulle credenziali, vedere 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