sp_changedistributor_property (T-SQL)

Berlaku untuk: SQL ServerAzure SQL Managed Instance

Mengubah properti Distributor. Prosedur tersimpan ini dijalankan di Distributor pada database apa pun. Untuk Distributor jarak jauh, prosedur tersimpan ini perlu dijalankan pada semua server Publisher yang tersambung ke Distributor jarak jauh.

Jika database distribusi atau Penerbit berada dalam grup ketersediaan, prosedur tersimpan perlu dijalankan pada semua simpul Distributor dan Penerbit, terlepas dari peran mereka saat ini dalam grup ketersediaan.

Konvensi sintaks transact-SQL

Sintaks

sp_changedistributor_property
    [ [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

Argumen

[ @property = ] N'property'

Properti untuk Distributor tertentu. @property adalah sysname, dan bisa menjadi salah satu nilai berikut:

Nama properti Nilai yang dapat diterima Deskripsi
heartbeat_interval Nilai int apa pun (dalam menit) Jumlah menit maksimum yang dapat dijalankan agen tanpa mencatat pesan kemajuan. @heartbeat_interval int, dengan default 10 menit.
encrypt_distributor_connection mandatory, optionalstrict, true, false, yes, no Menentukan jenis enkripsi antara Distributor dan komponen replikasi lainnya.

Berlaku untuk: SQL Server 2025 (17.x) dan versi yang lebih baru.
trust_distributor_certificate yes, no Menentukan apakah akan mempercayai sertifikat yang digunakan oleh Distributor untuk koneksi terenkripsi. Defaultnya adalah no.

Berlaku untuk: SQL Server 2025 (17.x) dan versi yang lebih baru.
host_name_in_distributor_certificate String apa pun Menentukan nama host yang diharapkan dalam sertifikat Distributor.

Berlaku untuk: SQL Server 2025 (17.x) dan versi yang lebih baru.
NULL (standar) Semua nilai @property yang tersedia dicetak.

Nota

Default aman berkaitan dengan penyedia OLEDB 19 yang mendasar, yang meningkatkan keamanan. Opsi untuk mengambil alih default kurang aman daripada mengonfigurasi instans Anda untuk menggunakan sertifikat tepercaya. Setelah mengambil alih default, Anda memiliki opsi untuk mengonfigurasi SQL Server untuk menggunakan sertifikat, lalu menggunakan prosedur sp_changedistributor_property disimpan untuk mengatur trust_distributor_certificate=no properti kembali ke default aman.

[ @value = ] N'value'

Nilai untuk properti Distributor yang diberikan. @value adalah nvarchar(255), dengan default NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_changedistributor_property digunakan dalam semua jenis replikasi.

Contoh


-- Change the heartbeat interval at the Distributor to 5 minutes. 
USE master 
exec sp_changedistributor_property 
    @property = N'heartbeat_interval', 
    @value = 5;
GO

Mengonfigurasi distributor untuk mempercayai sertifikat yang ditandatangani sendiri

Untuk mengambil alih default aman penyedia OLEDB 19 dan mengatur trust_distributor_certificate=yes agar distributor mempercayai sertifikat yang ditandatangani sendiri, gunakan contoh berikut:

EXECUTE sp_changedistributor_property
    @property = N'trust_distributor_certificate',
    @value = N'yes';

Nota

Default aman berkaitan dengan penyedia OLEDB 19 yang mendasar, yang meningkatkan keamanan. Opsi untuk mengambil alih default kurang aman daripada mengonfigurasi instans Anda untuk menggunakan sertifikat tepercaya. Setelah mengambil alih default, Anda memiliki opsi untuk mengonfigurasi SQL Server untuk menggunakan sertifikat, lalu menggunakan prosedur sp_changedistributor_property disimpan untuk mengatur trust_distributor_certificate=no properti kembali ke default aman.

Untuk informasi selengkapnya, tinjau perubahan terobosan distributor jarak jauh di SQL Server 2025.

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_changedistributor_property.

Konten terkait

  • Last updated on