Sdílet prostřednictvím

sp_change_log_shipping_primary_database (Transact-SQL)

platí pro:SQL Server

Změní nastavení primární databáze.

Transact-SQL konvence syntaxe

Syntaxe

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

[ @database = ] 'databáze'

Název databáze na primárním serveru. @primary_database je sysname bez výchozího nastavení.

[ @backup_directory = ] N'backup_directory'

Cesta k záložní složce na primárním serveru. @backup_directory je nvarchar(500), bez výchozího nastavení a nemůže být NULL.

[ @backup_share = ] N'backup_share'

Síťová cesta k záložnímu adresáři na primárním serveru. @backup_share je nvarchar(500), bez výchozího nastavení a nemůže být NULL.

[ @backup_retention_period = ] 'backup_retention_period'

Doba uchovávání záložního souboru protokolu v adresáři zálohování na primárním serveru v minutách. @backup_retention_period je int, bez výchozího nastavení a nemůže být NULL.

[ @monitor_server_security_mode = ] 'monitor_server_security_mode'

Režim zabezpečení používaný pro připojení k serveru monitorování.

  • 1 = Ověřování systému Windows
  • 0 = Ověřování SQL Serveru

@monitor_server_security_mode je bit a výchozí hodnota NULLje .

[ @monitor_server_login = ] 'monitor_server_login'

Uživatelské jméno účtu použitého pro přístup k serveru monitorování.

[ @monitor_server_password = ] 'monitor_server_password'

Heslo účtu použitého pro přístup k serveru monitorování.

[ @backup_threshold = ] 'backup_threshold'

Doba v minutách po posledním zálohování před vyvoláním @threshold_alert chyby. @backup_threshold je int, výchozí hodnota je 60 minut.

[ @threshold_alert = ] 'threshold_alert'

Upozornění, které má být vyvolána při překročení prahové hodnoty zálohování. @threshold_alert je int a nemůže být NULL.

[ @threshold_alert_enabled = ] 'threshold_alert_enabled'

Určuje, jestli je při překročení @backup_threshold vyvolána výstraha.

  • 1:zpřístupněný
  • 0:invalidní

threshold_alert_enabled je bit a nemůže být NULL.

[ @history_retention_period = ] 'history_retention_period'

Doba v minutách, ve které se historie uchovává. @history_retention_period je int. Pokud není zadána žádná hodnota 14420, použije se hodnota 14420.

[ @backup_compression = ] backup_compression_option

Určuje, jestli konfigurace přesouvání protokolů používá kompresi zálohování. Tento parametr je podporován v edici Enterprise pro SQL Server 2008 (10.0.x) (a novější verze) a všechny edice na SQL Serveru 2016 (13.x) s aktualizací Service Pack 1 (a novější verze).

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

Platí na: SQL Server 2025 (17.x) a novější verze

Určuje další možnosti připojení pro připojení k propojenému serveru při použití vzdáleného monitoru ve formě párů klíč-hodnota. @monitor_connection_options je nvarchar(4000) a má výchozí hodnotu NULL.

V následující tabulce jsou uvedené dostupné možnosti připojení:

Key Value
Encrypt strict, mandatory, optional, , truefalse
TrustServerCertificate true, false, , yesno
ServerCertificate Cesta v systému souborů k certifikátu serveru. Má maximální délku 260 znaků.
HostNameInCertificate Přepsání názvu hostitele pro certifikát Má maximální délku 255 znaků.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Poznámky

sp_change_log_shipping_primary_database musí být spuštěna master z databáze na primárním serveru. Tato uložená procedura provede následující akce:

  1. V případě potřeby změní nastavení záznamu log_shipping_primary_database .

  2. V případě potřeby změní místní záznam log_shipping_monitor_primary na primárním serveru pomocí zadaných argumentů.

  3. Pokud se server monitorování liší od primárního serveru, v případě potřeby změní záznam log_shipping_monitor_primary na serveru monitorování pomocí zadaných argumentů.

Povolení

Tento postup můžou spustit pouze členové pevné role serveru sysadmin .

Příklady

Tento příklad ukazuje použití sp_change_log_shipping_primary_database k aktualizaci nastavení přidružených k primární databázi 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;

Související obsah

  • Last updated on