sp_add_proxy (Transact-SQL)

Articolo
12/15/2008

Aggiunge il proxy di SQL Server Agent specificato.

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 è attivato 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.

Set di risultati

Nessuno

Osservazioni

Questa stored procedure deve essere eseguita nel database msdb.

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

Autorizzazioni

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

I membri del ruolo di protezione 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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Creazione di un proxy

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

Vedere anche

Riferimento

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

Guida in linea e informazioni

Assistenza su SQL Server 2005

Condividi tramite