sys.sp_change_agent_parameter (Transact-SQL)

Platí na:SQL ServerAzureSQL Managed Instance

Mění parametr profilu replikačního agenta uloženého v tabulce MSagent_parameters systému. Tato uložená procedura se vykonává na distributoru, kde agent běží, v jakékoli databázi.

Transact-SQL konvence syntaxe

Syntax

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

Arguments

[ @profile_id = ] profile_id

ID profilu. @profile_id je inteligence, bez výchozího nastavení.

[ @parameter_name = ] N'parameter_name'

Název parametru @parameter_name je sysname, bez výchozího nastavení. U systémových profilů závisí parametry podle typu agentu. Chcete-li zjistit, jaký typ agenta tento @profile_id představuje, najděte profile_id sloupec v tabulce Msagent_profiles a poznamenejte hodnotu agent_type .

Pokud je parametr podporován pro dané agent_type, ale není definován v agentním profilu, vrací se chyba. Pro přidání parametru do profilu agenta musíte spustit sp_add_agent_parameter.

Pro Snapshot Agent (agent_type = 1), pokud je definován v profilu, lze změnit následující vlastnosti:

  • 70Subscribers
  • BcpBatchSize
  • HistoryVerboseLevel
  • LoginTimeout
  • MaxBcpThreads
  • MaxNetworkOptimization
  • Output
  • OutputVerboseLevel
  • PacketSize
  • QueryTimeout
  • StartQueueTimeout
  • UsePerArticleContentsView

Pro Log Reader Agenta (agent_type = 2), pokud je definován v profilu, lze změnit následující vlastnosti:

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

Pro Distribution Agent (agent_type = 3), pokud je definován v profilu, lze změnit následující vlastnosti:

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • QuotedIdentifier
  • SkipErrors
  • TransactionsPerHistory

Pro Merge Agent (agent_type = 4), pokud je definován v profilu, lze změnit následující vlastnosti:

  • 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

Pro agenta Queue Reader (agent_type = 9), pokud je definován v profilu, lze změnit následující vlastnosti:

  • HistoryVerboseLevel
  • LoginTimeout
  • Output
  • OutputVerboseLevel
  • PollingInterval
  • QueryTimeout
  • ResolverState
  • SQLQueueMode

Chcete-li vidět, jaké parametry jsou definovány pro daný profil, spusťte sp_help_agent_profile a všimněte si přiřazených profile_name s .profile_id S příslušným profile_id, příště spusť sp_help_agent_parameters tento profil pro profile_id zobrazení parametrů spojených s profilem. Parametry lze do profilu přidávat vykonáním sp_add_agent_parameter.

[ @parameter_value = ] N'parameter_value'

Nová hodnota parametru. @parameter_value je nvarchar(255), bez výchozího nastavení.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Remarks

sp_change_agent_parameter se používá ve všech typech replikace.

Permissions

Spustit můžou pouze členové pevné role serveru sp_change_agent_parameter .