Агент чтения очереди репликации

Область применения: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пароль_распространителя
Пароль распространителя.

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

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

EncryptionLevel ценность	Description
0	Указывает, что TLS не используется.
1	Указывает, что TLS используется, но агент не проверяет, подписан ли сертификат сервера TLS/SSL надежным издателем.
2	Указывает, что TLS используется и сертификат подтвержден.
3	Не поддерживается, так как параметр 3 предназначен для подключений к Управляемому экземпляру SQL Azure, а агент чтения очередей не поддерживается с управляемым экземпляром SQL Azure.
4	Указывает, что для подключений из SQL Server 2025 и более поздних версий к SQL Server (любая поддерживаемая версия), используется TLS 1.3 и проверяется сертификат. Требуется установить сертификат на узлах SQL Server, получающих подключения с заданным EncryptionLevel значением 4.

Примечание.

Для топологий репликации с удаленным распространителем:

• Сбой компонентов репликации после обновления до SQL Server 2025 для экземпляров с удаленным распространителем
• Сбой добавления удаленного распространителя в издатель SQL Server 2025

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

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

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

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

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

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

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

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

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

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

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

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

Замечания

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

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

• Администрирование агента репликации