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 имеет тип «bit» и значение по умолчанию 0. Значение 1 соответствует тому, что процедура выполняется из издателя в базе данных публикации.

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

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

Замечания

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

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

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

Разрешения

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

См. также

Задания

обновить скрипты репликации (программирование репликации на языке Transact-SQL)

Справочник

sp_changeqreader_agent (Transact-SQL)

sp_helpqreader_agent (Transact-SQL)

Основные понятия

Обновляемые подписки для репликации транзакций