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


sp_addqreader_agent (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @job_login = ] N'job_login'

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

[ @job_password = ] N'job_password'

Пароль для учетной записи Windows, в которой выполняется агент. @job_password — sysname, без значения по умолчанию.

Внимание

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

[ @job_name = ] N'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.

Разрешения

Могут выполняться sp_addqreader_agentтолько члены предопределенных ролей сервера sysadmin.