Bagikan melalui

sp_change_agent_parameter (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengubah parameter profil agen replikasi yang disimpan dalam tabel sistem MSagent_parameters . Prosedur tersimpan ini dijalankan di Distributor tempat agen berjalan, pada database apa pun.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @profile_id = ] profile_id, Adalah ID profil. profile_id int, tanpa default.

[ @parameter_name = ] 'parameter_name' Adalah nama parameter. parameter_name adalah sysname, tanpa default. Untuk profil sistem, parameter yang dapat diubah bergantung pada jenis agen. Untuk mengetahui jenis agen apa yang diwakili profile_id ini, temukan kolom profile_id dalam tabel Msagent_profiles, dan catat nilai agent_type.

Catatan

Jika parameter didukung untuk agent_type tertentu, tetapi belum ditentukan di profil agen, kesalahan akan ditampilkan. Untuk menambahkan parameter ke profil agen, Anda harus menjalankan sp_add_agent_parameter.

Untuk Agen Rekam Jepret (agent_type=1), jika ditentukan dalam profil, properti berikut dapat diubah:

  • 70Subscriber

  • BcpBatchSize

  • HistoryVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • Hasil

  • OutputVerboseLevel

  • Ukuran Paket

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

Untuk Agen Pembaca Log (agent_type=2), jika ditentukan dalam profil, properti berikut dapat diubah:

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Hasil

  • OutputVerboseLevel

  • Ukuran Paket

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

Untuk Agen Distribusi (agent_type=3), jika ditentukan dalam profil, properti berikut dapat diubah:

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • Hasil

  • OutputVerboseLevel

  • Ukuran Paket

  • PollingInterval

  • QueryTimeout

  • QuotedIdentifier

  • SkipErrors

  • TransactionsPerHistory

Untuk Agen Penggabungan (agent_type=4), jika ditentukan dalam profil, properti berikut ini dapat diubah:

  • AltSnapshotFolder

  • BcpBatchSize

  • ChangesPerHistory

  • DestThreads

  • DownloadGenerationsPerBatch

  • UnduhReadChangesPerBatch

  • UnduhWriteChangesPerBatch

  • DynamicSnapshotLocation

  • ExchangeType

  • FastRowCount

  • FileTransferType

  • GenerationChangeThreshold

  • HistoryVerboseLevel

  • InputMessageFile

  • InteractiveResolution

  • InterruptOnMessagePattern

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDownloadChanges

  • MaxUploadChanges

  • MetadataRetentionCleanup

  • NumDeadlockRetries

  • Hasil

  • OutputMessageFile

  • OutputVerboseLevel

  • Ukuran Paket

  • ParallelUploadDownload

  • PauseOnMessagePattern

  • JedaWa

  • PollingInterval

  • ProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriber

  • QueryTimeout

  • AntreanSizeMultiplier

  • SrcThreads

  • StartQueueTimeout

  • SyncToAlternate

  • UploadGenerationsPerBatch

  • UploadReadChangesPerBatch

  • UploadWriteChangesPerBatch

  • UseInprocLoader

  • Memvalidasi

  • ValidateInterval

Untuk Agen Pembaca Antrean (agent_type=9), jika ditentukan dalam profil, properti berikut dapat diubah:

  • HistoryVerboseLevel

  • LoginTimeout

  • Hasil

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

Untuk melihat parameter apa yang telah ditentukan untuk profil tertentu, jalankan sp_help_agent_profile dan perhatikan profile_name yang terkait dengan profile_id. Dengan profile_id yang sesuai, jalankan sp_help_agent_parameters berikutnya menggunakan profile_id tersebut untuk melihat parameter yang terkait dengan profil. Parameter dapat ditambahkan ke profil dengan menjalankan sp_add_agent_parameter.

[ @parameter_value = ] 'parameter_value' Adalah nilai baru parameter. parameter_value adalah nvarchar(255), tanpa default.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_change_agent_parameter digunakan di semua jenis replikasi.

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_change_agent_parameter.

Lihat Juga

Profil Agen Replikasi
Agen Distribusi Replikasi
Agen Pembaca Log Replikasi
Agen Penggabungan Replikasi
Agen Pembaca Antrean Replikasi
Agen Rekam Jepret Replikasi
sp_add_agent_parameter (T-SQL)
sp_drop_agent_parameter (T-SQL)
sp_help_agent_parameter (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)