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

  • Статья

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

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

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

Синтаксис

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

Аргументы

[ @profile_id = ] profile_id

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

[ @parameter_name = ] N'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
  • Output
  • OutputVerboseLevel
  • PacketSize
  • QueryTimeout
  • StartQueueTimeout
  • UsePerArticleContentsView

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

  • HistoryVerboseLevel
  • LoginTimeout
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • ReadBatchSize
  • ReadBatchThreshold

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

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • 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
  • InterruptOnMessagePattern
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDownloadChanges
  • MaxUploadChanges
  • MetadataRetentionCleanup
  • NumDeadlockRetries
  • Output
  • OutputMessageFile
  • OutputVerboseLevel
  • PacketSize
  • ParallelUploadDownload
  • PauseOnMessagePattern
  • PauseTime
  • PollingInterval
  • ProcessMessagesAtPublisher
  • ProcessMessagesAtSubscriber
  • QueryTimeout
  • QueueSizeMultiplier
  • SrcThreads
  • StartQueueTimeout
  • SyncToAlternate
  • UploadGenerationsPerBatch
  • UploadReadChangesPerBatch
  • UploadWriteChangesPerBatch
  • UseInprocLoader
  • Validate
  • ValidateInterval

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

  • HistoryVerboseLevel
  • LoginTimeout
  • Output
  • 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 = ] N'parameter_value'

Новое значение параметра. @parameter_value — nvarchar(255), без значения по умолчанию.

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

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

Замечания

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

Разрешения

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

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