sp_change_agent_parameter (Transact-SQL)

  • Articolo

Si applica a:SQL Server Istanza gestita di SQL di Azure

Modifica un parametro di un profilo dell'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.

Convenzioni di 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 è int, senza impostazione predefinita.

[ @parameter_name = ] 'parameter_name' Nome del parametro. parameter_name è sysname, senza impostazione predefinita. I parametri che è possibile modificare per i profili sistema dipendono dal tipo di agente. Per scoprire quale tipo di agente rappresenta questo profile_id , individuare la colonna profile_id nella tabella Msagent_profiles e prendere nota del valore agent_type .

Nota

Se un parametro è supportato per un determinato agent_type, ma non è stato definito nel profilo dell'agente, viene restituito un errore. Per aggiungere un parametro a un profilo agente, è necessario eseguire sp_add_agent_parameter.

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

  • 70Subscribers

  • BcpBatchSize

  • HistoryVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • Output

  • OutputVerboseLevel

  • PacketSize

  • Querytimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

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

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Output

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • Querytimeout

  • ReadBatchSize

  • ReadBatchThreshold

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

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • Output

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • Querytimeout

  • QuotedIdentifier

  • Skiperrors

  • TransactionsPerHistory

Per un agente di merge (agent_type=4), se definito nel profilo, è 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

  • Convalida

  • ValidateInterval

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

  • HistoryVerboseLevel

  • LoginTimeout

  • Output

  • OutputVerboseLevel

  • PollingInterval

  • Querytimeout

  • ResolverState

  • SQLQueueMode

Per verificare quali parametri sono stati definiti per un determinato profilo, eseguire sp_help_agent_profile e prendere nota del profile_name associato al profile_id. Con il profile_id appropriato, eseguire quindi sp_help_agent_parameters usando tale profile_id per visualizzare i parametri associati al profilo. I parametri possono essere aggiunti a un profilo eseguendo sp_add_agent_parameter.

[ @parameter_value = ] 'parameter_value' Nuovo valore del parametro. parameter_value è nvarchar(255), senza impostazione predefinita.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

Osservazioni:

sp_change_agent_parameter viene usato in tutti i tipi di replica.

Autorizzazioni

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

Vedi anche

Profili degli agenti di replica
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Agente di lettura coda repliche
Replication Snapshot Agent
sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Stored procedure di sistema (Transact-SQL)