Bagikan melalui


sp_replmonitorhelpsubscription (T-SQL)

Berlaku untuk: SQL ServerAzure SQL Managed Instance

Mengembalikan informasi status saat ini untuk langganan milik satu atau beberapa publikasi di Publisher dan mengembalikan satu baris untuk setiap langganan yang dikembalikan. Prosedur tersimpan ini, yang digunakan untuk memantau replikasi, dijalankan di Distributor pada database distribusi.

Konvensi sintaks transact-SQL

Sintaks

sp_replmonitorhelpsubscription
    [ [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
    [ , [ @publication_type = ] publication_type ]
    [ , [ @mode = ] mode ]
    [ , [ @topnum = ] topnum ]
    [ , [ @exclude_anonymous = ] exclude_anonymous ]
    [ , [ @refreshpolicy = ] refreshpolicy ]
[ ; ]

Argumen

[ @publisher = ] N'publisher'

Nama Publisher yang statusnya sedang dipantau. @publisher adalah sysname, dengan default NULL. Jika null, informasi dikembalikan untuk semua Penerbit yang menggunakan Distributor.

[ @publisher_db = ] N'publisher_db'

Nama database yang diterbitkan. @publisher_db adalah sysname, dengan default NULL. Jika NULL, informasi dikembalikan untuk semua database yang diterbitkan di Publisher.

[ @publication = ] N'publikasi'

Nama publikasi yang sedang dipantau. @publication adalah sysname, dengan default NULL.

[ @publication_type = ] publication_type

Jika jenis publikasi. @publication_type int, dan bisa menjadi salah satu nilai ini.

Nilai Deskripsi
0 Publikasi transaksi.
1 Publikasi rekam jepret.
2 Gabungkan publikasi.
NULL (standar) Replikasi mencoba menentukan jenis publikasi.

[ @mode = ] mode

Mode pemfilteran yang akan digunakan saat mengembalikan informasi pemantauan langganan. @mode int, dan bisa menjadi salah satu nilai ini.

Nilai Deskripsi
0 (standar) Mengembalikan semua langganan.
1 Hanya mengembalikan langganan dengan kesalahan.
2 Hanya mengembalikan langganan yang menghasilkan peringatan metrik ambang batas.
3 Mengembalikan hanya langganan yang memiliki kesalahan, atau menghasilkan peringatan metrik ambang batas.
4 Mengembalikan 25 langganan berkinerja terburuk teratas.
5 Mengembalikan 50 langganan berkinerja terburuk teratas.
6 Mengembalikan hanya langganan yang saat ini sedang disinkronkan.
7 Mengembalikan hanya langganan yang saat ini tidak sedang disinkronkan.

[ @topnum = ] topnum

Membatasi hasil yang diatur hanya ke jumlah langganan yang ditentukan di bagian atas data yang dikembalikan. @topnum int, dengan default NULL.

[ @exclude_anonymous = ] exclude_anonymous

Jika langganan penarikan anonim dikecualikan dari kumpulan hasil. @exclude_anonymous adalah bit, dengan default 0.

  • Nilai 1 berarti bahwa langganan anonim dikecualikan.
  • Nilai 0 berarti bahwa nilai tersebut disertakan.

[ @refreshpolicy = ] refreshpolicy

Diidentifikasi hanya untuk tujuan informasi. Tidak didukung. Kompatibilitas di masa mendatang tidak dijamin.

Tataan hasil

Nama kolom Jenis data Deskripsi
status Int Memeriksa status semua agen replikasi yang terkait dengan publikasi, dan mengembalikan status tertinggi yang ditemukan dalam urutan berikut:

6 = Gagal
5 = Mencoba lagi
2 = Dihentikan
4 = Menganggur
3 = Sedang berlangsung
1 = Dimulai
warning Int Peringatan ambang batas maksimum yang dihasilkan oleh langganan milik publikasi, yang dapat menjadi hasil LOGIS ATAU dari satu atau beberapa nilai ini.

1 = expiration - langganan ke publikasi transaksional belum disinkronkan dalam ambang periode retensi.
2 = latency - waktu yang diperlukan untuk mereplikasi data dari Penerbit transaksional ke Pelanggan melebihi ambang batas, dalam hitungan detik.
4 = mergeexpiration - langganan untuk publikasi gabungan belum disinkronkan dalam ambang periode retensi.
8 = mergefastrunduration - waktu yang diperlukan untuk menyelesaikan sinkronisasi langganan penggabungan melebihi ambang batas, dalam hitungan detik, melalui koneksi jaringan yang cepat.
16 = mergeslowrunduration - waktu yang diperlukan untuk menyelesaikan sinkronisasi langganan penggabungan melebihi ambang batas, dalam hitungan detik, melalui koneksi jaringan yang lambat.
32 = mergefastrunspeed - tingkat pengiriman untuk baris selama sinkronisasi langganan penggabungan gagal mempertahankan laju ambang batas, dalam baris per detik, melalui koneksi jaringan cepat.
64 = mergeslowrunspeed - tingkat pengiriman untuk baris selama sinkronisasi langganan penggabungan gagal mempertahankan laju ambang batas, dalam baris per detik, melalui koneksi jaringan yang lambat.
subscriber nama sysname Nama Pelanggan.
subscriber_db nama sysname Nama database yang digunakan untuk langganan.
publisher_db nama sysname Nama database publikasi.
publication nama sysname Nama publikasi.
publication_type Int Jenis publikasi, yang bisa menjadi salah satu nilai ini:

0 = Publikasi transaksi
1 = Publikasi rekam jepret
2 = Gabungkan publikasi
subtype Int Jenis langganan, yang bisa menjadi salah satu nilai berikut:

0 = Dorong
1 = Tarik
2 = Anonim
latency Int Latensi tertinggi, dalam detik, untuk perubahan data yang disebarkan oleh Pembaca Log atau Agen Distribusi untuk publikasi transaksional.
latencythreshold Int Latensi maksimum untuk publikasi transaksi, di atas tempat peringatan dinaikkan.
agentnotrunning Int Lamanya waktu, dalam jam, di mana agen belum berjalan.
agentnotrunningthreshold Int Lamanya waktu, dalam jam, bahwa agen belum berjalan sebelum peringatan dinaikkan.
timetoexpiration Int Lamanya waktu, dalam jam, sebelum langganan kedaluwarsa jika tidak disinkronkan.
expirationthreshold Int Waktu, dalam jam, sebelum langganan kedaluwarsa bahwa peringatan dinaikkan.
last_distsync tanggalwaktu Tanggalwaktu agen distribusi terakhir dijalankan.
distribution_agentname nama sysname Nama pekerjaan Agen Distribusi untuk langganan ke publikasi transaksi.
mergeagentname nama sysname Nama pekerjaan Agen Penggabungan untuk langganan ke publikasi gabungan.
mergesubscriptionfriendlyname nama sysname Nama yang mudah diingat yang diberikan untuk langganan.
mergeagentlocation nama sysname Nama server tempat Agen Penggabungan berjalan.
mergeconnectiontype Int Koneksi yang digunakan saat menyinkronkan langganan ke publikasi gabungan, yang bisa menjadi salah satu nilai berikut:

1 = jaringan area lokal (LAN)
2 = sambungan jaringan dial-up
3 = Sinkronisasi web.
mergePerformance Int Performa sinkronisasi terakhir dibandingkan dengan semua sinkronisasi untuk langganan, yang didasarkan pada tingkat pengiriman sinkronisasi terakhir yang dibagi dengan rata-rata semua tarif pengiriman sebelumnya.
mergerunspeed mengapung Tingkat pengiriman sinkronisasi terakhir untuk langganan.
mergerunduration Int Lamanya waktu untuk menyelesaikan sinkronisasi terakhir langganan.
monitorranking Int Nilai peringkat yang digunakan untuk memesan langganan dalam tataan hasil, dan bisa menjadi salah satu nilai ini:

Untuk publikasi transaksi:

60 = Kesalahan
56 = Peringatan: performa kritis
52 = Peringatan: kedaluwarsa segera atau kedaluwarsa
50 = Peringatan: langganan tidak diinisialisasi
40 = Coba lagi perintah gagal
30 = Tidak berjalan (berhasil)
20 = Berjalan (memulai, menjalankan, atau menganggur)

Untuk publikasi gabungan:

60 = Kesalahan
56 = Peringatan: performa kritis
54 = Peringatan: penggabungan jangka panjang
52 = Peringatan: segera kedaluwarsa
50 = Peringatan: langganan tidak diinisialisasi
40 = Coba lagi perintah gagal
30 = Berjalan (memulai, menjalankan, atau menganggur)
20 = Tidak berjalan (berhasil)
distributionagentjobid biner(16) ID pekerjaan Agen Distribusi untuk langganan ke publikasi transaksi.
mergeagentjobid biner(16) ID pekerjaan Agen Penggabungan untuk langganan ke publikasi gabungan.
distributionagentid Int ID pekerjaan Agen Distribusi untuk langganan.
distributionagentprofileid Int ID profil agen yang digunakan oleh Agen Distribusi.
mergeagentid Int ID pekerjaan Agen Penggabungan untuk langganan.
mergeagentprofileid Int ID profil agen yang digunakan oleh Agen Penggabungan.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_replmonitorhelpsubscription digunakan dengan semua jenis replikasi.

sp_replmonitorhelpsubscription mengurutkan hasil yang ditetapkan berdasarkan tingkat keparahan status langganan, yang ditentukan oleh nilai monitorranking. Misalnya, baris untuk semua langganan dalam status kesalahan diurutkan di atas baris untuk langganan dalam status peringatan.

Izin

Hanya anggota peran database tetap db_owner atau replmonitor pada database distribusi yang dapat menjalankan sp_replmonitorhelpsubscription.