sp_change_agent_parameter (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Managed Instance

Modifie un paramètre d’un profil d’agent de réplication stocké dans la table système MSagent_parameters . Cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de distribution sur lequel l'agent est en cours d'exécution.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @profile_id = ] profile_id

ID du profil. @profile_id est int, sans valeur par défaut.

[ @parameter_name = ] N’parameter_name'

Nom du paramètre. @parameter_name est sysname, sans valeur par défaut. Pour les profils système, les paramètres modifiables dépendent du type d'Agent. Pour savoir quel type d’agent cette @profile_id représente, recherchez la profile_id colonne dans la Msagent_profiles table et notez la agent_type valeur.

Si un paramètre est pris en charge pour un paramètre donné agent_type, mais qu’il n’est pas défini dans le profil de l’agent, une erreur est retournée. Pour ajouter un paramètre à un profil d’agent, vous devez exécuter sp_add_agent_parameter.

Pour un agent d’instantané (agent_type = 1), s’il est défini dans le profil, les propriétés suivantes peuvent être modifiées :

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

Pour un Agent de lecture du journal (agent_type = 2), s’il est défini dans le profil, les propriétés suivantes peuvent être modifiées :

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

Pour une Agent de distribution (agent_type = 3), si elle est définie dans le profil, les propriétés suivantes peuvent être modifiées :

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

Pour une Agent de fusion (agent_type = 4), si elle est définie dans le profil, les propriétés suivantes peuvent être modifiées :

  • 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

Pour un Agent de lecture de file d’attente (agent_type = 9), s’il est défini dans le profil, les propriétés suivantes peuvent être modifiées :

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

Pour voir quels paramètres sont définis pour un profil donné, exécutez et notez sp_help_agent_profile l’associé profile_name au profile_id. Avec l’exécution appropriée profile_id, exécutez-la sp_help_agent_parameters à l’aide de celle-ci profile_id pour voir les paramètres associés au profil. Les paramètres peuvent être ajoutés à un profil en exécutant sp_add_agent_parameter.

[ @parameter_value = ] N’parameter_value'

Nouvelle valeur du paramètre. @parameter_value est nvarchar(255), sans valeur par défaut.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_change_agent_parameter est utilisé dans tous les types de réplication.

autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_change_agent_parameter

Contenu connexe