sp_replmonitorhelpsubscription (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Managed Instance

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

Ikon tautan topikKonvensi Sintaks Transact-SQL

Sintaks

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

Argumen

[ @publisher = ] 'publisher' Adalah nama Penerbit yang statusnya sedang dipantau. publisher adalah sysname, dengan nilai default NULL. Jika null, informasi dikembalikan untuk semua Penerbit yang menggunakan Distributor.

[ @publisher_db = ] 'publisher_db' Adalah nama database yang diterbitkan. publisher_db adalah sysname, dengan nilai default NULL. Jika NULL, maka informasi dikembalikan untuk semua database yang diterbitkan di Publisher.

[ @publication = ] 'publication' Adalah nama publikasi yang sedang dipantau. publikasi adalah sysname, dengan nilai default NULL.

[ @publication_type = ] publication_type Jika jenis publikasi. publication_typeint, dan bisa menjadi salah satu nilai ini.

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

[ @mode = ] mode Adalah mode pemfilteran yang akan digunakan saat mengembalikan informasi pemantauan langganan. mode adalah int, dan dapat menjadi salah satu nilai ini.

Nilai Deskripsi
0 (default) Mengembalikan semua langganan.
1 Hanya mengembalikan langganan dengan kesalahan.
2 Mengembalikan hanya langganan yang telah menghasilkan peringatan metrik ambang batas.
3 Mengembalikan hanya langganan yang memiliki kesalahan atau telah 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 tataan hasil hanya untuk jumlah langganan yang ditentukan di bagian atas data yang dikembalikan. topnum adalah int, tanpa default.

[ @exclude_anonymous = ] exclude_anonymous Apakah jika langganan penarikan anonim dikecualikan dari kumpulan hasil. exclude_anonymoussedikit, dengan default 0; nilai 1 berarti bahwa langganan anonim dikecualikan dan nilai 0 berarti langganan tersebut disertakan.

[ @refreshpolicy = ] refreshpolicy Penggunaan internal saja.

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 kembali

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 = kedaluwarsa - langganan ke publikasi transaksional belum disinkronkan dalam ambang periode retensi.

2 = latensi - 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 dibutuhkan untuk menyelesaikan sinkronisasi langganan gabungan melebihi ambang batas, dalam hitungan detik, melalui koneksi jaringan cepat.

16 = mergeslowrunduration - waktu yang dibutuhkan untuk menyelesaikan sinkronisasi langganan gabungan melebihi ambang batas, dalam hitungan detik, melalui koneksi jaringan yang lambat atau dial-up.

32 = mergefastrunspeed - tingkat pengiriman untuk baris selama sinkronisasi langganan gabungan gagal mempertahankan laju ambang batas, dalam baris per detik, melalui koneksi jaringan cepat.

64 = mergeslowrunspeed - tingkat pengiriman untuk baris selama sinkronisasi langganan gabungan gagal mempertahankan laju ambang batas, dalam baris per detik, melalui koneksi jaringan yang lambat atau dial-up.
Pelanggan nama sysname Adalah nama Pelanggan.
subscriber_db nama sysname Adalah nama database yang digunakan untuk langganan.
publisher_db nama sysname Adalah nama database publikasi.
Publikasi nama sysname Adalah nama publikasi.
publication_type int Adalah jenis publikasi, yang bisa menjadi salah satu nilai ini:

0 = Publikasi transaksi

1 = Publikasi rekam jepret

2 = Gabungkan publikasi
Subtipe int Adalah jenis langganan, yang bisa menjadi salah satu nilai berikut:

0 = Dorong

1 = Tarik

2 = Anonim
Latency int Latensi tertinggi, dalam hitungan detik, untuk perubahan data yang disebarluaskan oleh Pembaca Log atau Agen Distribusi untuk publikasi transaksional.
latencythreshold int Adalah latensi maksimum untuk publikasi transaksi di atas yang peringatannya dinaikkan.
agentnotrunning int Apakah lama waktu, dalam jam, di mana agen belum berjalan.
agentnotrunningthreshold int Apakah lama waktu, dalam jam, bahwa agen belum berjalan sebelum peringatan dinaikkan.
timetoexpiration int Apakah lama waktu, dalam jam, sebelum langganan kedaluwarsa jika tidak disinkronkan.
expirationthreshold int Apakah waktu, dalam jam, sebelum langganan kedaluwarsa bahwa peringatan dinaikkan.
last_distsync datetime Adalah tanggalwaktu yang terakhir dijalankan Agen Distribusi.
distribution_agentname nama sysname Adalah nama pekerjaan Agen Distribusi untuk langganan ke publikasi transaksi.
mergeagentname nama sysname Adalah nama pekerjaan Agen Penggabungan untuk langganan ke publikasi gabungan.
mergesubscriptionfriendlyname nama sysname Adalah nama yang mudah diingat yang diberikan untuk langganan.
mergeagentlocation nama sysname Adalah 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 = koneksi jaringan dial-up

3 = Sinkronisasi web.
mergePerformance int Performa sinkronisasi terakhir dibandingkan dengan semua sinkronisasi untuk langganan, yang didasarkan pada tingkat pengiriman sinkronisasi terakhir dibagi dengan rata-rata semua tarif pengiriman sebelumnya.
mergerunspeed Float Adalah tingkat pengiriman sinkronisasi terakhir untuk langganan.
mergerunduration int Adalah lamanya waktu untuk menyelesaikan sinkronisasi terakhir langganan.
pemantauan int Adalah 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: segera kedaluwarsa 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 memesan 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.

Lihat juga

Memantau Replikasi Secara Terprogram