Replication Log Reader Agent

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

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

Синтаксис

logread [ -? ]
-Publisher server_name [ \instance_name ]
-PublisherDB publisher_database
[ -Continuous ]
[ -DefinitionFile def_path_and_file_name ]
[ -Distributor server_name[ \instance_name ] ]
[ -DistributorLogin distributor_login ]
[ -DistributorPassword distributor_password ]
[ -DistributorSecurityMode [ 0 | 1 ] ]
[ -EncryptionLevel [ 0 | 1 | 2 ] ]
[ -ExtendedEventConfigFile configuration_path_and_file_name ]
[ -HistoryVerboseLevel [ 0 | 1 | 2 ] ]
[ -KeepAliveMessageInterval keep_alive_message_interval_seconds ]
[ -LoginTimeOut login_time_out_seconds ]
[ -LogScanThreshold scan_threshold ]
[ -MaxCmdsInTran number_of_commands ]
[ -MessageInterval message_interval ]
[ -MultiSubnetFailover [ 0 | 1 ] ]
[ -Output output_path_and_file_name ]
[ -OutputVerboseLevel [ 0 | 1 | 2 | 3 | 4 ] ]
[ -PacketSize packet_size ]
[ -PollingInterval polling_interval ]
[ -ProfileName profile_name ]
[ -PublisherFailoverPartner server_name[ \instance_name ] ]
[ -PublisherSecurityMode [ 0 | 1 ] ]
[ -PublisherLogin publisher_login ]
[ -PublisherPassword publisher_password ]
[ -QueryTimeOut query_time_out_seconds ]
[ -ReadBatchSize number_of_transactions ]
[ -ReadBatchThreshold read_batch_threshold ]
[ -RecoverFromDataErrors ]

Аргументы

-?

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

-Publisher server_name [ \instance_name ]

Имя издателя. Укажите <server_name> для экземпляра SQL Server по умолчанию на этом сервере. Укажите <server_name>\<instance_name> именованный экземпляр SQL Server на этом сервере.

-PublisherDB publisher_database

Имя базы данных издателя.

-Continuous

Указывает, производит ли агент непрерывный опрос транзакций для репликации. Если да, то он с заданным интервалом производит запрос из источника транзакций, даже если транзакции отсутствуют.

-DefinitionFile def_path_and_file_name

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

-Распространитель server_name [ \instance_name ]

Имя распространителя. Укажите <server_name> для экземпляра SQL Server по умолчанию на этом сервере. Укажите <server_name>\<instance_name> именованный экземпляр SQL Server на этом сервере.

-DistributorLogin distributor_login

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

-DistributorPassword distributor_password

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

-DistributorSecurityMode [ 0 | 1 ]

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

-EncryptionLevel [ 0 | 1 | 2 ]

Уровень безопасности транспортного уровня (TLS), ранее известный как протокол SSL, шифрование, используемое агентом чтения журналов при подключении.

Дополнительные сведения см. в статье View and Modify Replication Security Settings.

-ExtendedEventConfigFile configuration_path_and_file_name

Задает путь и имя файла для XML-файла конфигурации расширенных событий. Файл конфигурации расширенных событий позволяет настраивать сеансы и включать события для трассировки. Только для внутреннего применения.

-HistoryVerboseLevel [ 0 | 1 | 2 ]

Указывает объем данных, заносимых в журнал во время операции чтения журнала. Вы можете свести к минимуму влияние журнала журнала, выбрав 1.

-KeepAliveMessageInterval keep_alive_message_interval_seconds

Количество секунд до того, как поток журнала проверяет, ожидает ли какой-либо из существующих подключений ответ от сервера. Это значение можно уменьшить, чтобы агент проверки не помечал агент чтения журнала как подозрительный при выполнении долго выполняющегося пакета. Значение по умолчанию — 300 секунд.

-LoginTimeOut login_time_out_seconds

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

-LogScanThreshold scan_threshold

Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

-MaxCmdsInTran number_of_commands

