sp_add_proxy (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Fügt den angegebenen SQL Server-Agent Proxy hinzu.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @proxy_name = ] 'proxy_name'

Der Name des zu erstellenden Proxys. Die @proxy_name ist "sysname" mit der Standardeinstellung "NULL. Wenn der @proxy_name NULL oder eine leere Zeichenfolge ist, wird der Name des Proxys standardmäßig auf den bereitgestellten @credential_name oder @credential_id festgelegt.

[ @enabled = ] is_enabled

Gibt an, ob der Proxy aktiviert ist. Das @enabled Flag ist winzig, mit einem Standardwert von 1 . Wenn @enabled ist, ist 0der Proxy nicht aktiviert und kann nicht von einem Auftragsschritt verwendet werden.

[ @description = ] 'description'

Eine Beschreibung des Proxys. Die Beschreibung ist nvarchar(512), mit einem Standardwert von NULL. Die Beschreibung ermöglicht es Ihnen, den Proxy zu dokumentieren, wird jedoch nicht anderweitig von SQL Server-Agent verwendet. Daher ist dieses Argument optional.

[ @credential_name = ] 'credential_name'

Der Name der Anmeldeinformationen für den Proxy. Die @credential_name ist "sysname" mit einem Standardwert von NULL. Entweder @credential_name oder @credential_id müssen angegeben werden.

[ @credential_id = ] credential_id

Die ID der Anmeldeinformationen für den Proxy. Die @credential_id ist int mit einem Standardwert von NULL. Entweder @credential_name oder @credential_id müssen angegeben werden.

[ @proxy_id = ] proxy_id OUTPUT

Die Proxy-ID, die dem Proxy bei erfolgreicher Erstellung zugewiesen wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

Diese gespeicherte Prozedur muss in der msdb Datenbank ausgeführt werden.

Ein SQL Server-Agent Proxy verwaltet die Sicherheit für Auftragsschritte, die andere Subsysteme als das Transact-SQL-Subsystem umfassen. Jeder Proxy entspricht einem Satz Sicherheitsanmeldeinformationen. Ein Proxy kann über Zugriff auf eine beliebige Anzahl von Subsystemen verfügen.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Mitglieder der festen Sicherheitsrolle "sysadmin " können Auftragsschritte erstellen, die einen beliebigen Proxy verwenden. Verwenden Sie die gespeicherte Prozedur sp_grant_login_to_proxy (Transact-SQL), um anderen Anmeldeinformationen Zugriff auf den Proxy zu gewähren.

Beispiele

In diesem Beispiel wird ein Proxy für die Anmeldeinformationen CatalogApplicationCredential erstellt. Es wird im Code vorausgesetzt, dass die Anmeldeinformationen bereits vorhanden sind. Weitere Informationen zu Anmeldeinformationen finden Sie unter CREATE CREDENTIAL (Transact-SQL).For more information about credentials, see 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

Zugehöriger Inhalt