Агент моментальных снимков репликации

Синтаксис

snapshot [ -?] 
-Publisher server_name[\instance_name] 
-Publication publication_name 
[-70Subscribers] 
[-BcpBatchSize bcp_batch_size]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorDeadlockPriority [-1|0|1] ]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1] ]
[-DynamicFilterHostName dynamic_filter_host_name]
[-DynamicFilterLogin dynamic_filter_login]
[-DynamicSnapshotLocation dynamic_snapshot_location] 
[-EncryptionLevel [0|1|2]]
[-FieldDelimiter field_delimiter]
[-HistoryVerboseLevel [0|1|2|3] ]
[-HRBcpBlocks number_of_blocks ]
[-HRBcpBlockSize block_size ]
[-HRBcpDynamicBlocks ]
[-KeepAliveMessageInterval keep_alive_interval]
[-LoginTimeOut login_time_out_seconds]
[-MaxBcpThreads number_of_threads ]
[-MaxNetworkOptimization [0|1]]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2] ]
[-PacketSize packet_size]
[-ProfileName profile_name]
[-PublisherDB publisher_database]
[-PublisherDeadlockPriority [-1|0|1] ]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password] 
[-PublisherSecurityMode [0|1] ]
[-QueryTimeOut query_time_out_seconds]
[-ReplicationType [1|2] ]
[-RowDelimiter row_delimiter]
[-StartQueueTimeout start_queue_timeout_seconds]
[-UsePerArticleContentsView use_per_article_contents_view]

Аргументы

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

• -Publisher имя_сервера[**\имя_экземпляра]
  Имя издателя. Задайте имя сервера для экземпляра Microsoft SQL Server на этом сервере. Укажите имя_сервера\**имя_экземпляра для именованного экземпляра SQL Server на этом сервере.

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

• -70Subscribers
  Указание обязательно в том случае, если существуют подписчики, работающие на платформе SQL Server версии 7.0.

• -BcpBatchSizeразмер_ пакета_ bcp
  Число строк для отправки при операции массового копирования. При выполнении операции bcp in размер пакета равен числу строк для отправки на сервер в одной транзакции, а также числу строк, которые необходимо отправить до того, как агент распространителя зарегистрирует сообщение о ходе выполнения от программы bcp. При выполнении операции bcp out используются пакеты фиксированного размера (1000). Значение 0 указывает на отсутствие регистрации сообщений.

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

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

• -DistributorDeadlockPriority [-1|0|1]
  Приоритет соединения агента моментальных снимков с распространителем при возникновении взаимоблокировки. Этот параметр указывается для разрешения взаимоблокировок, которые могут возникать между агентом моментальных снимков и пользовательскими приложениями при создании моментальных снимков.

  DistributorDeadlockPriority	Описание
  -1	При возникновении взаимоблокировки на распространителе агент моментальных снимков имеет меньший приоритет, чем другие приложения.
  0 (по умолчанию)	Приоритет не назначается.
  1	При возникновении взаимоблокировки на распространителе агент моментальных снимков имеет больший приоритет.

• -DistributorLoginимя_входа_распространителя
  Имя входа, используемое при соединении с распространителем с проверкой подлинности SQL Server.

• -DistributorPasswordпароль_распространителя
  Пароль, используемый при соединении с распространителем с проверкой подлинности SQL Server.

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

• -DynamicFilterHostNameимя_узла_динамического_фильтра
  Используется для указания значения для HOST_NAME (Transact-SQL) при фильтрации, когда создается динамический моментальный снимок. Так, если для какой-либо статьи указано предложение фильтра подмножества rep_id = HOST_NAME() и перед вызовом агента слияния свойство DynamicFilterHostName устанавливается в значение «FBJones», в столбце rep_id будет производиться репликация только тех строк, которые содержат значение «FBJones».

• -DynamicFilterLoginимя_входа_динамического_фильтра
  Указывает значение параметра SUSER_SNAME (Transact-SQL) при фильтрации, когда создается динамический моментальный снимок. Так, если для какой-либо статьи указано предложение фильтра подмножества user_id = SUSER_SNAME() и перед вызовом метода Run объекта SQLSnapshot установить свойство DynamicFilterLogin в значение «rsmith», в моментальный снимок будут включены только те строки, в которых столбец user_id содержит значение «rsmith».