Задает максимальное количество инструкций, группируемых в транзакцию, когда агент чтения журнала записывает команды в базу данных распространителя. Использование этого параметра позволяет агенту чтения журнала и агенту распространителя разделять большие транзакции (состоящие из множества команд) на издателе на несколько меньших транзакций при применении команд на подписчике. Задание этого параметра может снизить вероятность состязаний на распространителе и уменьшить задержку при передаче данных между издателем и подписчиком. Так как исходная транзакция применяется в небольших единицах, подписчик может получить доступ к строкам большой логической транзакции издателя до конца исходной транзакции, нарушая строгую атомарность транзакций. Значением по умолчанию является 0сохранение границ транзакций издателя.

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

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

-MessageInterval message_interval

Интервал времени, используемый для ведения журнала. Событие журнала регистрируется при MessageInterval достижении значения после последнего события журнала.

Если в источнике реплицированная транзакция отсутствует, агент сообщает о отсутствии транзакций распространителю. Данный параметр определяет период ожидания агента до передачи следующего сообщения об отсутствии транзакции. Агенты всегда передают сообщение об отсутствии транзакции, если на источнике после ранее обработанных реплицируемых транзакций не обнаруживается доступных транзакций. Значение по умолчанию ― 60 секунд.

-MultiSubnetFailover [ 0 | 1 ]

Область применения: SQL Server 2019 (15.x) и более поздних версий.

Указывает, включено ли свойство MultiSubnetFailover. Если приложение подключается к группе доступности AlwaysOn в разных подсетях, установка MultiSubnetFailover на 1 (true) обеспечивает быстрое обнаружение и подключение к активному серверу (в настоящее время).

При настройке публикации транзакций в группе доступности агент чтения журналов создает динамический связанный сервер для прослушивателя, чтобы проверить метаданные. В SQL Server 2022 (16.x) CU 10 и более поздних версий существует изменение конфигурации динамического связанного сервера. Дополнительные сведения см. в KB5031778.

-Output output_path_and_file_name

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

-OutputVerboseLevel [ 0 | 1 | 2 | 3 | 4 ]

Указывает, должны ли выводимые данные быть подробными.

Значения 2-4 могут оказаться полезными при отладке.

-PacketSize packet_size

Размер пакета в байтах. Значение по умолчанию равно 4 096 байт.

-PollingInterval polling_interval

Как часто в секундах журнал запрашивается для реплицированных транзакций. Значение по умолчанию — 5 секунд.

-ProfileName profile_name

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

-PublisherFailoverPartner server_name [ \instance_name ]

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

-PublisherSecurityMode [ 0 | 1 ]

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

-PublisherLogin publisher_login

Имя входа издателя.

-PublisherPassword publisher_password

Пароль издателя.

-QueryTimeOut query_time_out_seconds

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

-ReadBatchSize number_of_transactions

Максимальное количество транзакций, считываемых из журнала транзакций базы данных публикации на цикл обработки, с значением по умолчанию 500 и максимальным значением 10000. Агент продолжает считывать транзакции в пакетах, пока все транзакции не будут считываться из журнала. Этот параметр не поддерживается для издателей Oracle.

-ReadBatchThreshold number_of_commands

Количество команд репликации, считываемых из журнала транзакций перед выдачой подписчику агент распространения. По умолчанию установлено значение 0. Если этот параметр не указан, агент чтения журналов считывает в конец журнала или номер, указанный в -ReadBatchSize (число транзакций).

-RecoverFromDataErrors

Указывает, что агент чтения журнала должен продолжить работу после возникновения ошибок данных в столбце, опубликованном издателем, отличным от SQL Server. По умолчанию такие ошибки приводят к завершению работы агента чтения журнала. При использовании -RecoverFromDataErrorsошибочные данные столбца реплицируются как NULL или соответствующее значение, отличное от NULL, и предупреждения регистрируются в таблицу MSlogreader_history . Этот параметр поддерживается только для издателей Oracle.

Замечания

Если вы установили агент SQL Server для запуска под локальной системной учетной записью вместо учетной записи пользователя домена (по умолчанию), служба может получить доступ только к локальному компьютеру. Если агент чтения журналов, работающий в агент SQL Server, настроен для использования режима проверки подлинности Windows при входе в SQL Server, агент чтения журналов завершается сбоем. По умолчанию используется проверка подлинности SQL Server. Дополнительные сведения об изменении учетных записей безопасности см. в разделе View and Modify Replication Security Settings.

Чтобы запустить агент чтения журналов, выполните команду logread.exe из командной строки. Дополнительные сведения см. в статье Основные понятия исполняемых файлов агента репликации.

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

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