Хранимая процедура sp_add_proxy (Transact-SQL)

Статья
06/18/2013

Добавляет указанную учетную запись-посредник агента SQL Server.

Значок ссылки на раздел Синтаксические обозначения Transact-SQL

Синтаксис

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

Аргументы

[ @proxy_name= ] 'proxy_name'
Имя создаваемой учетной записи-посредника. Аргумент proxy_name имеет тип sysname и значение NULL по умолчанию. Если аргумент proxy_name имеет значение NULL или является пустой строкой, имени учетной записи-посреднику по умолчанию присваивается значение user_name.
[ @enabled = ] is_enabled
Указывает, включена ли учетная запись-посредник. Флаг is_enabled имеет тип tinyint и значение по умолчанию 1. Если аргумент is_enabled принимает значение 0, учетная запись-посредник не разрешена и использоваться шагом задания не может.
[ @description= ] 'description'
Описание учетной записи-посредника. Описание имеет тип nvarchar(512) и значение NULL по умолчанию. Описание позволяет документировать учетную запись-посредника, но оно не используется агентом SQL Server для других целей. Поэтому этот аргумент необязателен.
[ @credential_name = ] 'credential_name'
Имя учетных данных учетной записи-посредника. Аргумент credential_name имеет тип sysname и значение NULL по умолчанию. Необходимо указать либо аргумент credential_name, либо credential_id.
[ @credential_id = ] credential_id
Идентификационный номер учетных данных учетной записи-посредника. Аргумент credential_id имеет тип int и значение NULL по умолчанию. Необходимо указать либо аргумент credential_name, либо credential_id.
[ @proxy_id= ] id OUTPUT
Идентификационный номер, присваиваемый учетной записи-посреднику после успешного создания.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет.

Замечания

Эту хранимую процедуру следует запускать в базе данных msdb.

Учетная запись-посредник агента SQL Server управляет безопасностью шагов задания, в которых задействованы подсистемы, отличные от подсистемы языка Transact-SQL. Каждой учетной записи-посреднику соответствует учетная запись системы безопасности. Учетная запись-посредник может иметь доступ к любому числу подсистем.

Разрешения

Только члены предопределенной роли сервера sysadmin могут запустить эту процедуру.

Члены предопределенной роли сервера sysadmin могут создавать шаги задания, использующие любую учетную запись-посредник. Для предоставления другим именам входа доступа к учетной записи-посреднику используется хранимая процедура sp_grant_login_to_proxy (Transact-SQL).

Примеры

В этом примере создается учетная запись-посредник для учетных данных CatalogApplicationCredential. Предполагается, что эти учетные данные уже существуют. Дополнительные сведения об учетных данных см. в разделе 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