sp_changesubscription (T-SQL)

Artikel
12/22/2023

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengubah properti rekam jepret atau langganan pendorongan transaksional atau langganan penarikan yang terlibat dalam antrean memperbarui replikasi transaksional. Untuk mengubah properti semua jenis langganan penarikan lainnya, gunakan sp_change_subscription_properties (Transact-SQL). sp_changesubscription dijalankan di Publisher pada database publikasi.

Penting

Saat mengonfigurasi Penerbit dengan Distributor jarak jauh, nilai yang disediakan untuk semua parameter, termasuk job_login dan job_password, dikirim ke Distributor sebagai teks biasa. Anda harus mengenkripsi koneksi antara Publisher dan Distributor jarak jauhnya sebelum menjalankan prosedur tersimpan ini. Untuk informasi selengkapnya, lihat Mengaktifkan Koneksi Terenkripsi ke Mesin Database (Pengelola Konfigurasi SQL Server).

Konvensi sintaks transact-SQL

Sintaks

  
sp_changesubscription [ @publication = ] 'publication'  
        , [ @article = ] 'article'  
        , [ @subscriber = ] 'subscriber'  
        , [ @destination_db = ] 'destination_db'  
        , [ @property = ] 'property'  
        , [ @value = ] 'value'  
    [ , [ @publisher = ] 'publisher' ]

Argumen

[ @publication = ] 'publication' Adalah nama publikasi yang akan diubah. publikasiadalah sysname, tanpa default

[ @article = ] 'article' Adalah nama artikel yang akan diubah. artikel adalah sysname, tanpa default.

[ @subscriber = ] 'subscriber' Adalah nama Pelanggan. pelanggan adalah sysname, tanpa default.

[ @destination_db = ] 'destination_db' Adalah nama database langganan. destination_db adalah sysname, tanpa default.

[ @property = ] 'property' Adalah properti yang akan diubah untuk langganan yang diberikan. properti adalah nvarchar(30), dan bisa menjadi salah satu nilai dalam tabel.

[ @value = ] 'value'Adalah nilai baru untuk properti yang ditentukan. nilainya adalah nvarchar(4000), dan bisa menjadi salah satu nilai dalam tabel.

Properti	Nilai	Deskripsi
distrib_job_login		Masuk untuk akun Microsoft Windows tempat agen berjalan.
distrib_job_password		Kata sandi untuk akun Windows tempat agen berjalan.
subscriber_catalog		Katalog yang akan digunakan saat membuat koneksi ke penyedia OLE DB. Properti ini hanya berlaku untuk Pelanggan non-Microsoft SQL Server.
subscriber_datasource		Nama sumber data sebagaimana dipahami oleh penyedia OLE DB. Properti ini hanya berlaku untuk Pelanggan non-SQL Server .
subscriber_location		Lokasi database sebagaimana dipahami oleh penyedia OLE DB. Properti ini hanya berlaku untuk Pelanggan non-SQL Server .
subscriber_login		Nama masuk di Pelanggan.
subscriber_password		Kata sandi yang kuat untuk login yang disediakan.
subscriber_security_mode	1	Gunakan Autentikasi Windows saat menyambungkan ke Pelanggan.
	0	Gunakan Autentikasi SQL Server saat menyambungkan ke Pelanggan.
subscriber_provider		Pengidentifikasi terprogram unik (PROGID) tempat penyedia OLE DB untuk sumber data non-SQL Server terdaftar. Properti ini hanya berlaku untuk Pelanggan non-SQL Server .
subscriber_providerstring		string koneksi khusus penyedia OLE DB yang mengidentifikasi sumber data. Properti ini hanya berlaku untuk Pelanggan non-SQL Server .
aliran langganan		Adalah jumlah koneksi yang diizinkan per Agen Distribusi untuk menerapkan batch perubahan secara paralel ke Pelanggan. Rentang nilai dari 1 hingga 64 didukung untuk Penerbit SQL Server. Properti ini harus 0 untuk langganan pelanggan non-SQL Server, Penerbit Oracle, atau peer-to-peer.
subscriber_type	1	Server sumber data ODBC
	3	Penyedia OLE DB
memory_optimized	bit	Menunjukkan bahwa langganan mendukung tabel memori yang dioptimalkan. memory_optimized adalah bit, di mana 1 sama dengan true (langganan mendukung tabel memori yang dioptimalkan).

[ @publisher = ] 'publisher' Menentukan Penerbit non-SQL Server. publisher adalah sysname, dengan default NULL.

Catatan

penerbit tidak boleh ditentukan untuk Penerbit SQL Server.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_changesubscription digunakan dalam rekam jepret dan replikasi transaksional.

sp_changesubscription hanya dapat digunakan untuk memodifikasi properti langganan push atau langganan penarikan yang terlibat dalam antrean memperbarui replikasi transaksional. Untuk mengubah properti semua jenis langganan penarikan lainnya, gunakan sp_change_subscription_properties (Transact-SQL).

Setelah mengubah login atau kata sandi agen, Anda harus menghentikan dan memulai ulang agen sebelum perubahan berlaku.

Izin

Hanya anggota peran server tetap sysadmin atau peran database tetap db_owner yang dapat dijalankan sp_changesubscription.

Lihat Juga

sp_addsubscription (T-SQL)
sp_dropsubscription (T-SQL)

Bagikan melalui