Bagikan melalui

sp_helppublication (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengembalikan informasi tentang publikasi. Untuk publikasi SQL Server, prosedur tersimpan ini dijalankan di Publisher pada database publikasi. Untuk publikasi Oracle, prosedur tersimpan ini dijalankan di Distributor pada database apa pun.

Konvensi sintaks transact-SQL

Sintaks

sp_helppublication_snapshot
    [ @publication = ] N'publication'
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argumen

[ @publication = ] N'publikasi'

Nama publikasi yang akan dilihat. @publication adalah sysname, dengan default %, yang mengembalikan informasi tentang semua publikasi.

[ @publisher = ] N'publisher'

Menentukan penerbit non-SQL Server. @publisher adalah sysname, dengan default NULL.

Catatan

penerbit tidak boleh ditentukan saat meminta informasi publikasi dari Penerbit SQL Server.

Tataan hasil

Nama kolom Jenis data Deskripsi
pubid int ID untuk publikasi.
name nama sysname Nama publikasi.
restricted int Diidentifikasi hanya untuk tujuan informasi. Tidak didukung. Kompatibilitas di masa mendatang tidak dijamin.
status kecil Status publikasi saat ini.

0 = Tidak aktif.
1 = Aktif.
task Digunakan untuk kompatibilitas mundur.
replication frequency kecil Jenis frekuensi replikasi:

0 = Transaksi
1 = Rekam jepret
synchronization method kecil Mode sinkronisasi:

0 = Program penyalinan massal asli (utilitas bcp )
1 = Salinan massal karakter
3 = Bersamaan, yang berarti bahwa salinan massal asli (utilitas bcp ) digunakan tetapi tabel tidak dikunci selama rekam jepret
4 = Concurrent_c, yang berarti bahwa salinan massal karakter digunakan tetapi tabel tidak dikunci selama rekam jepret
description nvarchar(255) Deskripsi opsional untuk publikasi.
immediate_sync bit Menentukan apakah file sinkronisasi dibuat atau dibuat ulang setiap kali Agen Rekam Jepret berjalan.
enabled_for_internet bit Menentukan apakah file sinkronisasi untuk publikasi diekspos ke Internet, melalui protokol transfer file (FTP) dan layanan lainnya.
allow_push bit Menentukan apakah langganan push diizinkan pada publikasi.
allow_pull bit Menentukan apakah langganan penarikan diizinkan pada publikasi.
allow_anonymous bit Menentukan apakah langganan anonim diizinkan pada publikasi.
independent_agent bit Menentukan apakah ada Agen Distribusi yang berdiri sendiri untuk publikasi ini.
immediate_sync_ready bit Menentukan apakah Agen Rekam Jepret menghasilkan rekam jepret yang siap digunakan oleh langganan baru. Parameter ini ditentukan hanya jika publikasi diatur untuk selalu memiliki rekam jepret yang tersedia untuk langganan baru atau yang diinisialisasi ulang.
allow_sync_tran bit Menentukan apakah langganan yang segera diperbarui diizinkan pada publikasi.
autogen_sync_procs bit Menentukan apakah akan secara otomatis menghasilkan prosedur tersimpan untuk mendukung langganan yang segera diperbarui.
snapshot_jobid biner(16) ID tugas terjadwal.
retention int Jumlah perubahan, dalam jam, untuk menghemat publikasi yang diberikan.
has subscription bit Menentukan apakah publikasi memiliki langganan aktif. 1 berarti bahwa publikasi memiliki langganan aktif, dan 0 berarti bahwa publikasi tidak memiliki langganan.
allow_queued_tran bit Menentukan apakah menonaktifkan antrean perubahan di Pelanggan hingga dapat diterapkan di Penerbit diaktifkan. Jika 0, perubahan di Pelanggan tidak diantrekan.
snapshot_in_defaultfolder bit Menentukan apakah file rekam jepret disimpan di folder default. Jika 0, file rekam jepret disimpan di lokasi alternatif yang ditentukan oleh alternate_snapshot_folder. Jika 1, file rekam jepret dapat ditemukan di folder default.
alt_snapshot_folder nvarchar(255) Menentukan lokasi folder alternatif untuk rekam jepret.
pre_snapshot_script nvarchar(255) Menentukan penunjuk ke .sql lokasi file. Agen Distribusi menjalankan skrip pra-rekam jepret sebelum menjalankan salah satu skrip objek yang direplikasi saat menerapkan rekam jepret pada Pelanggan.
post_snapshot_script nvarchar(255) Menentukan penunjuk ke .sql lokasi file. Agen Distribusi akan menjalankan skrip pasca-rekam jepret setelah semua skrip objek dan data lain yang direplikasi diterapkan selama sinkronisasi awal.
compress_snapshot bit Menentukan bahwa rekam jepret yang ditulis ke lokasi alt_snapshot_folder akan dikompresi ke dalam format Microsoft CAB. 0 menentukan bahwa rekam jepret tidak dikompresi.
ftp_address nama sysname Alamat jaringan layanan FTP untuk Distributor. Menentukan di mana file rekam jepret publikasi berada untuk Agen Distribusi atau Agen Penggabungan pelanggan untuk diambil.
ftp_port int Nomor port layanan FTP untuk Distributor.
ftp_subdirectory nvarchar(255) Menentukan tempat file rekam jepret tersedia untuk Agen Distribusi atau Agen Penggabungan pelanggan untuk diambil jika publikasi mendukung penyebaran rekam jepret menggunakan FTP.
ftp_login nama sysname Nama pengguna yang digunakan untuk menyambungkan ke layanan FTP.
allow_dts bit Menentukan bahwa publikasi mengizinkan transformasi data. 0 menentukan bahwa transformasi DTS tidak diizinkan.
allow_subscription_copy bit Menentukan apakah kemampuan untuk menyalin database langganan yang berlangganan publikasi ini diaktifkan. 0 berarti bahwa penyalinan tidak diizinkan.
centralized_conflicts bit Menentukan apakah rekaman konflik disimpan di Publisher:

0 = Rekaman konflik disimpan di penerbit dan pada pelanggan yang menyebabkan konflik.
1 = Rekaman konflik disimpan di Publisher.
conflict_retention int Menentukan periode retensi konflik, dalam hari.
conflict_policy int Menentukan kebijakan resolusi konflik diikuti ketika opsi pelanggan pembaruan antrean digunakan. Dapat berupa salah satu nilai ini:

1 = Publisher memenangkan konflik.
2 = Pelanggan memenangkan konflik.
3 = Langganan diinisialisasi ulang.
queue_type Menentukan jenis antrean mana yang digunakan. Dapat berupa salah satu nilai ini:

msmq = Gunakan Antrean Pesan Microsoft untuk menyimpan transaksi.
sql = Gunakan SQL Server untuk menyimpan transaksi.
Catatan: Dukungan untuk Antrean Pesan dihentikan.
backward_comp_level Tingkat kompatibilitas database, dan bisa menjadi salah satu nilai berikut:

90 = SQL Server 2005 (9.x)
100 = Microsoft SQL Server 2008 (10.0.x)
publish_to_AD bit Menentukan apakah publikasi diterbitkan di Microsoft Active Directory. Nilai 1 menunjukkan bahwa nilai diterbitkan, dan nilai 0 menunjukkan bahwa nilai tersebut tidak diterbitkan.
allow_initialize_from_backup bit Menunjukkan apakah Pelanggan dapat menginisialisasi langganan ke publikasi ini dari cadangan daripada rekam jepret awal. 1 berarti bahwa langganan dapat diinisialisasi dari cadangan, dan 0 berarti bahwa langganan tidak dapat diinisialisasi. Untuk informasi selengkapnya, lihat Menginisialisasi Langganan Transaksi tanpa Rekam Jepret Pelanggan transaksi tanpa rekam jepret.
replicate_ddl int Menunjukkan apakah replikasi skema didukung untuk publikasi. 1 menunjukkan bahwa pernyataan bahasa definisi data (DDL) yang dijalankan di penerbit direplikasi, dan 0 menunjukkan bahwa pernyataan DDL tidak direplikasi. Untuk informasi selengkapnya, lihat Membuat Perubahan Skema pada Database Publikasi.
enabled_for_p2p int Menentukan apakah publikasi dapat digunakan dalam topologi replikasi peer-to-peer. 1 menunjukkan bahwa publikasi mendukung replikasi peer-to-peer. Untuk informasi selengkapnya, lihat Peer-to-Peer - Replikasi Transaksional.
publish_local_changes_only int Diidentifikasi hanya untuk tujuan informasi. Tidak didukung. Kompatibilitas di masa mendatang tidak dijamin.
enabled_for_het_sub int Menentukan apakah publikasi mendukung Pelanggan non-SQL Server. Nilai 1 berarti bahwa Pelanggan non-SQL Server didukung. Nilai 0 berarti bahwa hanya Pelanggan SQL Server yang didukung. Untuk informasi selengkapnya, lihat Pelanggan Non-SQL Server.
enabled_for_p2p_conflictdetection int Menentukan apakah Agen Distribusi mendeteksi konflik untuk publikasi yang diaktifkan untuk replikasi peer-to-peer. Nilai 1 berarti bahwa konflik terdeteksi. Untuk informasi selengkapnya, lihat Peer-to-Peer - Deteksi Konflik di Replikasi Peer-to-Peer.
originator_id int Menentukan ID untuk simpul dalam topologi peer-to-peer. ID ini digunakan untuk deteksi konflik jika enabled_for_p2p_conflictdetection diatur ke 1. Untuk daftar ID yang sudah digunakan, kueri tabel sistem MSpeer_originatorid_history .
p2p_continue_onconflict int Menentukan apakah Agen Distribusi terus memproses perubahan saat konflik terdeteksi. Nilai 1 berarti bahwa agen terus memproses perubahan.

Perhatian: Kami sarankan Anda menggunakan nilai default .0 Ketika opsi ini diatur ke 1, Agen Distribusi mencoba menyatukan data dalam topologi dengan menerapkan baris yang bertentangan dari simpul yang merupakan ID pencetus tertinggi. Metode ini tidak menjamin konvergensi. Anda harus memastikan bahwa topologi konsisten setelah konflik terdeteksi. Untuk informasi selengkapnya, lihat "Menangani Konflik" di Peer-to-Peer - Deteksi Konflik di Replikasi Peer-to-Peer.
allow_partition_switch int Menentukan apakah ALTER TABLE...SWITCH pernyataan dapat dijalankan terhadap database yang diterbitkan. Untuk informasi selengkapnya, lihat Mereplikasi Tabel dan Indeks yang Dipartisi.
replicate_partition_switch int Menentukan apakah ALTER TABLE...SWITCH pernyataan yang dijalankan terhadap database yang diterbitkan harus direplikasi ke Pelanggan. Opsi ini hanya valid jika allow_partition_switch diatur ke 1.
enabled_for_p2p_lastwriter_conflictdetection int Menentukan apakah Agen Distribusi mendeteksi Konfigurasi deteksi konflik penulis terakhir & konflik resolusi untuk publikasi yang diaktifkan untuk replikasi peer-to-peer. Nilai 1 berarti bahwa konflik penulis terakhir terdeteksi.

Berlaku untuk: SQL Server 2019 (15.x) CU 13 dan versi yang lebih baru.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_helppublication digunakan dalam rekam jepret dan replikasi transaksional.

sp_helppublication mengembalikan informasi tentang semua publikasi yang dimiliki oleh pengguna yang menjalankan prosedur ini.

Contoh

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2022]
EXEC sp_helppublication @publication = @myTranPub
GO

Izin

Hanya anggota peran server tetap sysadmin di Penerbit atau anggota peran database tetap db_owner pada database publikasi atau pengguna dalam daftar akses publikasi (PAL) yang dapat menjalankan sp_helppublication.

Untuk Penerbit Non-SQL Server, hanya anggota peran server tetap sysadmin di Distributor atau anggota db_owner peran database tetap pada database distribusi atau pengguna di PAL yang dapat menjalankan sp_helppublication.

Konten terkait