Агент слияния репликации

Синтаксис

replmerg [-?] 
-Publisher server_name[\instance_name]
-PublisherDB publisher_database
-Publication publication
-Subscriber server_name[\instance_name]
-SubscriberDB subscriber_database
[-AltSnapshotFolder alt_snapshot_folder_path]
[-Continuous]
[-DefinitionFile def_path_and_file_name]
[-DestThreads number_of_destination_threads]
[-Distributor server_name[\instance_name]]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1]]
[-DownloadGenerationsPerBatch download_generations_per_batch]
[-DownloadReadChangesPerBatch download_read_changes_per_batch]
[-DownloadWriteChangesPerBatch download_write_changes_per_batch]
[-DynamicSnapshotLocation dynamic_snapshot_location]
[-EncryptionLevel [0|1|2]]
[-ExchangeType [1|2|3]]
[-FastRowCount [0|1]]
[-FileTransferType [0|1]]
[-ForceConvergenceLevel [0|1|2 (Publisher|Subscriber|Both)]]
[-FtpAddress ftp_address]
[-FtpPassword ftp_password]
[-FtpPort ftp_port]
[-FtpUserNameftp_user_name]
[-HistoryVerboseLevel [0|1|2|3]]
[-Hostname host_name]
[-InteractiveResolution [0|1]]
[-InternetLogin internet_login]
[-InternetPassword internet_password]
[-InternetProxyLogin internet_proxy_login]
[–InternetProxyPassword internet_proxy_password]
[-InternetProxyServer internet_proxy_server]
[-InternetSecurityMode [0|1]]
[-InternetTimeout internet_timeout]
[-InternetURL internet_url]
[-KeepAliveMessageInterval keep_alive_message_interval_seconds]
[-LoginTimeOut login_time_out_seconds]
[-MakeGenerationInterval make_generation_interval_seconds]
[-MaxBcpThreads number_of_threads]
[-MaxDownloadChanges number_of_download_changes]
[-MaxUploadChanges number_of_upload_changes]
[-MetadataRetentionCleanup [0|1]]
[-Output]
[-OutputVerboseLevel [0|1|2]]
[-ParallelUploadDownload [0|1]]
[-PacketSize packet_size]
[-PollingInterval polling_interval] 
[-ProfileName profile_name]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password]
[-PublisherSecurityMode [0|1]]
[-QueryTimeOut query_time_out_seconds]
[-SrcThreads number_of_source_threads]
[-StartQueueTimeout start_queue_timeout_seconds]
[-SubscriberConflictClean [0|1]]
[-SubscriberDatabasePath subscriber_path]
[-SubscriberDBAddOption [0|1|2|3]]
[-SubscriberLogin subscriber_login]
[-SubscriberPassword subscriber_password 
[-SubscriberSecurityMode [0|1]]
[-SubscriberType [0|1|2|3|4|5|6|7|8|9]]
[-SubscriptionType [0|1|2]]
[-SyncToAlternate [0|1]
[-UploadGenerationsPerBatch upload_generations_per_batch]
[-UploadReadChangesPerBatch upload_read_changes_per_batch]
[-UploadWriteChangesPerBatch upload_write_changes_per_batch]
[-UseInprocLoader]
[-Validate [0|1|2|3]]
[-ValidateInterval validate_interval]

Аргументы

• -?
  Выводит список всех доступных параметров.

• -Publisherserver_name[**\instance_name]
  Имя издателя. Укажите server_name, чтобы использовать экземпляр сервера Microsoft SQL Server по умолчанию. Укажите server_name\**instance_name, чтобы обратиться к именованному экземпляру SQL Server на этом сервере.

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

• -Publicationpublication
  Имя публикации. Этот параметр допустим только в том случае, если в данной публикации моментальный снимок всегда доступен для новых или повторно инициализированных подписок.

• -Subscriberserver_name[**\instance_name]
  Имя подписчика. Укажите server_name, чтобы использовать экземпляр сервера SQL Server по умолчанию. Укажите server_name\**instance_name, чтобы обратиться к именованному экземпляру SQL Server на этом сервере.

• -SubscriberDBsubscriber_database
  Имя базы данных подписчика.

• -AltSnapshotFolderalt_snapshot_folder_path
  Путь к папке, где хранится исходный моментальный снимок для подписки.

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

• -DestThreadsnumber_of_destination_threads
  Указывает число целевых потоков, которые агент слияния использует для применения изменений к целевому объекту. Целевым объектом при передаче является издатель, а при загрузке — подписчик. Значение по умолчанию равно 4.

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

• -Distributorserver_name[**\instance_name]
  Имя распространителя. Укажите server_name, чтобы использовать экземпляр сервера SQL Server по умолчанию. Укажите server_name\**instance_name, чтобы обратиться к именованному экземпляру SQL Server на этом сервере. При распространении (принудительном) с помощью распространителя по умолчанию используется имя применяемого по умолчанию экземпляра SQL Server на локальном компьютере.

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

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

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

• -DownloadGenerationsPerBatchdownload_generations_per_batch
  Число поколений, которые должны быть обработаны в одном пакете при загрузке изменений от издателя на подписчик. Поколение — это логическая группа изменений для статьи. Для надежного канала связи значение по умолчанию равно 100, для ненадежного — 10.

• -DownloadReadChangesPerBatchdownload_read_changes_per_batch
  Число изменений, которые считываются в одном пакете при загрузке изменений от издателя на подписчик. Значение по умолчанию равно 100.

• -DownloadWriteChangesPerBatchdownload_write_changes_per_batch
  Число изменений, применяемых в одном пакете при загрузке изменений от издателя на подписчик. Значение по умолчанию равно 100.

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

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

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

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

• -ExchangeType [ 1| 2| 3]
  Указывает тип обмена данными во время синхронизации, который может быть одним из следующих значений.

  Значение ExchangeType	Описание
  1	Агент должен передавать изменения данных с подписчика на издатель.
  2	Агент должен загружать изменения данных с издателя на подписчик.
  3 (по умолчанию)	Агент должен сначала передавать изменения данных с подписчика на издатель, а затем загружать изменения данных с издателя на подписчик. Этот параметр следует указывать при выполнении веб-синхронизации.

  Статьи только для загрузки дают возможность управлять поведением синхронизации отдельных статей в публикации и могут способствовать повышению производительности. Дополнительные сведения см. в разделе Оптимизация производительности репликации слиянием при работе со статьями, доступными только для загрузки.

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

• -FileTransferType [0|1]
  Определяет тип передачи файла. 0 означает UNC (формат соглашения об универсальных именах), а 1 означает FTP (протокол передачи файлов).

• -ForceConvergenceLevel [0|1|2 ( Publisher| Subscriber| Both)]
  Указывает уровень конвергенции, которого должен придерживаться агент слияния. Может принимать одно из следующих значений.

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

• -FtpAddressftp_address
  Сетевой адрес службы FTP распространителя. Если этот параметр не указан, то по умолчанию применяется параметр Distributor.

• -FtpPasswordftp_password
  Пароль пользователя, используемый для подключения к службе FTP.

• -FtpPortftp_port
  Номер порта службы FTP распространителя. Если не указан, используется порт службы FTP по умолчанию (21).

• -FtpUserNameftp_user_name
  Имя пользователя для соединения со службой FTP. Если имя не указано, используется имя входа «anonymous».

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

  Значение HistoryVerboseLevel	Описание
  0	Регистрировать последнее сообщение о состоянии агента, подробные сведения о последнем сеансе и любые ошибки.
  1	В каждой записи о состоянии сеанса регистрировать дополнительные сведения о сеансе, в том числе процент выполнения операции, а также последнее сообщение о состоянии агента, подробные сведения о последнем сеансе и любые ошибки.
  2	По умолчанию. Регистрировать в каждой записи о состоянии сеанса как дополнительные сведения о сеансе, так и подробные сведения о сеансе на уровне статьи, в том числе процент выполнения операции, а также последнее сообщение о состоянии агента, подробные сведения о последнем сеансе и любые ошибки. Регистрируются также сообщения о состоянии агентов.
  3	То же, что и -HistoryVerboseLevel = 2, с той лишь разницей, что регистрируется большее число сообщений о работе агентов.

• -Hostnamehost_name
  Сетевое имя локального компьютера. По умолчанию используется имя локального компьютера.

• -InteractiveResolution [0|1]
  Указывает, используется ли интерактивный механизм разрешения конфликтов в тех случаях, когда конфликт происходит в процессе синхронизации. Значение по умолчанию — 0, то есть интерактивный механизм разрешения конфликтов не применяется.

• -InternetLogininternet_login
  Указывает имя входа, используемое при соединении с ISAPI DLL прослушивателя репликации SQL Server, который требует проверки подлинности.

• -InternetPasswordinternet_password
  Указывает пароль, используемый при соединении с ISAPI DLL прослушивателя репликации SQL Server, который требует проверки подлинности.

• -InternetProxyLogin internet_proxy_login
  Указывает имя входа, используемое при соединении с заданным в параметре internet_proxy_server прокси-сервером, который требует проверки подлинности.

• –InternetProxyPassword internet_proxy_password
  Указывает пароль, используемый при соединении с заданным в параметре internet_proxy_server прокси-сервером, который требует проверки подлинности.

• -InternetProxyServer internet_proxy_server
  Указывает прокси-сервер, который должен использоваться при обращении по протоколу HTTP к ресурсу, заданному в параметре internet_url.

• -InternetSecurityMode [0|1]
  Указывает режим безопасности IIS, используемый при соединении с веб-сервером в ходе веб-синхронизации. Значение 0 указывает на обычную проверку подлинности, а значение 1 — на встроенную проверку подлинности Windows (по умолчанию).

• -InternetTimeoutinternet_timeout
  Время в секундах, по истечении которого разрывается соединение с ISAPI DLL прослушивателя репликации SQL Server.

• -InternetURLinternet_url
  Указывает URL-адрес, используемый для подключения к ISAPI DLL прослушивателя репликации SQL Server. Задание этого свойства обязательно.

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

• -LoginTimeOutlogin_time_out_seconds
  Время ожидания входа в секундах. Значение по умолчанию составляет 15 секунд.

• -MakeGenerationIntervalmake_generation_interval_seconds
  Время ожидания (в секундах) между созданием поколений, или пакетов изменений, для загрузки на клиент. Значение по умолчанию составляет 15 секунд.

  Makegeneration — процесс, который подготавливает изменения издателя для загрузки на подписчиков, и он может быть узким местом производительности во время загрузок. Если процесс makegeneration уже выполнялся в интервале, указанном параметром -MakeGenerationInterval, то процесс пропущен в текущем сеансе синхронизации. Это может способствовать параллелизму синхронизации, и особенно полезно, если подписчики не ожидают загрузки изменений.

• -MaxBcpThreadsnumber_of_threads
  Указывает число операций массового копирования, которые можно проводить параллельно. Максимальное число одновременно существующих потоков и соединений ODBC, которое равно меньшему из двух значений: значению параметра MaxBcpThreads или числу запросов на массовое копирование, которое отображается в системной таблице sysmergeschemachange базы данных публикации. Значение MaxBcpThreads должно быть больше 0 и не имеет жестко зафиксированного максимума. Значение по умолчанию — 1.

• -MaxDownloadChangesnumber_of_download_changes
  Указывает максимальное число измененных строк, которые должны загружаться с издателя на подписчик. Число загружаемых строк может быть больше указанного максимума, так как обработаны завершенные поколения, может выполняться несколько параллельных потоков назначения, каждый из которых обрабатывает по крайней мере 100 изменений за первый проход. По умолчанию отправляются все изменения, готовые к загрузке.

• -MaxUploadChangesnumber_of_upload_changes
  Означает максимальное число измененных строк, которые должны быть переданы с подписчика на издатель. Число передаваемых строк может быть больше указанного максимума, так как обработаны завершенные поколения, может выполняться несколько параллельных потоков назначения, каждый из которых обрабатывает по крайней мере 100 изменений за первый проход. По умолчанию отправляются все изменения, готовые к передаче.

• -MetadataRetentionCleanup [0|1]
  Указывает, удаляются ли метаданные из MSmerge_genhistory, MSmerge_contents, MSmerge_tombstone, MSmerge_past_partition_mappings и MSmerge_current_partition_mappings в соответствии со сроком хранения публикации. Значение по умолчанию равно 1, что означает необходимость проведения очистки. Значение 0 указывает на то, что очистка не должна осуществляться автоматически. Дополнительные сведения об очистке метаданных см. в разделе Как работает репликация слиянием.

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

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

• -ParallelUploadDownload [0|1]
  Указывает, должен ли агент слияния параллельно обрабатывать изменения, переданные на издатель, и изменения, загруженные на подписчик. Это может оказаться удобным в средах с большими объемами данных и высокой пропускной способностью сети. Если ParallelUploadDownload имеет значение 1, то включается параллельная обработка.

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

• -PollingIntervalpolling_interval
  Частота (в секундах), с которой издатель или подписчик выполняют запросы об изменении данных. Значение по умолчанию составляет 60 секунд.

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

• -PublisherFailoverPartnerserver_name[**\**instance_name]
  Указывает экземпляр участника отработки отказа служб SQL Server, участвующий в сеансе зеркального отображения базы данных с базой данных публикации. Дополнительные сведения см. в разделе Репликация и зеркальное отображение базы данных.

• -PublisherLoginpublisher_login
  Имя входа издателя. Данный параметр должен быть указан, если значение PublisherSecurityMode равно 0 (при проверке подлинности SQL Server).

• -PublisherPasswordpublisher_password
  Пароль издателя. Данный параметр должен быть указан, если значение PublisherSecurityMode равно 0 (при проверке подлинности SQL Server).

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

• -QueryTimeOutquery_time_out_seconds
  Время ожидания запроса в секундах. Значение по умолчанию составляет 300 секунд. Агент слияния также использует значение параметра QueryTimeout для определения времени ожидания формирования секционированного моментального снимка, когда это значение превышает отметку 1800.

• -SrcThreadsnumber_of_source_threads
  Указывает число потоков на источнике, которые агент слияния использует для перечисления поступивших от него изменений. При передаче источником считается подписчик, а при загрузке — издатель. Значение по умолчанию — 3.

• -StartQueueTimeoutstart_queue_timeout_seconds
  Максимальное время ожидания (в секундах) агента слияния в тех случаях, когда число параллельно выполняемых процессов слияния достигло предельного значения, указываемого свойством @max_concurrent_merge хранимой процедуры sp_addmergepublication. Если по истечении этого времени агент слияния все еще находится в процессе ожидания, то его работа будет завершена. Значение 0 означает, что агент ждет неопределенно долгое время, хотя его выполнение может быть отменено.

• -SubscriberDatabasePathsubscriber_database_path
  Путь к базе данных Jet (MDB-файл) при значении SubscriberType равном 2 (позволяет соединиться с базой данных Jet без указания имени источника данных ODBC (DSN)).

• -SubscriberDBAddOption [0| 1| 2| 3]
  Указывает, имеется ли существующая база данных подписчика.

  Значение SubscriberDBAddOption	Описание
  0	Использовать существующую базу данных (по умолчанию).
  1	Создать новую пустую базу данных подписчика.
  2	Создать новую базу данных и присоединить ее к указанному файлу.
  3	Создать новую базу данных, присоединить ее и включить все подписки, которые могут существовать в этом файле.

  Примечание
  При указании значений 2 и 3 в параметре SubscriberDatabasePath необходимо также задать путь базы данных для подписчика.

• -SubscriberLoginsubscriber_login
  Имя входа подписчика. Данный параметр должен быть указан, если значение SubscriberSecurityMode равно 0 (при проверке подлинности SQL Server Authentication).

• -SubscriberPasswordsubscriber_password
  Пароль подписчика. Данный параметр должен быть указан, если значение SubscriberSecurityMode равно 0 (при проверке подлинности SQL Server Authentication).

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

• -SubscriberConflictClean [ 0| 1]
  Указывает, выполняется ли очистка таблиц конфликтов на подписчике в процессе синхронизации. Значение 1 указывает на то, что таблицы на подписчике подвергаются очистке. Этот параметр используется только для подписок на публикации с децентрализованной регистрацией конфликтов.

• -SubscriberType [ 0| 1| 3| 4| 5| 6| 7| 8]
  Указывает тип соединения с подписчиком, используемый агентом слияния. Для этого параметра поддерживается только одно значение по умолчанию — 0.

• -SubscriptionType[ 0| 1| 2]
  Определяет тип подписки для распространения. Значение 0 указывает принудительную подписку (принимается по умолчанию), значение 1 — подписку по запросу, а значение 2 — анонимную подписку.

• -SyncToAlternate [ 0|1]
  Указывает, осуществляет ли агент слияния процедуру синхронизации между подписчиком и альтернативным издателем. Значение 1 указывает на то, что это альтернативный издатель. Значение по умолчанию — 0.

• -UploadGenerationsPerBatchupload_generations_per_batch
  Число поколений, которые должны обрабатываться в одном пакете при передаче изменений с подписчика на издатель. Поколение — это логическая группа изменений для статьи. Для надежного канала связи значение по умолчанию равно 100, для ненадежного — 1.

• -UploadReadChangesPerBatchupload_read_changes_per_batch
  Число изменений, которые считываются в одном пакете при передаче изменений с подписчика на издатель. Значение по умолчанию — 100.

• -UploadWriteChangesPerBatchupload_write_changes_per_batch
  Число изменений, применяемых в одном пакете при передаче изменений с подписчика на издатель. Значение по умолчанию — 100.

• -UseInprocLoader
  Повышает производительность исходного моментального снимка, предписывая агенту слияния применять его к подписчику командой BULK INSERT. Это устаревший параметр, несовместимый с типом данных XML. Этот параметр может использоваться, если не выполняется репликация XML-данных. Этот параметр нельзя использовать с моментальными снимками в символьном режиме. При использовании этого параметра учетная запись службы SQL Server на подписчике должна иметь разрешение на чтение каталога, в котором находятся BCP-файлы моментальных снимков. Если этот параметр не указан, то загружаемый агентом драйвер ODBC считывает данные из файлов, поэтому контекст безопасности учетной записи службы SQL Server не применяется.

• -Validate [0|1|2|3]
  Указывает, следует ли осуществлять проверку в конце сеанса слияния и, если да, каков ее тип. Рекомендуется указывать значение 3.

  Значение Validate	Описание
  0 (по умолчанию)	Проверка не выполняется.
  1	Проверка только по количеству строк.
  2	Проверка по количеству строк и контрольной сумме.
  3	Проверка достоверности по количеству строк и двоичной контрольной сумме.

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

• -ValidateIntervalvalidate_interval
  Указывает частоту (в минутах) проверки подписки в непрерывном режиме. Значение по умолчанию равно 60 минут.

Замечания

Важно!

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

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

См. также

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