Share via

  • Статья

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

Добавляет указанную учетную запись-посредник агента 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