Bagikan melalui

sp_change_log_shipping_primary_database (T-SQL)

Berlaku untuk:SQL Server

Mengubah pengaturan database utama.

Konvensi sintaks transact-SQL

Sintaks

sp_change_log_shipping_primary_database
    [ @database = ] 'database'
    [ , [ @backup_directory = ] N'backup_directory' ]
    [ , [ @backup_share = ] N'backup_share' ]
    [ , [ @backup_retention_period = ] 'backup_retention_period' ]
    [ , [ @monitor_server_security_mode = ] 'monitor_server_security_mode' ]
    [ , [ @monitor_server_login = ] 'monitor_server_login' ]
    [ , [ @monitor_server_password = ] 'monitor_server_password' ]
    [ , [ @backup_threshold = ] 'backup_threshold' ]
    [ , [ @threshold_alert = ] 'threshold_alert' ]
    [ , [ @threshold_alert_enabled = ] 'threshold_alert_enabled' ]
    [ , [ @history_retention_period = ] 'history_retention_period' ]
    [ , [ @backup_compression = ] backup_compression_option ]
    [ , [ @monitor_connection_options = ] '<key_value_pairs>;[...]' ]
[ ; ]

Argumen

[ @database = ] 'basis data'

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

[ @backup_directory = ] N'backup_directory'

Jalur ke folder cadangan di server utama. @backup_directory adalah nvarchar(500), tanpa default, dan tidak boleh NULL.

[ @backup_share = ] N'backup_share'

Jalur jaringan ke direktori cadangan di server utama. @backup_share adalah nvarchar(500), tanpa default, dan tidak boleh NULL.

[ @backup_retention_period = ] 'backup_retention_period'

Lamanya waktu, dalam menit, untuk menyimpan file cadangan log di direktori cadangan di server utama. @backup_retention_period int, tanpa default, dan tidak boleh NULL.

[ @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.

[ @backup_threshold = ] 'backup_threshold'

Lamanya waktu, dalam menit, setelah pencadangan terakhir sebelum kesalahan @threshold_alert dimunculkan. @backup_threshold int, dengan default 60 menit.

[ @threshold_alert = ] 'threshold_alert'

Pemberitahuan yang akan dinaikkan ketika ambang cadangan terlampaui. @threshold_alert int dan tidak boleh NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Menentukan apakah pemberitahuan dinaikkan saat @backup_threshold terlampaui.

  • 1:Diaktifkan
  • 0:cacat

threshold_alert_enabled adalah bit dan tidak bisa NULL.

[ @history_retention_period = ] 'history_retention_period'

Lamanya waktu dalam menit di mana riwayat dipertahankan. @history_retention_period int. Nilai 14420 digunakan jika tidak ada yang ditentukan.

[ @backup_compression = ] backup_compression_option

Menentukan apakah konfigurasi pengiriman log menggunakan kompresi cadangan. Parameter ini didukung dalam edisi Enterprise untuk SQL Server 2008 (10.0.x) (dan versi yang lebih baru), dan semua edisi di SQL Server 2016 (13.x) dengan Paket Layanan 1 (dan versi yang lebih baru).

  • 0:Cacat. Jangan pernah memadatkan cadangan log

  • 1:Diaktifkan. Selalu kompres cadangan log

  • 2 (default): Gunakan opsi konfigurasi server default kompresi cadangan .

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

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

Menentukan opsi konektivitas tambahan 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 Value
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_primary_database harus dijalankan dari master database di server utama. Prosedur tersimpan ini melakukan hal berikut:

  1. Mengubah pengaturan dalam log_shipping_primary_database rekaman, jika perlu.

  2. Mengubah rekaman lokal di log_shipping_monitor_primary server utama menggunakan argumen yang disediakan, jika perlu.

  3. Jika server monitor berbeda dari server utama, ubah rekaman di log_shipping_monitor_primary server monitor menggunakan argumen yang disediakan, jika perlu.

Izin

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

Contoh

Contoh ini mengilustrasikan penggunaan sp_change_log_shipping_primary_database untuk memperbarui pengaturan yang terkait dengan database AdventureWorks2025utama .

EXECUTE master.dbo.sp_change_log_shipping_primary_database
    @database = N'AdventureWorks',
    @backup_directory = N'c:\LogShipping',
    @backup_share = N'\\tribeca\LogShipping',
    @backup_retention_period = 1440,
    @backup_threshold = 60,
    @threshold_alert = 0,
    @threshold_alert_enabled = 1,
    @history_retention_period = 1440,
    @monitor_server_security_mode = 1,
    @backup_compression = 1;

Konten terkait

  • Last updated on