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


Replication Queue Reader Agent

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

Агент чтения очереди репликации — это исполняемый файл, который считывает сообщения, хранящиеся в очереди Microsoft SQL Server или очереди сообщений Майкрософт, а затем применяет их к издателю. Агент чтения очереди используется совместно с публикациями транзакций и публикациями моментальных снимков, которые допускают обновление посредством очередей.

Примечание.

Параметры можно указывать в любом порядке. Если необязательные параметры не указаны, используются стандартные значения из профиля агента по умолчанию.

Синтаксис

  
qrdrsvc [-?]  
[-Continuous]  
[-DefinitionFile definition_file]  
[-Distributor server_name[\instance_name]]  
[-DistributionDB distribution_database]  
[-DistributorLogin distributor_login]  
[-DistributorPassword distributor_password]  
[-DistributorSecurityMode [0|1]]  
[-EncryptionLevel [0|1|2]]  
[-HistoryVerboseLevel [0|1|2|3]]  
[-LoginTimeOut login_time_out_seconds]  
[-Output output_path_and_file_name]  
[-OutputVerboseLevel [0|1|2]]  
[-PollingInterval polling_interval]  
[-PublisherFailoverPartner server_name[\instance_name] ]  
[-ProfileName agent_profile_name]  
[-QueryTimeOut query_time_out_seconds]  
[-ResolverState [1|2|3]]  

Аргументы

-?
Отображает сведения об использовании.

-Continuous
Указывает, пытается ли агент обрабатывать находящиеся в очереди транзакции последовательно. Если этот параметр указан, то агент продолжит работу даже в том случае, когда в очереди больше нет незавершенных транзакций, поступивших от какого-либо из подписчиков.

-DefinitionFile путь_и_имя_файла_определения
Путь к файлу определения агента. Файл определения агента содержит параметры командной строки для агента. Содержимое файла анализируется как для исполняемого файла. Для указания значений параметров, содержащих произвольные символы, используются двойные кавычки (").

-Distributor имя_сервера[\имя_экземпляра]
Имя распространителя. Укажите server_name для экземпляра SQL Server по умолчанию на этом сервере. Укажите server_name instance_name\ для именованного экземпляра SQL Server на этом сервере. Если имя не указано, по умолчанию имя экземпляра SQL Server по умолчанию на локальном компьютере.

-DistributionDB база_данных_распространителя
База данных распространителя.

-DistributorLogin имя_входа_распространителя
Имя входа распространителя.

-DistributorPassword пароль_распространителя
Пароль распространителя.

-DistributorSecurityMode [ 0| 1]
Указывает режим безопасности распространителя. Значение 0 указывает режим проверки подлинности SQL Server (по умолчанию), а значение 1 указывает режим проверки подлинности Windows.

-EncryptionLevel [ 0 | 1 | 2 ]
Уровень шифрования по протоколу TLS (ранее — SSL), который используется агентом чтения очереди при установлении соединений.

Значение EncryptionLevel Description
0 Указывает, что TLS не используется.
1 Указывает, что TLS используется, но агент не проверяет, подписан ли сертификат сервера TLS/SSL надежным издателем.
2 Указывает, что TLS используется и сертификат подтвержден.

Примечание.

Допустимый TLS/SSL-сертификат задается с полным доменным именем SQL Server. Если параметр -EncryptionLevel имеет значение 2, то для подключения агента создайте псевдоним на локальном сервере SQL Server. Для параметра Alias Name (Имя псевдонима) должно быть указано имя сервера, а для параметра Server (Сервер) — полное доменное имя SQL Server.

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

-HistoryVerboseLevel [ 0| 1| 2| 3]
Указывает объем данных, регистрируемых в журнале при работе агента чтения очереди. Выбрав значение 1, можно свести к минимуму влияние ведения журнала на производительность.

Значение HistoryVerboseLevel Description
0 Ведение журнала отключено (не рекомендуется).
1 По умолчанию. Всегда обновлять предыдущее сообщение журнала с таким же состоянием (запуск, выполнение, успех и т. д.). Если предыдущих сообщений с таким состоянием нет, то вставить новую запись.
2 Вставлять в журнал новые записи, в том числе сообщения о простоях и долго выполняемых заданиях.
3 Вставлять в журнал новые записи, включая подробные сведения, которые могут оказаться полезными при устранении неполадок.

-LoginTimeOut время_ожидания_входа_в_секундах
Количество секунд до истечения времени ожидания входа. Значение по умолчанию — 15 секунд.

-Output путь_и_имя_выходного_файла
Путь к выходному файлу агента. Если имя файла не указано, данные выводятся на консоль. Если указанный файл существует, то выходные данные добавляются в конец файла.

-OutputVerboseLevel [ 0| 1| 2]
Указывает, должны ли выводимые данные быть подробными. Если уровень подробностей равен 0, выводятся только сообщения об ошибках. Если уровень подробностей равен 1, выводятся все сообщения отчета о состоянии. Если уровень подробностей равен 2 (по умолчанию), выводятся и сообщения об ошибках, и сообщения отчета о состоянии, что удобно для отладки.

-PollingInterval интервал_опроса
Относится только к обновлениям подписок, использующих очереди на основе SQL Server. Указывает частоту опроса очереди SQL Server в секундах для ожидающих транзакций. Значение может находиться в диапазоне от 0 до 240 секунд. Значение по умолчанию — 5 секунд.

-PublisherFailoverPartner имя_сервера[\имя_экземпляра]
Указывает экземпляр партнера по отработке отказа SQL Server, участвующий в сеансе зеркального отображения базы данных с базой данных публикации. Дополнительные сведения см. в статье Зеркальное отображение и репликация баз данных (SQL Server).

-ProfileName имя_профиля_агента
Имя профиля агента, используемого для предоставления агенту набора значений по умолчанию. Дополнительные сведения см. в статье Профили агента репликации.

-QueryTimeOut время_ожидания_запроса_в_секундах
Количество секунд до истечения времени ожидания запроса. Значение по умолчанию — 1800 секунд.

-ResolverState [ 1| 2| 3]
Определяет, каким образом разрешаются конфликты обновления посредством очередей. Значение 1 указывает, что конфликт разрешается в пользу издателя, то есть на издателе и на подписчике будет произведен откат участвующей в конфликте текущей транзакции из очереди, а обработка последующих транзакций из очереди будет продолжена. Значение 2 указывает, что конфликт разрешается в пользу подписчика, то есть транзакция, находящаяся в очереди, переопределяет значения на издателе. Значение 3 указывает, что результатом любого конфликта будет повторная инициализация подписчика, то есть конфликт разрешается в пользу издателя и обработка последующих транзакций из очереди будет прекращена с повторной инициализации подписки. Для публикаций транзакций значение по умолчанию равно 1 , а для публикаций моментальных снимков — 3 .

Замечания

Для запуска агента чтения очереди выполните из командной строки файл qrdrsvc.exe . Дополнительные сведения см. в разделе Исполняемые объекты агента репликации.