Condividi tramite

  • Articolo

sp_change_agent_parameter (Transact-SQL)

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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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.