Хранимая процедура sp_change_agent_parameter (Transact-SQL)

  • Статья

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

  
sp_change_agent_parameter [ @profile_id= ] profile_id, [ @parameter_name= ] 'parameter_name', [ @parameter_value= ] 'parameter_value'

Аргументы

[ @profile_id = ] profile_id, Идентификатор профиля. profile_id не используется без значения по умолчанию.

[ @parameter_name = ] 'parameter_name' Имя параметра. parameter_name — sysname без значения по умолчанию. Для системных профилей параметры, которые могут быть изменены, зависят от типа агента. Чтобы узнать, какой тип агента представляет этот profile_id, найдите столбец profile_id в таблице Msagent_profiles и запишите значение agent_type.

Примечание.

Если параметр поддерживается для заданного agent_type, но не определен в профиле агента, возвращается ошибка. Чтобы добавить параметр в профиль агента, необходимо выполнить sp_add_agent_parameter.

При определении в профиле агент моментальных снимков (agent_type=1) можно изменить следующие свойства:

  • 70Subscribers

  • BcpBatchSize

  • HistoryVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • Выходные данные

  • OutputVerboseLevel

  • PacketSize

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

Для агента чтения журналов (agent_type=2), если он определен в профиле, можно изменить следующие свойства:

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Выходные данные

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

При определении в профиле агент распространения (agent_type=3) можно изменить следующие свойства:

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • Выходные данные

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • QuotedIdentifier

  • SkipErrors

  • TransactionsPerHistory

Для агент слияния (agent_type=4) при определении в профиле можно изменить следующие свойства:

  • AltSnapshotFolder

  • BcpBatchSize

  • ChangesPerHistory

  • DestThreads

  • DownloadGenerationsPerBatch

  • DownloadReadChangesPerBatch

  • DownloadWriteChangesPerBatch

  • DynamicSnapshotLocation

  • ExchangeType

  • FastRowCount

  • FileTransferType

  • GenerationChangeThreshold

  • HistoryVerboseLevel

  • InputMessageFile

  • InteractiveResolution

  • ПрерываниеOnMessagePattern

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDownloadChanges

  • MaxUploadChanges

  • MetadataRetentionCleanup

  • NumDeadlockRetries

  • Выходные данные

  • OutputMessageFile

  • OutputVerboseLevel

  • PacketSize

  • ParallelUploadDownload

  • PauseOnMessagePattern

  • PauseTime

  • PollingInterval

  • ProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriber

  • QueryTimeout

  • QueueSizeMultiplier

  • SrcThreads

  • StartQueueTimeout

  • SyncToAlternate

  • UploadGenerationsPerBatch

  • UploadReadChangesPerBatch

  • UploadWriteChangesPerBatch

  • UseInprocLoader

  • Проверка

  • ValidateInterval

Для агента чтения очередей (agent_type=9), если он определен в профиле, можно изменить следующие свойства:

  • HistoryVerboseLevel

  • LoginTimeout

  • Выходные данные

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

Чтобы узнать, какие параметры определены для данного профиля, запустите sp_help_agent_profile и запишите profile_name , связанные с profile_id. При наличии соответствующего profile_id выполните следующий запуск sp_help_agent_parameters с помощью этого profile_id, чтобы просмотреть параметры, связанные с профилем. Параметры можно добавить в профиль, выполнив sp_add_agent_parameter.

[ @parameter_value = ] 'parameter_value' Является новым значением параметра. parameter_value — nvarchar(255), без значения по умолчанию.

Значения кода возврата

0 (успешно) или 1 (сбой)

Замечания

sp_change_agent_parameter используется во всех типах реплика tion.

Разрешения

Только члены предопределенных ролей сервера sysadmin могут выполняться sp_change_agent_parameter.

См. также

Профили агента репликации
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent
sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)