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


sp_addqreader_agent (Transact-SQL)

Добавляет агент чтения очереди для указанного распространителя. Эта хранимая процедура выполняется на распространителе в базе данных распространителя или на издателе в базе данных публикаций.

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

Синтаксис

sp_addqreader_agent [ @job_login = ] 'job_login'
        , [ @job_password = ] 'job_password'
    [ , [ @job_name = ] 'job_name'
    [ , [ @frompublisher = ] frompublisher 

Аргументы

  • [ @job_login= ] 'job_login'
    Имя входа учетной записи Microsoft Windows, под которым выполняется агент. Аргумент job_login имеет тип nvarchar(257) и значение по умолчанию. Для соединения агента с распространителем всегда используется эта учетная запись Windows.

  • [ @job_password= ] 'job_password'
    Пароль для учетной записи Windows, с которой запускается агент. Аргумент job_password имеет тип sysname и не имеет значения по умолчанию.

    Примечание по безопасностиПримечание по безопасности

    Не храните данные проверки подлинности в файлах сценариев. Для обеспечения лучшей защиты имена входа и пароли должны вводиться в ходе выполнения.

  • [ @job_name= ] 'job_name'
    Имя существующего задания агента. Аргумент job_name имеет тип sysname и значение по умолчанию NULL. Этот аргумент указывается, только если агент создается с использованием существующего, а не вновь созданного задания (выбор по умолчанию).

  • [ @frompublisher= ] frompublisher
    Указывает, выполняется ли процедура на сервере издателя. Аргумент frompublisher представляет собой бит, его значение по умолчанию равно 0. Значение 1 соответствует тому, что процедура выполняется из издателя в базе данных публикации.

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

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

Замечания

Процедура sp_addqreader_agent используется в репликации транзакциями.

Необходимо выполнить хранимую процедуру sp_addqreader_agent хотя бы один раз на сервере распространителя, который поддерживает обновления посредством очередей, после процедуры sp_adddistributiondb, но до процедуры sp_addpublication.

Задание агента чтения очереди удаляется при выполнении хранимой процедуры sp_dropdistributiondb.

Разрешения

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