sp_add_proxy (Transact-SQL)
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 die @proxy_name eine leere Zeichenfolge ist oder eine leere Zeichenfolge ist NULL
, wird der Name des Proxys standardmäßig auf den angegebenen @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 0
der 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
(erfolgreich) 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 hat möglicherweise Zugriff auf eine beliebige Anzahl von Subsystemen.
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 , 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.
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