Partager via


sp_change_agent_parameter (Transact-SQL)

Modifie un paramètre d'un profil de l'Agent de réplication enregistré 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.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @profile_id=] profile_id,
    Identificateur du profil. L'argument profile_id est de type int, sans valeur par défaut.

  • [ @parameter_name=] 'parameter_name'
    Nom du paramètre. L'argument parameter_name est de type sysname et n'a pas de valeur par défaut. Pour les profils système, les paramètres modifiables dépendent du type d'Agent. Pour déterminer le type d'Agent représenté par profile_id, recherchez la colonne profile_id dans la table Msagent_profiles et notez la valeur de agent_type.

    [!REMARQUE]

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

    Pour un Agent de capture instantanée (agent_type=1), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

    • 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, vous pouvez modifier les propriétés suivantes :

    • HistoryVerboseLevel

    • LoginTimeout

    • MessageInterval

    • Output

    • OutputVerboseLevel

    • PacketSize

    • PollingInterval

    • QueryTimeout

    • ReadBatchSize

    • ReadBatchThreshold

    Pour un Agent de distribution (agent_type=3), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

    • BcpBatchSize

    • CommitBatchSize

    • CommitBatchThreshold

    • FileTransferType

    • HistoryVerboseLevel

    • KeepAliveMessageInterval

    • LoginTimeout

    • MaxBcpThreads

    • MaxDeliveredTransactions

    • MessageInterval

    • Output

    • OutputVerboseLevel

    • PacketSize

    • PollingInterval

    • QueryTimeout

    • QuotedIdentifier

    • SkipErrors

    • TransactionsPerHistory

    Pour un Agent de fusion (agent_type=4), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

    • 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 la file d'attente (agent_type=9), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

    • HistoryVerboseLevel

    • LoginTimeout

    • Output

    • OutputVerboseLevel

    • PollingInterval

    • QueryTimeout

    • ResolverState

    • SQLQueueMode

    Pour afficher les paramètres définis pour un profil donné, exécutez sp_help_agent_profile et notez la valeur de profile_name associée à celle de profile_id. À l'aide de la valeur de profile_id appropriée, exécutez ensuite sp_help_agent_parameters en utilisant cette valeur de profile_id pour afficher les paramètres associés au profil. Vous ajoutez des paramètres au profil en exécutant sp_add_agent_parameter.

  • [ @parameter_value=] 'parameter_value'
    Nouvelle valeur du paramètre. parameter_value est de type nvarchar(255), sans valeur par défaut.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Notes

La procédure sp_change_agent_parameter est utilisée dans tous les types de réplications.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter la procédure sp_change_agent_parameter.