sp_helpmergepublication (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mengembalikan informasi tentang publikasi gabungan. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi.

Konvensi sintaks transact-SQL

Sintaks

sp_helpmergepublication
    [ [ @publication = ] N'publication' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumen

[ @publication = ] N'publikasi'

Nama publikasi. @publication adalah sysname, dengan default %, yang mengembalikan informasi tentang semua publikasi gabungan dalam database saat ini.

[ @found = ] ditemukan OUTPUT

Bendera untuk menunjukkan baris yang dikembalikan. @found adalah parameter OUTPUT dari jenis int.

  • 1 menunjukkan publikasi ditemukan.
  • 0 menunjukkan publikasi tidak ditemukan.

[ @publication_id = ] OUTPUT 'publication_id'

Nomor identifikasi publikasi. @publication_id adalah parameter OUTPUT dari jenis pengidentifikasi unik.

[ @reserved = ] N'reserved'

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

[ @publisher = ] N'publisher'

Nama Publisher. @publisher adalah sysname, dengan default NULL.

[ @publisher_db = ] N'publisher_db'

Nama database publikasi. @publisher_db adalah sysname, dengan default NULL.

Tataan hasil

Nama kolom Jenis data Deskripsi
id int Urutan berurutan publikasi dalam daftar kumpulan hasil.
name nama sysname Nama publikasi.
description nvarchar(255) Deskripsi publikasi.
status kecil Menunjukkan kapan data publikasi tersedia.
retention int Jumlah waktu untuk menyimpan metadata tentang perubahan artikel dalam publikasi. Unit untuk periode waktu ini dapat berupa hari, minggu, bulan, atau tahun. Untuk informasi tentang unit, lihat kolom retention_period_unit.
sync_mode kecil Mode sinkronisasi publikasi ini:

0 = Program penyalinan massal asli (utilitas bcp )

1 = Salinan massal karakter
allow_push int Menentukan apakah langganan push dapat dibuat untuk publikasi yang diberikan. 0 berarti bahwa langganan push tidak diizinkan.
allow_pull int Menentukan apakah langganan penarikan dapat dibuat untuk publikasi yang diberikan. 0 berarti bahwa langganan penarikan tidak diizinkan.
allow_anonymous int Menentukan apakah langganan anonim dapat dibuat untuk publikasi yang diberikan. 0 berarti bahwa langganan anonim tidak diizinkan.
centralized_conflicts int Menentukan apakah rekaman konflik disimpan pada Publisher yang diberikan:

0 = rekaman konflik disimpan di penerbit dan pada pelanggan yang menyebabkan konflik.

1 = semua rekaman konflik disimpan di Publisher.
priority float(8) Prioritas langganan loop-back.
snapshot_ready kecil Menunjukkan apakah rekam jepret publikasi ini siap:

0 = Rekam jepret siap digunakan.

1 = Rekam jepret belum siap digunakan.
publication_type int Jenis publikasi:

0 = Rekam jepret.

1 = Transaksi.

2 = Gabungkan.
pubid pengidentifikasi unik Pengidentifikasi unik publikasi ini.
snapshot_jobid biner(16) ID Pekerjaan Agen Rekam Jepret. Untuk mendapatkan entri untuk pekerjaan rekam jepret dalam tabel sistem sysjobs , Anda harus mengonversi nilai heksadesimal ini menjadi uniqueidentifier.
enabled_for_internet int Menentukan apakah publikasi diaktifkan untuk Internet. Jika 1, file sinkronisasi untuk publikasi dimasukkan ke C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp dalam direktori. Pengguna harus membuat direktori Protokol Transfer File (FTP). Jika 0, publikasi tidak diaktifkan untuk akses Internet.
dynamic_filter int Menunjukkan apakah filter baris berparameter digunakan. 0 berarti filter baris berparameter tidak digunakan.
has_subscription bit Menunjukkan apakah publikasi memiliki langganan apa pun. 0 berarti saat ini tidak ada langganan untuk publikasi ini.
snapshot_in_default_folder bit Menentukan apakah file rekam jepret disimpan di folder default.

Jika 1, file rekam jepret dapat ditemukan di folder default.

Jika 0, file rekam jepret disimpan di lokasi alternatif yang ditentukan oleh alt_snapshot_folder. Lokasi alternatif dapat berada di server lain, pada drive jaringan, atau pada media yang dapat dilepas (seperti CD-ROM atau disk yang dapat dilepas). Anda juga dapat menyimpan file rekam jepret ke situs FTP, untuk diambil oleh Pelanggan di lain waktu.

Catatan: Parameter ini bisa benar dan masih memiliki lokasi dalam alt_snapshot_folder parameter . Kombinasi tersebut menentukan bahwa file rekam jepret disimpan di lokasi default dan alternatif.
alt_snapshot_folder nvarchar(255) Menentukan lokasi folder alternatif untuk rekam jepret.
pre_snapshot_script nvarchar(255) Menentukan penunjuk ke file .sql yang dijalankan Agen Penggabungan sebelum salah satu skrip objek yang direplikasi saat menerapkan rekam jepret pada Pelanggan.
post_snapshot_script nvarchar(255) Menentukan penunjuk ke file .sql yang dijalankan Agen Penggabungan setelah semua skrip objek dan data lain yang direplikasi telah diterapkan selama sinkronisasi awal.
compress_snapshot bit Menentukan bahwa rekam jepret yang ditulis ke alt_snapshot_folder lokasi dikompresi ke dalam format Microsoft CAB.
ftp_address nama sysname Alamat jaringan layanan FTP untuk Distributor. Menentukan tempat file rekam jepret publikasi berada untuk diambil oleh Agen Penggabungan.
ftp_port int Nomor port layanan FTP untuk Distributor. ftp_portmemiliki default .21 Menentukan di mana file rekam jepret publikasi berada agar Agen Penggabungan diambil.
ftp_subdirectory nvarchar(255) Menentukan tempat file rekam jepret tersedia bagi Agen Penggabungan untuk diambil saat rekam jepret dikirimkan menggunakan FTP.
ftp_login nama sysname Nama pengguna yang digunakan untuk menyambungkan ke layanan FTP.
conflict_retention int Menentukan periode retensi, dalam hari, yang konfliknya dipertahankan. Setelah jumlah hari yang ditentukan berlalu, baris konflik dihapus menyeluruh dari tabel konflik.
keep_partition_changes int Menentukan apakah pengoptimalan sinkronisasi terjadi untuk publikasi ini. keep_partition_changesmemiliki default .0 Nilai 0 berarti bahwa sinkronisasi tidak dioptimalkan, dan partisi yang dikirim ke semua Pelanggan diverifikasi saat data berubah dalam partisi.

1 berarti bahwa sinkronisasi dioptimalkan, dan hanya Pelanggan yang memiliki baris dalam partisi yang diubah yang terpengaruh.

Catatan: Secara default, publikasi gabungan menggunakan partisi yang telah dikompilasi sebelumnya, yang memberikan tingkat pengoptimalan yang lebih besar daripada opsi ini. Untuk informasi selengkapnya, lihat Filter Berparameter - Filter Baris Berparameter dan Filter Berparameter - Optimalkan untuk Partisi yang Telah Dikomputasi.
allow_subscription_copy int Menentukan apakah kemampuan untuk menyalin database langganan yang berlangganan publikasi ini telah diaktifkan. Nilai 0 berarti penyalinan tidak diizinkan.
allow_synctoalternate int Menentukan apakah mitra sinkronisasi alternatif diizinkan untuk disinkronkan dengan Publisher ini. Nilai 0 berarti mitra sinkronisasi tidak diizinkan.
validate_subscriber_info nvarchar(500) Mencantumkan fungsi yang digunakan untuk mengambil informasi Pelanggan dan memvalidasi kriteria pemfilteran baris berparameter pada Pelanggan. Membantu memverifikasi bahwa informasi dipartisi secara konsisten dengan setiap penggabungan.
backward_comp_level int Tingkat kompatibilitas database, dan bisa menjadi salah satu nilai berikut:

90 = SQL Server 2005 (9.x)

90 = SQL Server 2005 (9.x) SP1

90 = SQL Server 2005 (9.x) SP2

100 = SQL Server 2008 (10.0.x)
publish_to_activedirectory bit Menentukan apakah informasi publikasi diterbitkan ke Direktori Aktif. Nilai 0 berarti informasi publikasi tidak tersedia dari Direktori Aktif.

Parameter ini tidak digunakan lagi dan dipertahankan untuk kompatibilitas skrip mundur. Anda tidak dapat lagi menambahkan informasi publikasi ke Direktori Aktif.
max_concurrent_merge int Jumlah proses penggabungan bersamaan. Jika 0, tidak ada batasan jumlah proses penggabungan bersamaan yang berjalan pada waktu tertentu.
max_concurrent_dynamic_snapshots int Jumlah maksimum sesi rekam jepret data yang difilter bersamaan yang dapat berjalan terhadap publikasi gabungan. Jika 0, tidak ada batasan jumlah maksimum sesi rekam jepret data yang difilter bersamaan yang dapat berjalan secara bersamaan terhadap publikasi pada waktu tertentu.
use_partition_groups int Menentukan apakah partisi yang telah dikomputasi digunakan. Nilai 1 berarti bahwa partisi yang telah dikomputasi digunakan.
num_of_articles int Jumlah artikel dalam publikasi.
replicate_ddl int Jika perubahan skema pada tabel yang diterbitkan direplikasi. Nilai 1 berarti bahwa perubahan skema direplikasi.
publication_number smallint Nomor yang ditetapkan untuk publikasi ini.
allow_subscriber_initiated_snapshot bit Menentukan apakah Pelanggan dapat memulai proses pembuatan rekam jepret data yang difilter. Nilai 1 berarti bahwa Pelanggan dapat memulai proses rekam jepret.
allow_web_synchronization bit Menentukan apakah publikasi diaktifkan untuk sinkronisasi Web. Nilai 1 berarti bahwa sinkronisasi Web diaktifkan.
web_synchronization_url nvarchar(500) URL Internet yang digunakan untuk sinkronisasi Web.
allow_partition_realignment bit Menentukan apakah penghapusan dikirim ke pelanggan saat modifikasi baris pada penerbit menyebabkannya mengubah partisinya. Nilai 1 sarana yang menghapus dikirim ke Pelanggan. Untuk informasi selengkapnya, lihat sp_addmergepublication (Transact-SQL).
retention_period_unit kecil Menentukan unit yang digunakan saat menentukan retensi. Ini bisa menjadi salah satu nilai berikut:

0 = hari

1 = minggu

2 = bulan

3 = tahun
has_downloadonly_articles bit Menunjukkan apakah ada artikel yang termasuk dalam publikasi adalah artikel unduhan saja. Nilai 1 menunjukkan bahwa ada artikel khusus unduhan.
decentralized_conflicts int Menunjukkan apakah rekaman konflik disimpan di Pelanggan yang menyebabkan konflik. Nilai 0 menunjukkan bahwa rekaman konflik tidak disimpan di Pelanggan. Nilai 1 menunjukkan bahwa rekaman konflik disimpan di Pelanggan.
generation_leveling_threshold int Menentukan jumlah perubahan yang terkandung dalam satu generasi. Generasi adalah kumpulan perubahan yang dikirimkan ke Penerbit atau Pelanggan
automatic_reinitialization_policy bit Menunjukkan apakah perubahan diunggah dari Pelanggan sebelum reinisialisasi otomatis terjadi. Nilai 1 menunjukkan bahwa perubahan diunggah dari Pelanggan sebelum reinisialisasi otomatis terjadi. Nilai 0 menunjukkan bahwa perubahan tidak diunggah sebelum reinisialisasi otomatis.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_helpmergepublication digunakan dalam replikasi penggabungan.

Izin

Anggota daftar akses publikasi untuk publikasi dapat dijalankan sp_helpmergepublication untuk publikasi tersebut. Anggota peran database tetap db_owner pada database publikasi dapat menjalankan sp_helpmergepublication untuk informasi tentang semua publikasi.

Contoh

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2022]
EXEC sp_helpmergepublication @publication = @publication;
GO

Konten terkait