Udostępnij za pomocą

sp_change_log_shipping_primary_database (Transact-SQL)

Dotyczy:SQL Server

Zmienia ustawienia podstawowej bazy danych.

Transact-SQL konwencje składni

Składnia

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

Argumenty (w programowaniu)

[ @database = ] 'baza danych'

Nazwa bazy danych na serwerze podstawowym. @primary_database jest nazwą systemu bez wartości domyślnej.

[ @backup_directory = ] N'backup_directory'

Ścieżka do folderu kopii zapasowej na serwerze podstawowym. @backup_directory to nvarchar(500), bez wartości domyślnej i nie może być NULL.

[ @backup_share = ] N'backup_share'

Ścieżka sieciowa do katalogu kopii zapasowej na serwerze podstawowym. @backup_share to nvarchar(500), bez wartości domyślnej i nie może być NULL.

[ @backup_retention_period = ] 'backup_retention_period'

Czas przechowywania pliku kopii zapasowej dziennika w katalogu kopii zapasowej na serwerze podstawowym w minutach. @backup_retention_period jest int, bez wartości domyślnej i nie może być NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

Tryb zabezpieczeń używany do nawiązywania połączenia z serwerem monitora.

  • 1 = Uwierzytelnianie systemu Windows
  • 0 = Uwierzytelnianie programu SQL Server

@monitor_server_security_mode jest bitem i wartością domyślną .NULL

[ @monitor_server_login = ] 'monitor_server_login'

Nazwa użytkownika konta używanego do uzyskiwania dostępu do serwera monitora.

[ @monitor_server_password = ] 'monitor_server_password'

Hasło konta używanego do uzyskiwania dostępu do serwera monitora.

[ @backup_threshold = ] 'backup_threshold'

Czas (w minutach) po utworzeniu ostatniej kopii zapasowej przed wyświetleniem błędu @threshold_alert . @backup_threshold jest int, z wartością domyślną 60 minut.

[ @threshold_alert = ] 'threshold_alert'

Alert, który ma zostać zgłoszony po przekroczeniu progu kopii zapasowej. @threshold_alert jest int i nie może być NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Określa, czy alert jest zgłaszany po przekroczeniu @backup_threshold .

  • 1:Włączone
  • 0:niepełnosprawny

threshold_alert_enabled jest bit i nie może być NULL.

[ @history_retention_period = ] 'history_retention_period'

Czas przechowywania historii w minutach. @history_retention_period jest int. Wartość 14420 jest używana, jeśli nie określono żadnej.

[ @backup_compression = ] backup_compression_option

Określa, czy konfiguracja wysyłania dziennika używa kompresji kopii zapasowej. Ten parametr jest obsługiwany w wersji Enterprise dla programu SQL Server 2008 (10.0.x) (i nowszych wersji) oraz we wszystkich wersjach programu SQL Server 2016 (13.x) z dodatkiem Service Pack 1 (i nowszymi wersjami).

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

Dotyczy do: SQL Server 2025 (17.x) i nowszych wersji

Określa dodatkowe opcje łączności dla połączenia serwera połączonego podczas korzystania z monitora zdalnego w postaci par klucz wartość. @monitor_connection_options to nvarchar(4000) i ma wartość domyślną NULL.

W poniższej tabeli wymieniono dostępne opcje łączności:

Key Value
Encrypt strict, , mandatory, optional, , truefalse
TrustServerCertificate true, , false, , yesno
ServerCertificate Ścieżka w systemie plików do certyfikatu serwera. Ma maksymalną długość 260 znaków.
HostNameInCertificate Zastąpić nazwę hosta dla certyfikatu. Ma maksymalną długość 255 znaków.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Zestaw wyników

Żaden.

Uwagi

sp_change_log_shipping_primary_database należy uruchomić z master bazy danych na serwerze podstawowym. Ta procedura składowana wykonuje następujące czynności:

  1. W razie potrzeby zmienia ustawienia w rekordzie log_shipping_primary_database .

  2. W razie potrzeby zmienia rekord log_shipping_monitor_primary lokalny na serwerze podstawowym przy użyciu podanych argumentów.

  3. Jeśli serwer monitora różni się od serwera podstawowego, w razie potrzeby zmienia rekord log_shipping_monitor_primary na serwerze monitora przy użyciu podanych argumentów.

Uprawnienia

Tę procedurę mogą uruchamiać tylko członkowie stałej roli serwera sysadmin .

Przykłady

W tym przykładzie pokazano użycie polecenia w celu zaktualizowania ustawień skojarzonych sp_change_log_shipping_primary_database z podstawową bazą danych AdventureWorks2025.

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;

Treści powiązane

  • Last updated on