• -DynamicSnapshotLocationразмещение_динамического_моментального_снимка
  Папка, в которой должен быть создан динамический моментальный снимок.

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

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

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

• -FieldDelimiterразделитель_полей
  Символ или последовательность символов, обозначающая конец поля в файле данных массового копирования SQL Server. Значение по умолчанию — \n<x$3>\n.

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

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

• -HRBcpBlocksnumber_of_blocks
  Число блоков данных bcp, составляющих очередь между потоками модуля записи и модуля чтения. Значение по умолчанию — 50. Параметр HRBcpBlocks используется только для публикаций Oracle.

  Примечание
  Этот параметр используется для настройки производительности операции bcp из издателя Oracle.

• -HRBcpBlockSizeblock_size
  Размер каждого блока данных программы bcp (в килобайтах). Значение по умолчанию — 64 КБ. Параметр HRBcpBlocks используется только с публикациями Oracle.

  Примечание
  Этот параметр используется для настройки производительности операции bcp из издателя Oracle.

• -HRBcpDynamicBlocks
  Указывает, возможно ли динамическое увеличение размера блоков данных bcp. Параметр HRBcpBlocks используется только с публикациями Oracle.

  Примечание
  Этот параметр используется для настройки производительности операции bcp из издателя Oracle.

• -KeepAliveMessageIntervalkeep_alive_interval
  Период ожидания в секундах, после которого агент моментальных снимков регистрирует в таблице MSsnapshot_history запись об ожидании сообщения от сервера. Значение по умолчанию равно 300 секундам.

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

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

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

  Примечание
  В сущности, это может оказаться полезным лишь тогда, когда параметр оптимизации синхронизации публикации слиянием имеет значение true (параметр @keep_partition_changes хранимой процедуры sp_addmergepublication (Transact-SQL)).

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

• -OutputVerboseLevel [ 0| 1| 2]
  Указывает, должны ли выводимые данные быть подробными.

  Значение OutputVerboseLevel	Описание
  0	Выводятся только сообщения об ошибках.
  1 (по умолчанию)	Выводятся все сообщения отчета о состоянии (значение по умолчанию).
  2	Выводятся все сообщения об ошибках, а также сообщения отчета о состоянии, что может оказаться при отладке.

• -PacketSizepacket_size
  Размер пакета (в байтах) агента моментальных снимков при соединении с SQL Server. Значение по умолчанию — 8192 байт.

<div class="alert">

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images/Bb677181.alert_note(ru-ru,SQL.105).gif" title="Примечание" alt="Примечание" class="note" /><strong>Примечание</strong></th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Не изменяйте размер пакета, если нет уверенности в том, что это повысит производительность. Для большинства приложений оптимальным является размер пакета, установленный по умолчанию.</p></td>
</tr>
</tbody>
</table>

</div>

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

• -PublisherDBбаза_данных_издателя
  Имя базы данных публикации. Этот параметр не поддерживается для издателей Oracle.

• -PublisherDeadlockPriority [-1|0|1]
  Приоритет соединения агента моментальных снимков с издателем при возникновении взаимоблокировки. Этот параметр указывается для разрешения взаимоблокировок, которые могут возникать между агентом моментальных снимков и пользовательскими приложениями при создании моментальных снимков.

  Значение PublisherDeadlockPriority	Описание
  -1	При возникновении взаимоблокировки на издателе агент моментальных снимков имеет меньший приоритет, чем другие приложения.
  0 (по умолчанию)	Приоритет не назначается.
  1	При возникновении взаимоблокировки на издателе агент моментальных снимков имеет больший приоритет.

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

• -PublisherLoginимя_входа_на_издателе
  Имя входа при соединении с издателем с проверкой подлинности SQL Server.

• -PublisherPasswordпароль_на_издателе
  Пароль, используемый при соединении с издателем с проверкой подлинности SQL Server.

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

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

• -ReplicationType [ 1| 2]
  Указывает тип репликации. Значение 1 указывает на репликацию транзакций, а значение 2 — на репликацию слиянием.

• -RowDelimiterразделитель_строк
  Символ или последовательность символов, обозначающая конец строки в файле данных массового копирования SQL Server. Значение по умолчанию — \n<,@g\>\n.

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

• -UsePerArticleContentsView use_per_article_contents_view
  Этот параметр устарел и поддерживается только для обеспечения обратной совместимости.

Замечания

Важно!

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

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

См. также

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