Aracılığıyla paylaş


sp_change_log_shipping_primary_database (Transact-SQL)

Şunlar için geçerlidir: SQL Server

Birincil veritabanı ayarlarını değiştirir.

Transact-SQL söz dizimi kuralları

Sözdizimi

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>;[...]' ]
[ ; ]

Tartışmalar

[ @database = ] 'veritabanı'

Birincil sunucudaki veritabanının adı. @primary_databasesysname'dir ve varsayılan değer yoktur.

[ @backup_directory = ] N'backup_directory'

Birincil sunucudaki yedekleme klasörünün yolu. @backup_directorynvarchar(500)'dir ve varsayılan değer yoktur ve olamaz NULL.

[ @backup_share = ] N'backup_share'

Birincil sunucudaki yedekleme dizininin ağ yolu. @backup_sharenvarchar(500)'dir ve varsayılan değer yoktur ve olamaz NULL.

[ @backup_retention_period = ] 'backup_retention_period'

Günlük yedekleme dosyasını birincil sunucudaki yedekleme dizininde tutma süresi (dakika cinsinden). @backup_retention_period varsayılan olmadan int'tir ve olamaz NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

monitör sunucusuna bağlanmak için kullanılan güvenlik modu.

  • 1 = Windows Kimlik Doğrulaması
  • 0 = SQL Server Kimlik Doğrulaması

@monitor_server_security_modebittir ve varsayılan olarak olarak NULLayarlanır.

[ @monitor_server_login = ] 'monitor_server_login'

İzleyici sunucusuna erişmek için kullanılan hesabın kullanıcı adı.

[ @monitor_server_password = ] 'monitor_server_password'

İzleyici sunucusuna erişmek için kullanılan hesabın parolası.

[ @backup_threshold = ] 'backup_threshold'

bir @threshold_alert hatası oluşmadan önceki son yedeklemeden sonraki dakika cinsinden süre. @backup_threshold , varsayılan değeri 60 dakika olan int'tir.

[ @threshold_alert = ] 'threshold_alert'

Yedekleme eşiği aşıldığında tetiklenecek uyarı. @threshold_alertint ve olamaz NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

@backup_threshold aşıldığında bir uyarının tetiklenip tetiklenmeyeceğini belirtir.

  • 1:Etkin
  • 0:sakat

threshold_alert_enabledbittir ve olamaz NULL.

[ @history_retention_period = ] 'history_retention_period'

Geçmişin tutıldığı dakika cinsinden süre. @history_retention_periodint. Belirtilmezse 14420 değeri kullanılır.

[ @backup_compression = ] backup_compression_option

Günlük gönderim yapılandırmasının yedekleme sıkıştırması kullanıp kullanmadığını belirtir. Bu parametre, SQL Server 2008 (10.0.x) (ve sonraki sürümleri) için Enterprise sürümünde ve Service Pack 1 (ve sonraki sürümler) ile SQL Server 2016'daki (13.x) tüm sürümlerde desteklenir.

  • 0:Sakat. Günlük yedeklemelerini asla sıkıştırma

  • 1:Etkin. Günlük yedeklemelerini her zaman sıkıştır

  • 2 (varsayılan): Yedekleme sıkıştırma varsayılan sunucu yapılandırma seçeneğini kullanın.

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

Geçerlidir: SQL Server 2025 (17.x) ve sonraki sürümler

Uzak bir monitör kullanırken bağlantılı sunucu bağlantısı için anahtar değer çiftleri biçiminde ek bağlantı seçeneklerini belirtir. @monitor_connection_optionsnvarchar(4000) ve varsayılan değeridir NULL.

Aşağıdaki tabloda kullanılabilir bağlantı seçenekleri listelenmiştir:

Key Value
Encrypt strict, mandatory, optional, true, , false
TrustServerCertificate true, false, yes, no
ServerCertificate Dosya sistemindeki sunucu sertifikası yolu. Bu, en fazla 260 karakter uzunluğundadır.
HostNameInCertificate Sertifika için ana bilgisayar adı geçersiz kılma. Bu, en fazla 255 karakter uzunluğundadır.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Yok.

Açıklamalar

sp_change_log_shipping_primary_database birincil sunucudaki master veritabanından çalıştırılmalıdır. Bu saklı yordam aşağıdakileri yapar:

  1. Gerekirse kayıttaki log_shipping_primary_database ayarları değiştirir.

  2. Gerekirse, sağlanan bağımsız değişkenleri kullanarak birincil sunucudaki yerel kaydı log_shipping_monitor_primary değiştirir.

  3. İzleyici sunucusu birincil sunucudan farklıysa, gerekirse sağlanan bağımsız değişkenleri kullanarak izleyici sunucusundaki kaydı log_shipping_monitor_primary değiştirir.

İzinler

Bu yordamı yalnızca sysadmin sabit sunucu rolünün üyeleri çalıştırabilir.

Örnekler

Bu örnek, birincil veritabanıyla sp_change_log_shipping_primary_databaseilişkili ayarları güncelleştirmek için uygulamasının kullanımını AdventureWorks2025 gösterir.

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;