sp_add_proxy (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Aggiunge il proxy di SQL Server Agent specificato.

Convenzioni di 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. Il @proxy_name è sysname, con un valore predefinito .NULL Quando il @proxy_name è NULL o una stringa vuota, il nome del proxy viene impostato per impostazione predefinita sul @credential_name o @credential_id fornito.

[ @enabled = ] is_enabled

Specifica se il proxy è attivato. Il flag @enabled è tinyint, con un valore predefinito .1 Quando @enabled è , il proxy non è 0abilitato e non può essere usato da un passaggio del processo.

[ @description = ] 'description'

Descrizione del proxy. La descrizione è nvarchar(512), con un valore predefinito .NULL La descrizione consente di documentare il proxy, ma non viene usato in altro modo da SQL Server Agent. Questo argomento è pertanto facoltativo.

[ @credential_name = ] 'credential_name'

Nome delle credenziali per il proxy. Il @credential_name è sysname, con un valore predefinito .NULL È necessario specificare @credential_name o @credential_id .

[ @credential_id = ] credential_id

Numero di identificazione delle credenziali per il proxy. Il @credential_id è int, con un valore predefinito .NULL È necessario specificare @credential_name o @credential_id .

[ @proxy_id = ] proxy_id OUTPUT

Numero di identificazione assegnato al proxy se viene creato correttamente.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

Questa stored procedure deve essere eseguita nel msdb database.

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

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

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

Esempi

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

Contenuto correlato