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

Хранимая процедура 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. Каждой учетной записи-посреднику соответствует учетная запись системы безопасности. Прокси-сервер может иметь доступ к любому количеству подсистем.

Разрешения

Вы можете предоставить 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

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