Поделиться через

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

  • Статья

Область применения: SQL Server

Добавляет указанный прокси-сервер агент 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 или пустую строку, имя прокси-сервера по умолчанию используется @credential_name или @credential_id.

[ @enabled = ] is_enabled

Указывает, включена ли учетная запись-посредник. Флаг @enabled имеет крошечный цвет с значением по умолчанию 1. Если @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 = ] proxy_id ВЫХОДНЫЕ ДАННЫЕ

Идентификационный номер, присваиваемый учетной записи-посреднику после успешного создания.

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

0 (успешно) или 1 (сбой).

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

Нет.

Замечания

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

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

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

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

Примеры

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

Связанный контент