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 = ] N'parameter_name'
    , [ @parameter_value = ] N'parameter_value'
[ ; ]

Argumen

[ @profile_id = ] profile_id

ID profil. @profile_id int, tanpa default.

[ @parameter_name = ] N'parameter_name'

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 profile_id kolom dalam Msagent_profiles tabel, dan catat nilainyaagent_type.

Jika parameter didukung untuk agent_type, tetapi tidak ditentukan dalam 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:

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

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

  • HistoryVerboseLevel
  • LoginTimeout
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • 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
  • Output
  • OutputVerboseLevel
  • PacketSize
  • 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
  • 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

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

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

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

[ @parameter_value = ] N'parameter_value'

Nilai baru parameter. @parameter_value adalah nvarchar(255), tanpa default.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_change_agent_parameter digunakan dalam semua jenis replikasi.

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_change_agent_parameter.

Konten terkait