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 Publisher dan mengembalikan satu baris untuk setiap langganan yang dikembalikan. Prosedur tersimpan ini, yang digunakan untuk memantau replikasi, dijalankan di Distributor pada database distribusi.
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 Publisher 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 Apakah mode pemfilteran 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 | Hanya mengembalikan langganan yang telah menghasilkan peringatan metrik ambang batas. |
| 3 | Hanya mengembalikan 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 | Hanya mengembalikan 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 = Diam 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 ke publikasi gabungan belum disinkronkan dalam ambang periode retensi. 8 = mergefastrunduration - waktu yang diperlukan untuk menyelesaikan sinkronisasi langganan gabungan melebihi ambang batas, dalam hitungan detik, melalui koneksi jaringan yang cepat. 16 = mergeslowrunduration - waktu yang dibutuhkan untuk menyelesaikan sinkronisasi langganan penggabungan 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 yang 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.