Bagikan melalui


sp_change_log_shipping_secondary_primary (T-SQL)

Berlaku untuk:SQL Server

Mengubah pengaturan database sekunder.

Konvensi sintaks transact-SQL

Sintaks

sp_change_log_shipping_secondary_primary
    [ @primary_server = ] 'primary_server' ,
    [ @primary_database = ] 'primary_database' ,
    [ , [ @backup_source_directory = ] N'backup_source_directory' ]
    [ , [ @backup_destination_directory = ] N'backup_destination_directory' ]
    [ , [ @file_retention_period = ] file_retention_period ]
    [ , [ @monitor_server_security_mode = ] monitor_server_security_mode ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumen

[ @primary_server = ] 'primary_server'

Nama instans utama Mesin Database SQL Server dalam konfigurasi pengiriman log. @primary_server adalah sysname dan tidak boleh NULL.

[ @primary_database = ] 'primary_database'

Nama database di server utama. @primary_database adalah sysname, tanpa default.

[ @backup_source_directory = ] N'backup_source_directory'

Direktori tempat file cadangan log transaksi dari server utama disimpan. @backup_source_directory adalah nvarchar(500) dan tidak boleh NULL.

[ @backup_destination_directory = ] N'backup_destination_directory'

Direktori pada server sekunder tempat file cadangan disalin. @backup_destination_directory adalah nvarchar(500) dan tidak boleh NULL.

[ @file_retention_period = ] 'file_retention_period'

Lamanya waktu dalam menit di mana file cadangan dipertahankan. @file_retention_period int, dengan default NULL. Nilai 14420 digunakan jika tidak ada yang ditentukan.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

Mode keamanan yang digunakan untuk menyambungkan ke server monitor.

  • 1: Autentikasi Windows;
  • 0: Autentikasi SQL Server.

@monitor_server_security_mode adalah bit dan default ke NULL.

[ @monitor_server_login = ] 'monitor_server_login'

Nama pengguna akun yang digunakan untuk mengakses server monitor.

[ @monitor_server_password = ] 'monitor_server_password'

Kata sandi akun yang digunakan untuk mengakses server monitor.

[ @monitor_connection_options = ] '<key_value_pairs>; [...]'

Berlaku untuk: SQL Server 2025 (17.x) dan versi yang lebih baru

Menentukan lebih banyak opsi konektivitas untuk koneksi server tertaut saat menggunakan monitor jarak jauh, dalam bentuk pasangan nilai kunci. @monitor_connection_options adalah nvarchar(4000) dan memiliki default .NULL

Tabel berikut ini mencantumkan opsi konektivitas yang tersedia:

Key Nilai
Encrypt strict, mandatoryoptional, true,false
TrustServerCertificate true,false,yes,no
ServerCertificate Jalur pada sistem file ke sertifikat server. Ini memiliki panjang maksimum 260 karakter.
HostNameInCertificate Penggantian nama host untuk sertifikat. Ini memiliki panjang maksimum 255 karakter.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

sp_change_log_shipping_secondary_primary harus dijalankan dari master database di server sekunder. Prosedur tersimpan ini melakukan tindakan berikut:

  1. Mengubah pengaturan seperlunya log_shipping_secondary .

  2. Jika server monitor berbeda dari server sekunder, ubah rekaman monitor di log_shipping_monitor_secondary server monitor menggunakan argumen yang disediakan, jika perlu.

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan prosedur ini.