Хранимая процедура 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)
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по