sp_helppublication (T-SQL)

Berlaku untuk:SQL ServerAzure SQL Managed Instance

Mengembalikan informasi tentang publikasi. Untuk publikasi Microsoft 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 [ [ @publication = ] 'publication' ]  
    [ , [ @found=] found OUTPUT]  
    [ , [ @publisher = ] 'publisher' ]  

Argumen

[ @publication = ] 'publication' Adalah nama publikasi yang akan dilihat. publikasi adalah sysname, dengan default %, yang mengembalikan informasi tentang semua publikasi.

[ @found = ] 'found' OUTPUT Adalah bendera untuk menunjukkan baris yang dikembalikan. ditemukan adalah int dan parameter OUTPUT, dengan default 23456. 1 menunjukkan publikasi ditemukan. 0 menunjukkan publikasi tidak ditemukan.

[ @publisher = ] '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.
nama nama sysname Nama publikasi.
terbatas 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.
tugas Digunakan untuk kompatibilitas mundur.
frekuensi replikasi kecil Jenis frekuensi replikasi:

0 = Transaksi

1 = Rekam jepret
metode sinkronisasi 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 Apakah file sinkronisasi dibuat atau dibuat ulang setiap kali Agen Rekam Jepret berjalan.
enabled_for_internet bit Apakah file sinkronisasi untuk publikasi terekspos ke Internet, melalui protokol transfer file (FTP) dan layanan lainnya.
allow_push bit Apakah langganan push diizinkan pada publikasi.
allow_pull bit Apakah langganan penarikan diizinkan pada publikasi.
allow_anonymous bit Apakah langganan anonim diizinkan pada publikasi.
independent_agent bit Apakah ada Agen Distribusi yang berdiri sendiri untuk publikasi ini.
immediate_sync_ready bit Apakah Agen Rekam Jepret menghasilkan rekam jepret yang siap digunakan oleh langganan baru atau tidak. 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 Apakah langganan yang segera diperbarui diizinkan pada publikasi.
autogen_sync_procs bit Apakah akan secara otomatis menghasilkan prosedur tersimpan untuk mendukung langganan yang segera diperbarui.
snapshot_jobid biner(16) ID tugas terjadwal.
Penyimpanan int Jumlah perubahan, dalam jam, untuk menghemat publikasi yang diberikan.
memiliki langganan bit Jika 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 telah 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 telah 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 lokasi file .sql . Agen Distribusi akan 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 lokasi file .sql . Agen Distribusi akan menjalankan skrip pasca-rekam jepret setelah semua skrip objek dan data lain yang direplikasi telah 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 akan 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 di mana file rekam jepret akan 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 telah diaktifkan. 0 berarti bahwa penyalinan tidak diperbolehkan.
centralized_conflicts bit Menentukan apakah rekaman konflik disimpan di Publisher:

0 = Rekaman konflik disimpan di penerbit dan 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 telah dihentikan.
backward_comp_level Tingkat kompatibilitas database, dan bisa menjadi salah satu hal berikut ini:

90 = Microsoft 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 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 Jika publikasi dapat digunakan dalam topologi replikasi peer-to-peer. 1 menunjukkan bahwa publikasi mendukung replikasi peer-to-peer. Untuk informasi selengkapnya, lihat Replikasi Transaksional Peer-to-Peer.
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 konflik terdeteksi. Untuk informasi selengkapnya, lihat 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 telah 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.

** Hati-hati ** 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 memiliki ID pencetus tertinggi. Metode ini tidak menjamin konvergensi. Anda harus memastikan bahwa topologi konsisten setelah konflik terdeteksi. Untuk informasi selengkapnya, lihat "Menangani Konflik" dalam Deteksi Konflik di Replikasi Peer-to-Peer.
allow_partition_switch int Menentukan apakah ALTER TABLE... Pernyataan SWITCH dapat dijalankan terhadap database yang diterbitkan. Untuk informasi selengkapnya, lihat Mereplikasi Tabel dan Indeks yang Dipartisi.
replicate_partition_switch int Menentukan apakah ALTER TABLE... Pernyataan SWITCH 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 Dimulai dengan SQL Server 2019 (15.x) CU 13, menentukan apakah Agen Distribusi mendeteksi konflik penulis terakhir untuk publikasi yang diaktifkan untuk replikasi peer-to-peer. Nilai 1 berarti konflik penulis terakhir terdeteksi.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_helppublication digunakan dalam rekam jepret dan replikasi transaksional.

sp_helppublication akan 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.

Lihat Juga

Menampilkan dan Mengubah Properti Publikasi
sp_addpublication (T-SQL)
sp_changepublication (T-SQL)
sp_droppublication (T-SQL)
Prosedur Tersimpan Replikasi (Transact-SQL)