sp_change_agent_parameter (Transact-SQL)

  • Articolo

Modifica un parametro di un profilo di agente di replica archiviato nella tabella di sistema MSagent_parameters. Questa stored procedure viene eseguita in qualsiasi database del server di distribuzione in cui l'agente è in esecuzione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @profile_id=] profile_id,
    ID del profilo. profile_id è di tipo int e non prevede alcun valore predefinito.

  • [ @parameter_name=] 'parameter_name'
    Nome del parametro. parameter_name è di tipo sysname e non prevede alcun valore predefinito. I parametri che è possibile modificare per i profili sistema dipendono dal tipo di agente. Per identificare il tipo di agente rappresentato da profile_id, individuare la colonna profile_id nella tabella Msagent_profiles e prendere nota del valore di agent_type.

    [!NOTA] Se per un determinato agent_type è supportato un parametro non definito nel profilo agente, verrà restituito un errore. Per aggiungere un parametro a un profilo agente, è necessario eseguire sp_add_agent_parameter.

    Se nel profilo è definito un agente snapshot (agent_type=1), è possibile modificare le proprietà seguenti:

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

    Se nel profilo è definito un agente di lettura log (agent_type=2), è possibile modificare le proprietà seguenti:

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

    Se nel profilo è definito un agente di distribuzione (agent_type=3), è possibile modificare le proprietà seguenti:

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

    Se nel profilo è definito un agente di merge (agent_type=4), è possibile modificare le proprietà seguenti:

    • 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

    Se nel profilo è definito un agente di lettura coda (agent_type=9), è possibile modificare le proprietà seguenti:

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

    Per visualizzare i parametri definiti per un profilo determinato, eseguire sp_help_agent_profile e prendere nota del valore profile_name associato a profile_id. Dopo aver individuato il valore profile_id appropriato, utilizzarlo per visualizzare i parametri associati al profilo mediante l'esecuzione di sp_help_agent_parameters. Per aggiungere parametri a un profilo eseguire sp_add_agent_parameter.

  • [ @parameter_value=] 'parameter_value'
    Nuovo valore del parametro. parameter_value è di tipo nvarchar(255) e non prevede alcun valore predefinito.

Osservazioni

sp_change_agent_parameter viene utilizzata in tutti i tipi di replica.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_change_agent_parameter.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Altre risorse

Profili degli agenti di replica
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent

Guida in linea e informazioni

Assistenza su SQL Server 2005